Bot request metrics

Data retention

We store data at the minutely, hourly and daily granularity levels for a duration of 45 days. Note the following maximum data retention limits served by the API response:

24 hours (1 day) of minutely data
45 days of hourly data
45 days of daily data.

We do not report data for time periods that have not yet ended.

Metrics

The following metric sets and metrics are supported:

bot_edge_requests_allowed_count
bot_edge_requests_challenged_count
bot_edge_requests_blocked_count
bot_edge_requests_challenge_token_valid_count

Data model

A time series data item containing bot request metric counts. The `bot` field is present when grouped by bot. The `datacenter` field is present when grouped by data center. This dataset is sparse, meaning only keys with non-zero values are included.

`bot`	string	Bot identifier for which data was recorded. Present only when grouped by bot.
`bot_edge_requests_allowed_count`	integer	Count of edge requests where a bot was detected and the request was allowed by the configured policy.
`bot_edge_requests_blocked_count`	integer	Count of edge requests where a bot was detected and the request was blocked by the configured policy.
`bot_edge_requests_challenge_token_valid_count`	integer	Count of edge requests where a bot was detected and the client making the request has already solved a challenge issued by the configured policy.
`bot_edge_requests_challenged_count`	integer	Count of edge requests where a bot was detected and a client challenge was issued for the request by the configured policy.
`datacenter`	string	Datacenter (POP) for which data was recorded. Present only when grouped by datacenter.
`timestamp`	string	Timestamp for the time series being reported.
`meta`	object	Meta information about the scope of the current response and optional additional information for subsequent requests.