How to query the top URLs impacted by bots with GraphQL API

The botManagerBreakdownMetrics dataset provides access to real-time aggregated data from Azion Bot Manager activity, related to requests classified as bots and bad bots across your applications, as well as the URLs most impacted by bots access. This dataset is part of the Real-Time Metrics GraphQL API and is generated from the requests analyzed and identified as bots and bad bots.

This information can be accessed through the GraphQL API. Additionally, this data is retained and available for up to 60 days.

This guide explains how to query the top 5 URLs impacted by bot activity.

Querying data

To query the top 5 URLs impacted by bot activity, proceed as follows:

1. Access the GraphiQL playground in this link: https://manager.azion.com/metrics/graphql.
   • You must be logged in to your Azion account. Otherwise, you’ll receive an error message.
2. Send a query following this format:

query {
  botManagerBreakdownMetrics (
    filter: {
      tsRange: {
        begin: "2024-10-01T00:00:00"
        end: "2024-10-03T00:00:00"
      }
    }
    aggregate: {
      sum: botRequests
    }
    groupBy: [requestUrl]
    orderBy: [sum_DESC]
    limit: 5
  ) {
    requestUrl
    sum
  }
}

Where:

3. You’ll receive a response similar to this:

{
  "data": {
    "botManagerBreakdownMetrics": [
      {
        "requestUrl": "example-host1.com/api/v1/resource",
        "sum": 333543
      },
      {
        "requestUrl": "example-host2.net/api/v2/data",
        "sum": 107281
      },
      {
        "requestUrl": "example-host3.org/api/v3/info",
        "sum": 103363
      },
      {
        "requestUrl": "example-host4.io/api/v4/details",
        "sum": 89668
      },
      {
        "requestUrl": "example-host5.co/api/v5/summary",
        "sum": 64060
      }
    ]
  }
}

Where: