Skip to content

[Bots] Document BotBase request metrics #32259

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jinhee-c-lee merged 1 commit into from
Jul 23, 2026
+13 −0
Merged

[Bots] Document BotBase request metrics #32259

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions src/content/docs/bots/botbase.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,19 @@ To view BotBase, go to **Security Analytics** > **Bot analysis** > **BotBase**.
- Filter your own traffic to a specific bot to investigate its activity on your zone.
- Copy a bot's detection ID to target it in [Security rules](/security/rules/).

## Requests

The **Requests** column summarizes requests associated with each bot over the previous 24 hours and shows an hourly sparkline.

| Metric | Definition |
| ---------------- | ----------------------------------------------------------------------- |
| **Successful** | Requests with an edge HTTP response status in the `2xx` or `3xx` range. |
| **Unsuccessful** | Requests with any other edge HTTP response status. |

These metrics describe HTTP response outcomes, not the mitigation that a website owner configured for a request. Unsuccessful requests can include errors returned by the origin, such as `404` and `5xx` responses.

To investigate a bot's traffic, select its row to open Security Analytics in a new tab filtered to that bot's detection ID. Expand a request in the request log to review the **Mitigation**, **Edge status code**, and **Origin status code** fields.

## Classification

BotBase classifies each tracked bot by its behavior — what the bot may do on your site. A single bot can have one or more behaviors. To read more, see [Verified bot classifications](/bots/concepts/bot/verified-bots/).
Expand Down
Loading