Consulte dados agregados com GraphQL
Some os bytes que suas aplicações enviaram por bucket de tempo com uma query agregada da GraphQL API ao endpoint de métricas, pelo curl ou outro cliente HTTP.
Você pode ler totais ao longo do tempo na GraphQL API com uma query agregada, enviada pelo curl ou por qualquer outro cliente HTTP.
Dados agregados são dados de requisições que o endpoint de métricas armazena agrupados em buckets de tempo. Uma query agregada aplica uma função, como sum, a um campo e retorna uma linha por grupo. Para as regras de uma query agregada, consulte Queries. O exemplo abaixo lê o dataset workloadMetrics. O dataset httpMetrics foi descontinuado e retorna as mesmas linhas; use workloadMetrics. Para os datasets de cada endpoint, consulte Datasets e argumentos de query.
Pré-requisitos
- Um personal token. Para criar um, consulte Como criar um personal token.
- Uma aplicação em Applications que recebeu requisições durante a janela de tempo consultada.
- O
curlou outro cliente HTTP que envie requisiçõesPOST. Para executar uma query pelo GraphiQL Playground em vez disso, consulte Primeiros passos com a GraphQL API.
Some os bytes enviados por bucket de tempo
Esta query soma bytesSent, os bytes enviados aos clientes, em cada bucket de tempo de uma janela de sete dias. Para executá-la:
Defina begin e end em tsRange como a janela que você quer ler, no formato YYYY-MM-DDTHH:mm:ss:
Envie a query na chave query de um corpo JSON para https://api.azion.com/v4/metrics/graphql. Substitua [TOKEN VALUE] pelo seu personal token:
A API responde 200 com 10 linhas. A resposta abaixo está cortada após as três primeiras linhas:
Cada linha contém o início de um bucket de tempo em ts, em UTC, e os bytes enviados durante ele em sum, do bucket mais antigo para o mais recente. Em uma janela de sete dias, os buckets têm uma hora, e uma hora sem requisições não retorna linha. A duração da janela define o tamanho do bucket, conforme descreve Como a GraphQL API funciona. Um array workloadMetrics vazio significa que nenhuma requisição correspondeu à janela.
Três argumentos moldam o resultado:
| Argumento | No exemplo | O que faz |
|---|---|---|
aggregate | {sum: bytesSent} | Aplica a função sum ao campo bytesSent. O resultado volta em um campo com o nome da função, sum. |
groupBy | [ts] | Retorna uma linha por valor dos campos listados. [ts] retorna uma linha por bucket de tempo. Sem groupBy, a resposta contém uma linha com o total da janela inteira. |
orderBy | [ts_ASC] | Ordena as linhas por um campo e um sufixo de direção. ts_ASC lista primeiro o bucket mais antigo, ts_DESC o mais recente e sum_DESC o maior total. |
Para somar outro campo, substitua bytesSent em aggregate, por exemplo por requestTime ou requests. Para os campos que cada função aceita, consulte Queries.