API Reference
SupportStatusSign UpLogin
  1. LOGS API
  2. Access

Access KPIs

get
https://api.tatum.io/v4/logs/access/kpis

Returns aggregate KPI metrics for access logs in the requested time range —
the same window, source and filters /access/chart uses for the same
request, so the cards and the bars agree. Accepts every filter[...] field
/access/events does except event_id, plus search.

Latency is p50/p90/p95 from a t-digest. Deltas compare against the
preceding window of equal length. Sparklines share one grid of at most 30
points whose step is a whole multiple of the chart's bucket. When a raw read
trips its bound the response is capped: true: total_requests and every
other measure are null.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params

Relative look-back window. Ignored when from/to are supplied.

date-time

Inclusive window start, ISO-8601. Use together with to for an explicit
range instead of time_range.

date-time

Exclusive window end, ISO-8601. Defaults to now when only from is given.

Free-text substring match against the request URI. Matched with
lower(uri) LIKE '%needle%', so separators (/, -, _, ., :) are
fine. Control bytes are rejected; min 3 chars, max 128.

On an aggregate endpoint a search is answered from the raw table, whose
read is bounded: past ACCESS_RAW_ROW_CAP rows scanned the response is
capped: true. The floor is not cosmetic: access_logs_v1 has no index on
uri, so a 1–2 char needle scans the owner's slice for a match that would
hit nearly every row.

filter[status_code][in]
array of int32s

Include rows where status_code (HTTP response status code) is one of the given values. Repeat the parameter to pass multiple values.

filter[status_code][in]
filter[status_code][nin]
array of int32s

Exclude rows where status_code (HTTP response status code) is none of the given values. Repeat the parameter to pass multiple values.

filter[status_code][nin]
filter[status_code][between]
array of int32s
length between 2 and 2

Include rows where status_code (HTTP response status code) falls within an inclusive numeric range (SQL BETWEEN lo AND hi). Pass the parameter exactly twice: first the lower bound, then the upper bound.

filter[status_code][between]
filter[network][in]
array of strings

Include rows where network (blockchain network (chain-qualified)) is one of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no network (unattributed traffic).

filter[network][in]
filter[network][nin]
array of strings

Exclude rows where network (blockchain network (chain-qualified)) is none of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no network (unattributed traffic).

filter[network][nin]
filter[chain][in]
array of strings

Include rows where chain (blockchain — the parent of network) is one of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no chain (unattributed traffic).

filter[chain][in]
filter[chain][nin]
array of strings

Exclude rows where chain (blockchain — the parent of network) is none of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no chain (unattributed traffic).

filter[chain][nin]
filter[method][in]
array of strings

Include rows where method (HTTP / RPC method) is one of the given values. Repeat the parameter to pass multiple values.

filter[method][in]
filter[method][nin]
array of strings

Exclude rows where method (HTTP / RPC method) is none of the given values. Repeat the parameter to pass multiple values.

filter[method][nin]
string
length ≤ 128

Include rows where method (HTTP / RPC method) contains this substring (SQL LIKE '%value%').

filter[source][in]
array of strings

Include rows where source (traffic source / attribution channel) is one of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no source (unattributed traffic).

filter[source][in]
filter[source][nin]
array of strings

Exclude rows where source (traffic source / attribution channel) is none of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no source (unattributed traffic).

filter[source][nin]
filter[req_id][in]
array of strings

Include rows where req_id (request id — NOT unique, may match unrelated requests) is one of the given values. Repeat the parameter to pass multiple values.

filter[req_id][in]
Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?