Consulte as URLs mais atingidas por bots com GraphQL

Você lê as URLs que o tráfego de bots mais alcançou no dataset botManagerBreakdownMetrics, no GraphiQL Playground ou a partir de qualquer cliente GraphQL que envie as suas credenciais.

botManagerBreakdownMetrics agrega as requisições que o Bot Manager classificou como bots e como bad bots, agrupadas pelas URLs e pelos endereços IP que esse tráfego alcançou. O dataset é retido por 60 dias, então um intervalo de tempo que começa antes disso não devolve linhas.

O segundo dataset do Bot Manager, botManagerMetrics, carrega as contagens de classificação: a ação, a categoria e o veredito de cada requisição. Ele é retido por 2 anos. Para mais informações, consulte Consulte dados do Bot Manager com GraphQL.

Pré-requisitos

Uma assinatura do Bot Manager na sua conta. O dataset não é recuperável sem uma.
Uma sessão Azion autenticada no navegador em que você abre o Playground. Uma requisição que não carrega sessão devolve uma mensagem de erro.

Consulte as URLs que os bots mais alcançaram

A consulta filtra o dataset por um intervalo de tempo, soma botRequests por URL e devolve as cinco URLs com o maior total. Para rodá-la:

Abra o Playground

Acesse https://api.azion.com/v4/metrics/graphql.

Informe a consulta

Defina begin e end para o período que você quer ler, dentro dos últimos 60 dias:

GraphQL

01query {

02 botManagerBreakdownMetrics (

03 filter: {

04 tsRange: {

05 begin: "2024-10-01T00:00:00"

06 end: "2024-10-03T00:00:00"

07 }

08 }

09 aggregate: {

10 sum: botRequests

11 }

12 groupBy: [requestUrl]

13 orderBy: [sum_DESC]

14 limit: 5

15 ) {

16 requestUrl

17 sum

18 }

19}

Rode a consulta e leia a resposta

A resposta carrega um objeto por URL, com as requisições somadas em sum:

JSON

01{

02 "data": {

03 "botManagerBreakdownMetrics": [

04 {

05 "requestUrl": "example-host1.com/api/v1/resource",

06 "sum": 333543

07 },

08 {

09 "requestUrl": "example-host2.net/api/v2/data",

10 "sum": 107281

11 },

12 {

13 "requestUrl": "example-host3.org/api/v3/info",

14 "sum": 103363

15 },

16 {

17 "requestUrl": "example-host4.io/api/v4/details",

18 "sum": 89668

19 },

20 {

21 "requestUrl": "example-host5.co/api/v5/summary",

22 "sum": 64060

23 }

24 ]

25 }

26}

Você agora tem as URLs que o tráfego de bots mais alcançou no período, ordenadas pelo número de requisições classificadas como bots.

Campos da consulta

Campo	O que carrega
`filter`	Os critérios que estreitam os dados devolvidos
`tsRange`	Um subcampo de `filter`, com um timestamp `begin` e um `end` no formato `YYYY-MM-DDTHH:mm:ss`
`aggregate`	Com `sum: botRequests`, o total de requisições classificadas como bots no intervalo, depois que os filtros se aplicam
`groupBy`	Os campos pelos quais os resultados são agrupados. `[requestUrl]` os agrupa por URL
`orderBy`	A ordem dos resultados. `[sum_DESC]` os devolve em ordem decrescente, `[sum_ASC]` em crescente
`limit`	O número máximo de resultados. Esta consulta devolve `5`; eleve-o para ler mais abaixo no ranking

Campos da resposta

Campo	O que carrega
`requestUrl`	A URL para a qual as requisições foram feitas. Por exemplo: `example-host5.co/api/v5/summary`
`sum`	As requisições classificadas como bots que alcançaram a URL. Por exemplo: `333543`

Mude o agrupamento ou a soma

A consulta acima combina um campo do dataset com uma das somas dele. O dataset carrega quatro campos: host, remoteAddr, requestUrl e ts. Ele carrega três somas: badBotRequests, botRequests e uniqRequestUrl. Duas mudanças cobrem a maior parte das outras leituras do mesmo período:

Defina groupBy como [host] ou como [remoteAddr] para totalizar as requisições por host ou por endereço IP de origem, em vez de por URL.
Defina aggregate como sum: badBotRequests para contar apenas as requisições classificadas como bad bots, que são um subconjunto das requisições que botRequests conta.

Para a descrição de cada campo, consulte botManagerBreakdownMetrics.

Próximos passos

Consulte dados do Bot Manager com GraphQLAs contagens de classificação do segundo dataset, retido por 2 anos.Campos da GraphQL API de Real-Time MetricsCada campo e cada soma deste dataset, com um valor de exemplo para cada um.Monitore e calibre o Bot ManagerComo agir sobre o tráfego que uma consulta como esta revela.Real-Time MetricsOs mesmos dados de breakdown em gráficos, lidos no Azion Console em vez de uma consulta.