cf_query_bot_events_grouped
Groups bot management firewall events by dimensions over a time window. Filters automatically apply source='botManagement'.
Instructions
Group bot-management events by dimensions over a time window.
Internally queries `firewallEventsAdaptiveGroups` with the
`source = "botManagement"` filter pre-applied — Cloudflare doesn't
expose a standalone `botManagementEventsAdaptiveGroups` dataset on
standard plans (verified against the live schema). Bot decisions
flow into the firewall-events dataset with that source tag.
Allowed `group_by` dimensions are the firewall set
(`_FIREWALL_GROUP_DIMENSIONS`). For per-request bot SCORE distribution
(`botScore`, `botScoreSrcName`), use `cf_query_http_requests_grouped`
instead — those fields live on the HTTP requests dataset, not the
firewall-events one.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"zone_id": "<zone_id>",
"since": "<since>",
"until": "<until>",
"group_by": "<group_by>"
},
"name": "cf_query_bot_events_grouped"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zone_id | Yes | ||
| since | Yes | ||
| until | Yes | ||
| group_by | Yes | ||
| filters | No | ||
| limit | No | ||
| cursor | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |