# Como consultar dados do httpBreakdownMetrics dataset

O conjunto de dados **httpBreakdownMetrics** fornece dados agregados, detalhados e em tempo real sobre eventos de requisições HTTP bloqueadas. Este conjunto de dados é parte da API GraphQL do Real-Time Metrics.

Esses dados são retidos e disponíveis por até *90* dias.

Este guia explicará como consultar dados do httpBreakdownMetrics dataset usando o playground GraphiQL.

---

## Consulte os dados

Este exemplo consulta as 20 principais entradas de `remoteAddress` bloqueadas. Para saber mais sobre os campos disponíveis, consulte a documentação dos [Campos da API GraphQL do Real-Time Metrics](/pt-br/documentacao/devtools/graphql-api/recursos/campos-gql-real-time-metrics/).

1. Acesse o GraphiQL playground nesse link: `https://api.azion.com/v4/metrics/graphql`.
    - Você deve estar logado na sua conta Azion. Caso contrário, você receberá uma mensagem de erro.
2. Envie uma query seguindo este formato:

```graphql
query {
  httpBreakdownMetrics(
    aggregate: { sum: blockedRequests }
    groupBy: [remoteAddress]
    orderBy: [sum_DESC],
    limit: 20,
    filter: { 
      tsGte: "2024-10-21T11:00:00"
      tsLt: "2024-10-21T12:00:00"
    }
  ) {
    remoteAddress
    totalBlocked: sum
  }
}
```

Onde:

| Campo | Descrição |
|----------|----------|
| `sum: blockedRequests` | Retorna o número total de requisições bloqueadas dentro do intervalo de tempo especificado, após aplicar quaisquer filtros |
| `groupBy` | Especifica os campos pelos quais os resultados da consulta devem ser agrupados. Exemplo: `[remoteAddress]` |
| `orderBy` | Especifica a ordem em que os resultados devem ser retornados. Exemplos: `[sum_DESC]`, para ordem decrescente, e `[sum_ASC]`, para ordem crescente |
| `limit` | Especifica o número máximo de resultados a serem retornados. Exemplo: `20` para recuperar os 20 principais. Máximo do sistema: `10.000` |
| `filter` | Define os critérios usados para filtrar os dados retornados pela consulta |
| `tsGte` | Um subcampo de `filter`. Especifica o horário de início (maior ou igual a) para a consulta de dados, garantindo que os resultados incluam registros a partir deste timestamp. Formato: "YYYY-MM-DDTHH:mm:ss"; exemplo: `"2024-10-21T11:00:00"` |
| `tsLt` | Um subcampo de `filter`. Especifica o horário de término (menor que) para a consulta de dados, filtrando quaisquer registros com timestamps iguais ou após este timestamp. Formato: "YYYY-MM-DDTHH:mm:ss"; exemplo: `"2024-10-21T12:00:00"` |

3. Você receberá uma resposta semelhante a esta:

```graphql
{
  "data": {
    "httpBreakdownMetrics": [
      {
        "remoteAddress": "192.168.0.1",
        "totalBlocked": 6732
      },
      {
        "remoteAddress": "10.0.0.2",
        "totalBlocked": 5872
      },
      {
        "remoteAddress": "172.16.0.3",
        "totalBlocked": 3958
      },
      {
        "remoteAddress": "192.168.1.4",
        "totalBlocked": 3952
      },
      {
        "remoteAddress": "10.0.1.5",
        "totalBlocked": 3806
      },
      {
        "remoteAddress": "172.16.1.6",
        "totalBlocked": 3730
      },
      {
        "remoteAddress": "192.168.2.7",
        "totalBlocked": 3378
      },
      {
        "remoteAddress": "10.0.2.8",
        "totalBlocked": 3318
      },
      {
        "remoteAddress": "172.16.2.9",
        "totalBlocked": 3284
      },
      {
        "remoteAddress": "192.168.3.10",
        "totalBlocked": 3282
      },
      {
        "remoteAddress": "10.0.3.11",
        "totalBlocked": 2958
      },
      {
        "remoteAddress": "172.16.3.12",
        "totalBlocked": 2884
      },
      {
        "remoteAddress": "192.168.4.13",
        "totalBlocked": 2530
      },
      {
        "remoteAddress": "10.0.4.14",
        "totalBlocked": 2348
      },
      {
        "remoteAddress": "172.16.4.15",
        "totalBlocked": 2004
      },
      {
        "remoteAddress": "192.168.5.16",
        "totalBlocked": 1902
      },
      {
        "remoteAddress": "10.0.5.17",
        "totalBlocked": 1538
      },
      {
        "remoteAddress": "172.16.5.18",
        "totalBlocked": 1440
      },
      {
        "remoteAddress": "192.168.6.19",
        "totalBlocked": 1390
      },
      {
        "remoteAddress": "10.0.6.20",
        "totalBlocked": 1314
      }
    ]
  }
}
```

Onde: 

| Campo | Descrição |
|----------|----------|
| `remoteAddress` | Especifica o endereço IP da fonte que está fazendo a requisição. Exemplo: `10.0.6.20` |
| `totalBlocked` | Refere-se ao número total de vezes que as requisições deste endereço IP foram bloqueadas. Este campo é o resultado de uma soma. Exemplo: `1314` |