--- name: azion-consultar-eventos-de-requisicao-http description: >- Leia os registros de eventos de requisições a um workload no dataset workloadEvents, no Azion Console e com uma consulta GraphQL. --- # Consultar eventos de requisição HTTP Você pode ler o registro de evento de uma única requisição no [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/), no Azion Console ou com uma consulta à API GraphQL dele. Os registros ficam na fonte de dados HTTP Requests, que a API entrega como o dataset `workloadEvents`: um registro por requisição que uma [aplicação](/pt-br/documentacao/plataforma/applications/) ou um [firewall](/pt-br/documentacao/plataforma/firewall/) recebeu. As duas interfaces nomeiam o mesmo valor de maneiras diferentes. Azion Console recebe o nome da variável em minúsculas, com underscores, como em `status='400'`. A API GraphQL recebe o campo em camelCase, como em `statusIn: [400]`. --- ## Pré-requisitos - Uma aplicação ou um firewall que já atende tráfego, para que a fonte de dados HTTP Requests tenha registros para ler. - Um valor que identifique a requisição: um host, um código de status HTTP ou o request id que uma resposta carrega no cabeçalho `x-azion-request-id`. - Acesso ao Azion Console, para o procedimento no Console. Para entrar, consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). - Um personal token, para a consulta GraphQL. Para criar um, consulte [Personal Tokens](/pt-br/documentacao/fundamentos/personal-tokens/). O período que uma consulta pode pedir é limitado por quanto tempo um registro de evento é mantido. Para esse limite e os outros que uma consulta carrega, consulte [Limites](/pt-br/documentacao/plataforma/real-time-events/limites/). --- ## Leia o registro de uma requisição **Console** Uma busca é uma fonte de dados, um período e um filtro sobre eles. Para abrir o registro de uma requisição no Azion Console: 1. **Abra Real-Time Events** Acesse [Azion Console](https://console.azion.com) > **Products menu** > **Observe** > **Real-Time Events**. 2. **Selecione a fonte de dados** Em **Data Sources**, selecione *HTTP Requests*. 3. **Defina o período** Em **Time Filter**, selecione um período que contenha a requisição. O filtro abre em *Last 15 minutes*. 4. **Reduza o resultado** Em **Filter by**, informe uma condição construída com os valores que você tem: ```text host='' AND status='400' ``` 5. **Selecione Refresh** 6. **Abra o registro** Selecione a linha da requisição na tabela de resultados. A visualização **More details** abre, com todas as variáveis que a fonte de dados HTTP Requests guarda para aquela única requisição. **Filter by** lê SQL, e `AND`, `OR` e `NOT` combinam termos. Para a sintaxe completa, consulte [Filtrar eventos](/pt-br/documentacao/guias/plataforma/observabilidade/adicionar-filtros-events/). Para o significado de cada variável desta fonte de dados, consulte [Fontes de dados](/pt-br/documentacao/plataforma/real-time-events/fontes-de-dados/). > **nota** > > Azion Console também oferece uma visualização mais recente de Real-Time Events, em Preview, acessada por **Switch to new view**. As etapas acima seguem a classic view, que é a visualização em que Real-Time Events abre. **API** A API GraphQL serve os mesmos registros em `https://api.azion.com/v4/events/graphql`. Esse endereço também serve o GraphiQL Playground em um navegador: entre no Azion Console em `https://console.azion.com` e depois abra o endpoint. Para enviar a consulta de um terminal, envie-a com um cabeçalho `Authorization: Token [TOKEN VALUE]`, como descreve [Primeiros passos da API GraphQL](/pt-br/documentacao/devtools/graphql/primeiros-passos/). Uma consulta sobre `workloadEvents` carrega as mesmas três escolhas. `tsRange` delimita o período, um argumento de filtro como `requestIdEq` reduz o que é lido dentro dele e o conjunto de seleção nomeia os campos com que a resposta volta. Para retornar o registro de uma requisição, substituindo os timestamps e o request id pelos seus: ```graphql { workloadEvents( limit: 1 filter: { tsRange: { begin: "2026-01-01T11:55:00", end: "2026-01-01T12:05:00" } requestIdEq: "0123456789abcdef0123456789abcdef" } ) { ts requestId host status upstreamStatus } } ``` A consulta retorna uma única linha: ```json { "ts": "2026-01-01T12:00:00Z", "requestId": "0123456789abcdef0123456789abcdef", "host": "", "status": 400, "upstreamStatus": 0 } ``` A linha é o registro de evento daquela requisição. Um `upstreamStatus` `0` significa que a requisição nunca chegou a uma origem. Uma resposta carrega os campos que a consulta selecionou e nenhum outro, portanto ler mais de um registro significa nomear mais campos. Para todos os campos que `workloadEvents` carrega, consulte [Campos da API GraphQL do Real-Time Events](/pt-br/documentacao/devtools/graphql/campos-gql-real-time-events/). --- ## Próximos passos - [Filtrar eventos](/pt-br/documentacao/guias/plataforma/observabilidade/adicionar-filtros-events.md): Toda a sintaxe do Filter by, com uma condição de exemplo por variável. - [Ler um registro de evento](/pt-br/documentacao/guias/plataforma/observabilidade/entender-logs.md): O que significam os valores de um registro aberto, variável por variável. - [Investigar uma requisição com a API GraphQL](/pt-br/documentacao/guias/plataforma/observabilidade/investigar-requisicoes-api-graphql.md): Agrupe os registros por país e host antes de reduzir a um só. - [Fontes de dados](/pt-br/documentacao/plataforma/real-time-events/fontes-de-dados.md): As oito fontes de dados, o dataset por trás de cada uma e as variáveis que ela carrega.