Versions Compared

Old Version 14

changes.mady.by.user Patrick Téguia

Saved on

compared with

New Version Current

changes.mady.by.user Patrick Téguia

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

POST https://console.baleen.cloud/api/logs/access-logs

...

Param

Required/Optional

Type

Description

start

optional

<long>long

The timestamp (in seconds) to collect data from

end

optional

<long>long

The timestamp (in seconds) to collect data to

size

optional

100integer

The page size of log entries to retrieve. Between 1 and 100.

page

optional

0

The page number of log entries to retrieve

Body Params

Object filters

...

description

This object is an optional array allowing to define the filters to apply on the access logs using the following parameters

Param

Type

Description

field

enum

The field targeted to filter the logs

Has to be one of the following value :

  • “asn”

  • “connection_type”

  • “country”

  • “ip”

  • “isp”

  • “ja3”

  • “request_fate_action”

  • “method”

  • “status_code”

  • “triggered_rule_id”

  • “uri”

  • “user_agent”

operator

enum

The operator used to filter the logs

Has to be one of the following value :

  • “equals” : this option allows to retrieve logs whose the mentioned field is strictly equal to the indicated value.

  • “contains” “not_equals” : this option allows to retrieve logs whose the mentioned field contains is different from the indicated value

value

string

The value considered to filter the logs

...

Field

Required/Optional

Type

Description

timestamp

required

ISO 8601 GMT

ISO 8601 uses the 24-hour clock system

status

required

HTTP status

Hypertext Transfer Protocol (HTTP) response status codes

remoteAddr

optional

IP address

client IP proxy or client IP address

upstream

optional

IP address

Baleen proxy-out IP address

scheme

required

URI Scheme

requestFateAction

optional

Baleen BotDetection Fate Action

Baleen Botdetection action for this request

bodyBytesSent

required

Byte data type

request body size

botCategory

optional

Baleen Bot Category

Bot Category assigned to this request

httpHost

required

URL scheme

Request Host header value

httpUserAgent

optional

String

Request User-Agent header value

remoteUser

optional

IP address

requestTime

optional

Duration (Seconds)

Request processing time

clientIP

required

IP address

Client IP adress

httpXForwardedFor

optional

comma separated IP addresses

identifying the originating IP address of a client connecting to a web server through an HTTP proxy or a load balancer

httpReferrer

optional

URL scheme

Request Referer header value

upstreamResponseTime

optional

Duration (Second)

Origine response time for this request

requestFate

optional

Baleen Bot Detection Action

Baleen action for this request

requestJa3

optional

string

Device TLS fingerprint

sslProtocol

required

string

Client TLS protocol

serverProtocol

required

string

requestURI

required

URI scheme

Request ressource identifier

requestMethod

required

HTTP Request Method

requestArgs

optional

string

Request URI query strings

requestISP

optional

string

Client Internet Service Provider

requestCountry

optional

string

country code ISO3166-1 format

requestConnectionType

optional

string

requestionIsAnonymousProxy

optional

Boolean

Tells if this request was made using an anonymous proxy like à VPN

responseContentType

optional

string

Response Content Type Header

Unsuccessful request

400 Bad request

500 Internal server error

Example

The following example shows a request an API call retrieving logs of requests from France having targeted the path “/” between April 25th 2023 3PM and April 25th 2023 8PM.

...