Como selecionar Top X queries com a GraphQL API

As queries Top X costumam ser usadas para realizar consultas e análises sobre dados. Elas têm a finalidade de visualizar o uso de recursos e ferramentas e ter uma visão detalhada sobre determinadas condições que são mais ou menos usadas.

Para selecionar Top X queries através da GraphQL API, siga os passos descritos no guia Como rodar requisições da GraphQL no Postman utilizando a URL https://api.azionapi.net/events/graphql.

Depois, na caixa de código do Postman da requisição de GraphQL, adicione a seguinte Top X Query, modificando o tsRange de acordo com o intervalo de tempo que você quer utilizar:

query EventsTopUri {
httpEvents(
limit: 5,
filter: {
tsRange: {begin:"2022-11-20T10:10:10", end:"2022-11-27T10:10:10"}
},
aggregate: {count: requestUri}
groupBy: [requestUri]
orderBy: [count_DESC]
)
{
requestUri
count
}
}

O exemplo acima consulta o app Events de dados brutos com o dataset de HTTP. Além disso, o operador count solicita a agregação dos dados com as informações do campo requestUri em um determinado período de tempo, informado através do campo tsRange. O retorno da API também foi limitado a 5 registros através do campo limit.

Por fim, os dados foram agrupados (groupBy) pelo campo requestUri e ordenados (orderBy) pelo retorno do operador count, de forma decrescente (DESC), para que os maiores retornos da agregação sejam exibidos primeiro.

Para consultas com dados agregados, é obrigatório informar:

  • Um intervalo de tempo para consulta, usando tsRange ou tsGt + tsLt.
  • Os campos em que deseja agrupar as informações, usando groupBy.
  • Quais dos dados obtidos na consulta devem ser exibidos. No caso do exemplo apresentado, foram usados requestUri e count, onde count é o retorno da agregação de requestUri.

Envie sua requisição. Você receberá uma resposta semelhante a:

{
"data": {
"httpEvents": [
{
"requestUri": "/requests/images",
"count": 610081
},
{
"requestUri": "/path/to/file/document",
"count": 6270
},
{
"requestUri": "/send/stock",
"count": 3568
}
]
}
}

A API retorna os dados da consulta de Top RequestUri de acordo com a query informada na requisição.

Para saber mais sobre os conjuntos de dados disponíveis para consulta com a GraphQL API, visite a página de documentação.



Contribuidores