Leia o report log de uma instância

Consulte no dataset functionConsoleEvents, pela API GraphQL, as linhas de report que uma instância do Bot Manager Lite gravou e leia os valores de uma linha.

Última atualização

Ver como Markdown Configurar agente

Você pode ler as linhas de report que uma instância do Bot Manager Lite gravou consultando o dataset functionConsoleEvents pela API GraphQL. Uma requisição pontuada deixa atrás de si uma linha, com a pontuação, as regras que a produziram e o veredito a que a função chegou.

Pré-requisitos

Consulte as linhas de report

O dataset functionConsoleEvents serve essas linhas. Envie a query para https://api.azion.com/v4/events/graphql com um header Authorization: Token [TOKEN VALUE] e um tsRange que cubra a janela que você quer ler:

GraphQL
01{
02 functionConsoleEvents(
03 limit: 200
04 filter: { tsRange: { begin: "2026-01-01T11:30:00", end: "2026-01-01T13:00:00" } }
05 orderBy: [ts_ASC]
06 ) {
07 ts
08 line
09 level
10 lineSource
11 functionId
12 configurationId
13 }
14}

A resposta é 200, com um registro para cada linha que a função gravou. Em um registro do Bot Manager, level lê LOG e lineSource lê CONSOLE. functionId é o id da função instalada, e configurationId é o id do workload em que a requisição chegou, não o id do firewall que executou a instância. O GraphiQL Playground executa a mesma query sem uma requisição sua.

line carrega a linha de report inteira: um prefixo e, em seguida, um objeto JSON.

[Bot-Protection][storefront-bots] Report: {"request_id":"0123456789abcdef0123456789abcdef","remote_addr":"203.0.113.42","fingerprint":"ge20cn020000_000000000000_000000000000_000000000000","host":"<your-workload-domain>","http_user_agent":"","request_uri":"/","geoip_country":"BR","geoip_region":"SP","asn":"64496","score":28,"bot_category":"Bad Bot Signatures, Malicious Intent detected","classified":"legitimate","action":"allow","matched_rules":[1,10,18,19,20]}

Quatro valores respondem o que a instância fez com a requisição. score é o número a que a função chegou, matched_rules guarda as regras que o produziram, action é o que a função aplicou no threshold em vigor e classified é o veredito que ela registrou. Para todos os campos que uma linha carrega, consulte Logs.

nota — O segundo colchete do prefixo carrega o log_tag dos argumentos da instância, não o host. Essa tag é a única forma de distinguir as linhas de uma instância das de outra, porque toda instância da função instalada compartilha o mesmo functionId. Dê a cada instância uma tag própria antes de sair procurando as linhas dela. configurationId é o id do workload, então um filtro montado em torno de um id de firewall não retorna nada, em vez de retornar um erro. classified é relativo ao threshold em vigor, e não uma propriedade da requisição; para saber como o threshold o define, consulte Score de bots.

Próximos passos

Recuse requisições acima do thresholdAumente a ação depois que as linhas mostrarem o que o seu próprio tráfego pontua.LogsTodos os campos que uma linha de report carrega, com o que cada um guarda.