Como consultar as principais URLs impactadas por bots com a GraphQL API
O conjunto de dados botManagerBreakdownMetrics fornece acesso a dados agregados em tempo real da atividade do Azion Bot Manager, relacionado a requisições classificadas como bots e bots maliciosos em suas aplicações, bem como as URLs mais impactadas pelo acesso de bots. Este conjunto de dados faz parte da API GraphQL de Real-Time Metrics e é gerado a partir das requisições analisadas e identificadas como bots e bots maliciosos.
Essas informações podem ser acessadas através da API GraphQL. Além disso, esses dados são retidos e disponíveis por até 60 dias.
Este guia explica como consultar dados do Bot Manager usando o playground GraphiQL.
Consulte os dados
Para consultar as 5 principais URLs impactadas pela atividade de bots, proceda da seguinte forma:
- Acesse o GraphiQL playground nesse link:
https://manager.azion.com/metrics/graphql
.- Você deve estar logado na sua conta Azion. Caso contrário, você receberá uma mensagem de erro.
- Envie uma query seguindo este formato:
Onde:
Campo | Descrição |
---|---|
filter | Define os critérios usados para filtrar os dados retornados pela consulta |
tsRange | Um subcampo de filter . Especifica um intervalo de tempo para filtrar dados. Inclui os campos begin e end para definir os timestamps de início e fim. Formato: "YYYY-MM-DDTHH:mm:ss" ; exemplo: "2024-04-11T00:00:00" |
sum: botRequests | Retorna o número total de requisições classificadas como bots dentro do intervalo de tempo especificado, após a aplicação de quaisquer filtros |
orderBy | Especifica a ordem em que os resultados devem ser retornados. Exemplos: [sum_DESC] , para ordem decrescente, e [sum_ASC] , para ordem crescente |
groupBy | Especifica os campos pelos quais os resultados da consulta devem ser agrupados. Exemplo: [requestUrl] para agrupar por URL |
limit | Especifica o número máximo de resultados a serem retornados. Neste caso, 5 |
- Você receberá uma resposta semelhante a esta:
Onde:
Campo | Descrição |
---|---|
requestUrl | URL impactada pela atividade de bots. Exemplo: example-host5.co/api/v5/summary |
sum | Total de requisições envolvendo atividade de bots recebidas pela URL. Este campo é o resultado de uma soma. Exemplo: 333543 |