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.

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.
Envie uma query seguindo este formato:

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 ”; 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 ”; exemplo: `"2024-10-21T12:00:00"`

Você receberá uma resposta semelhante a esta:

{
  "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`