--- name: azion-filtre-um-dashboard-de-real-time-metrics description: >- Restrinja cada gráfico de um dashboard de Real-Time Metrics às requisições de que você precisa e aplique os mesmos filtros a uma query GraphQL. --- # Filtre um dashboard de Real-Time Metrics Você pode restringir os gráficos de um dashboard de [Real-Time Metrics](/pt-br/documentacao/plataforma/real-time-metrics/) no Azion Console, ou aplicar os mesmos filtros a uma query com a API GraphQL. Para cada campo, operador e tipo de valor que um filtro aceita, consulte [Filtros e intervalo de tempo](/pt-br/documentacao/plataforma/real-time-metrics/filtros-e-intervalo-de-tempo/#filtros). Sem filtro, um dashboard conta os dados de toda a sua conta. Um filtro mantém apenas os dados cujo campo corresponde a um valor, como o host, o status code, o método da requisição ou o país. Na API GraphQL, esses campos são `host`, `status`, `requestMethod` e `geolocCountryName`. Selecione a sua interface uma vez. Os pré-requisitos e cada tarefa desta página mostram apenas esse caminho. ## Pré-requisitos - Uma [aplicação](/pt-br/documentacao/plataforma/applications/) com requisições no intervalo de tempo que você lê. - Um host ao qual o seu [workload](/pt-br/documentacao/plataforma/workloads/) responde, como `www.example.com`, para combinar filtros. **Console** - Acesso ao Azion Console. Para fazer login, consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). **API** - Um personal token. Para criar um, consulte [Como criar um personal token](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/). - `curl`. --- ## Adicione um filtro Esta tarefa mantém as requisições que retornaram um erro, com status code 400 ou maior. Cada gráfico do dashboard passa a contar apenas essas requisições. **Console** Para filtrar o dashboard por status code no Azion Console: 1. **Abra Real-Time Metrics** Acesse [Azion Console](https://console.azion.com/) > **Real-Time Metrics**. A página abre em **Build** › **Applications** › **Data Transferred**. 2. **Abra o popover Filter** Na linha de filtros, selecione o ícone de filtro, cuja tooltip exibe **Add filter**. 3. **Selecione o campo Status** Em **Filter**, selecione **Status**. 4. **Selecione o operador** Em **Operator**, selecione **Greater Than or Equal**. 5. **Insira o valor** Insira `400` como valor. 6. **Selecione Apply** Um chip abaixo da linha de filtros exibe `Status greater than or equal: 400`. Cada gráfico do dashboard passa a contar apenas as requisições com status code 400 ou maior. **API** Para aplicar o mesmo filtro com a API GraphQL, envie uma requisição `POST` para `https://api.azion.com/v4/metrics/graphql`. Em `filter`, a chave `statusGte` mantém os status codes 400 ou maiores, ao lado do `tsRange` que toda query exige. A query soma `requests` para cada status code. Substitua `[TOKEN VALUE]` pelo seu personal token e os valores de `begin` e `end` pelo período que você quer ler: ```bash curl -X POST 'https://api.azion.com/v4/metrics/graphql' \ -H 'Content-Type: application/json' \ -H 'Authorization: Token [TOKEN VALUE]' \ -d '{"query":"query ErrorRequestsByStatus($begin: DateTime!, $end: DateTime!) { httpMetrics(limit: 100, filter: { tsRange: { begin: $begin, end: $end }, statusGte: 400 }, aggregate: { sum: requests }, groupBy: [status], orderBy: [sum_DESC]) { status sum } }","variables":{"begin":"2026-01-01T12:00:00","end":"2026-01-02T12:00:00"}}' ``` A API responde `200` com uma linha para cada status code 400 ou maior: ```json { "data": { "httpMetrics": [ { "status": 496, "sum": 210 }, { "status": 501, "sum": 198 }, { "status": 495, "sum": 73 }, { "status": 404, "sum": 55 }, { "status": 502, "sum": 31 }, { "status": 401, "sum": 12 }, { "status": 400, "sum": 1 }, { "status": 499, "sum": 1 }, { "status": 504, "sum": 1 } ] } } ``` Cada linha traz um status code e a contagem de requisições dele no intervalo. Uma chave de filtro é um nome de campo seguido do operador, como `statusGte` ou `hostEq`. Para cada operador, consulte [Queries API GraphQL](/pt-br/documentacao/devtools/graphql/recursos/#operadores). --- ## Combine filtros Cada filtro que você adiciona restringe os dados de novo, então os gráficos mantêm apenas os dados que correspondem a todos os filtros. Esta tarefa adiciona um host ao filtro de status de Adicione um filtro, para ler os erros de um host. Substitua `www.example.com` por um host ao qual o seu workload responde. **Console** Para adicionar um segundo filtro no Azion Console: 1. **Abra o popover Filter** Na linha de filtros, selecione o ícone de filtro, cuja tooltip exibe **Add filter**. 2. **Selecione o campo Host** Em **Filter**, selecione **Host**. 3. **Selecione o operador Equals** Em **Operator**, selecione **Equals**. 4. **Insira o host** Insira `www.example.com` como valor. 5. **Selecione Apply** Um segundo chip exibe `Host equals: www.example.com`, ao lado do chip de status. Cada gráfico passa a contar apenas as requisições para esse host com status code 400 ou maior. O popover **Filter** informa `Each combination of operator can only be used once.` Para manter qualquer um de vários valores de um campo, use a forma `in` do campo de query, descrita em Filtre com o campo de query. **API** Para combinar filtros com a API, adicione cada um como uma chave de `filter`. Esta query adiciona `hostEq` ao filtro `statusGte`: ```bash curl -X POST 'https://api.azion.com/v4/metrics/graphql' \ -H 'Content-Type: application/json' \ -H 'Authorization: Token [TOKEN VALUE]' \ -d '{"query":"query ErrorRequestsForHost($begin: DateTime!, $end: DateTime!) { httpMetrics(limit: 100, filter: { tsRange: { begin: $begin, end: $end }, statusGte: 400, hostEq: \"www.example.com\" }, aggregate: { sum: requests }, groupBy: [status], orderBy: [sum_DESC]) { status sum } }","variables":{"begin":"2026-01-01T12:00:00","end":"2026-01-02T12:00:00"}}' ``` A API responde `200` apenas com as respostas de erro desse host: ```json { "data": { "httpMetrics": [ { "status": 501, "sum": 198 }, { "status": 404, "sum": 29 }, { "status": 504, "sum": 1 } ] } } ``` Cada linha conta apenas as requisições que atendem aos dois filtros. Para manter qualquer um de vários valores de um campo, use o operador `In` com uma lista. Por exemplo, `statusIn: [404, 502]` no lugar de `statusGte: 400` retorna apenas as linhas de `404` e `502` no mesmo intervalo, com as mesmas contagens da resposta de Adicione um filtro. --- ## Filtre com o campo de query O campo de query na linha de filtros recebe os filtros como uma única expressão digitada em Azion Query Language. Ele também mantém vários valores de um campo ao mesmo tempo, o que um único filtro **Equals** não faz. Esta tarefa mantém as requisições que retornaram `404` ou `502`. Para filtrar com o campo de query no Azion Console: 1. **Abra Real-Time Metrics** Acesse [Azion Console](https://console.azion.com/) > **Real-Time Metrics**. 2. **Selecione o campo de query** Na linha de filtros, selecione o campo de query, cujo placeholder exibe `Filter using Azion Query Language syntax...`. 3. **Insira a expressão** Insira `status in (404, 502)`. Enquanto você digita, o campo de query sugere nomes de campo, depois operadores, depois valores. `Ctrl` + `Space`, ou `Cmd` + `Space`, abre as sugestões. 4. **Aplique a expressão** Pressione `Enter`. Cada gráfico do dashboard passa a contar apenas as requisições que retornaram `404` ou `502`. Para manter um intervalo de valores, use `between` com exatamente dois valores: `status between (400, 499)` mantém os status codes de 400 a 499. Para a sintaxe de cada operador no campo de query, consulte [Filtros e intervalo de tempo](/pt-br/documentacao/plataforma/real-time-metrics/filtros-e-intervalo-de-tempo/#campo-de-query). Quando o campo de query exibe uma mensagem de validação e **Refresh** continua desativado, consulte [Solucionar problemas de Real-Time Metrics](/pt-br/documentacao/plataforma/real-time-metrics/solucao-de-problemas/). --- ## Edite ou remova um filtro Cada filtro aplicado aparece como um chip abaixo da linha de filtros. Selecionar um chip reabre esse filtro, e o ícone de remoção do chip exclui o filtro. Para editar um filtro no Azion Console: 1. **Abra o filtro** Abaixo da linha de filtros, selecione o chip do filtro. O popover **Filter** abre com os valores desse filtro. Um ícone de cadeado substitui a seta do campo, porque o campo não pode mudar. 2. **Altere o operador ou o valor** 3. **Selecione Apply** O chip mostra o novo operador ou valor, e cada gráfico do dashboard segue o filtro alterado. Para remover um filtro, selecione o ícone de remoção no chip dele e repita para cada filtro que você quer remover. O chip desaparece, e os gráficos deixam de aplicar esse filtro. Trocar para um dashboard que lê outro dataset limpa todos os filtros e mantém o intervalo de tempo. --- ## Próximos passos - [Filtros e intervalo de tempo](/pt-br/documentacao/plataforma/real-time-metrics/filtros-e-intervalo-de-tempo.md): Cada campo, operador e tipo de valor que um filtro aceita, e a sintaxe do campo de query. - [Exporte os dados e a query de um gráfico](/pt-br/documentacao/guias/plataforma/observabilidade/analisar-metricas.md): Baixe um gráfico filtrado como CSV ou copie a query GraphQL dele com os valores do filtro. - [Dashboards de Build](/pt-br/documentacao/plataforma/real-time-metrics/dashboards-build.md): Cada dashboard de Build, o dataset que ele lê e o que cada gráfico plota. - [Solucionar problemas de Real-Time Metrics](/pt-br/documentacao/plataforma/real-time-metrics/solucao-de-problemas.md): O que cada mensagem de validação do campo de query significa e como corrigir a expressão.