Consulte dados de uso do Data Stream

Leia o uso que Data Stream contabiliza na sua conta, por workload e métrica, com uma query GraphQL à API de consumo da Azion.

Última atualização

Ver como Markdown Configurar agente

Você pode consultar o uso que Data Stream contabiliza na sua conta com a API GraphQL da Azion. Para verificar os envios de um stream e o código de status de cada um, consulte Como o Data Stream funciona.

O dataset workloadConsumptionMetrics agrega o uso contabilizado para cada produto da Azion, incluindo Data Stream, e o mantém por até 24 meses. O endpoint de consumo o serve em https://api.azion.com/v4/consumption/graphql. Para comparar os totais com o que o seu plano inclui, consulte Limites de Data Stream.

Pré-requisitos

Consulte o uso do Data Stream

A query filtra o dataset pelo ID de produto do Data Stream, 1498670028, e pelas duas métricas dele, data_streamed e requests. Ela soma o uso contabilizado para cada workload e métrica:

GraphQL
01query {
02 workloadConsumptionMetrics(
03 filter: {
04 tsRange: { begin: "2026-09-01T00:00:00", end: "2026-10-03T00:00:00" }
05 productId: 1498670028
06 metricNameIn: ["data_streamed", "requests"]
07 }
08 aggregate: { sum: accounted }
09 limit: 10000
10 groupBy: [clientId, workloadId, productId, metricName]
11 ) {
12 clientId
13 workloadId
14 productId
15 metricName
16 total: sum
17 }
18}

A query usa estes argumentos:

  • tsRange define o período, com begin e end no formato YYYY-MM-DDTHH:mm:ss.
  • productId mantém apenas o uso do Data Stream.
  • metricNameIn recebe uma lista de métricas. Para ler uma métrica, use metricName com uma string, como metricName: "data_streamed".
  • sum: accounted soma o uso contabilizado para os eventos que correspondem ao filtro, para cada grupo.
  • limit limita o número de linhas. O máximo é 10000.
  • groupBy retorna uma linha para cada combinação de cliente, workload, produto e métrica.

Para enviar a query, faça uma requisição POST ao endpoint de consumo. Substitua [TOKEN VALUE] pelo seu personal token e as datas pelas suas:

Shell
01curl -X POST 'https://api.azion.com/v4/consumption/graphql' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"query":"query { workloadConsumptionMetrics( filter: { tsRange: { begin: \"2026-09-01T00:00:00\", end: \"2026-10-03T00:00:00\" } productId: 1498670028 metricNameIn: [\"data_streamed\", \"requests\"] } aggregate: { sum: accounted } limit: 10000 groupBy: [clientId, workloadId, productId, metricName] ) { clientId workloadId productId metricName total: sum } }"}'

Em uma conta sem uso do Data Stream contabilizado no período, a API responde 200 com uma lista vazia:

JSON
01{
02 "data": {
03 "workloadConsumptionMetrics": []
04 }
05}

Uma lista vazia significa que nenhum uso do Data Stream corresponde ao filtro naquele período. Quando há uso, cada linha traz estes campos:

  • clientId: o identificador da sua conta na Azion.
  • workloadId: o workload ao qual o uso pertence.
  • productId: 1498670028, o ID de produto do Data Stream.
  • metricName: data_streamed ou requests.
  • total: para data_streamed, os dados que Data Stream enviou para o workload, em bytes. Para requests, o número de requisições processadas.

Para ver quantos dados os seus streams enviaram para cada workload, leia o total das linhas data_streamed. Uma lista em metricName falha com 400 e Expected type "String". Use metricNameIn para uma lista.

Você também pode colar a query no Playground GraphiQL em https://api.azion.com/v4/consumption/graphql, com login na sua conta Azion. Para todos os campos do dataset, consulte Campos da GraphQL API de Consumption.

Verifique um resultado vazio

Uma lista vazia também pode vir de um período errado ou de um filtro que não corresponde a nada. Para confirmar que o dataset retorna uso para a sua conta, consulte o dataset sem os filtros de produto e de métrica. Esta query agrupa um dia de uso por produto e métrica:

Shell
01curl -X POST 'https://api.azion.com/v4/consumption/graphql' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"query":"query { workloadConsumptionMetrics( filter: { tsRange: { begin: \"2026-10-02T00:00:00\", end: \"2026-10-03T00:00:00\" } } aggregate: { sum: accounted } limit: 50 groupBy: [productId, metricName] ) { productId metricName total: sum } }"}'

A API responde 200 com uma linha para cada produto e métrica que tem uso contabilizado:

JSON
01{
02 "data": {
03 "workloadConsumptionMetrics": [
04 {
05 "productId": 1441740010,
06 "metricName": "requests",
07 "total": 514.0
08 },
09 {
10 "productId": 1441740010,
11 "metricName": "data_transferred_total",
12 "total": 17057621.0
13 }
14 ]
15 }
16}

Linhas de outros produtos, sem nenhuma que traga 1498670028, significam que o token e o dataset funcionam e que a conta não tem uso do Data Stream contabilizado naquele dia. Se esta query também retornar uma lista vazia, a conta não tem uso contabilizado naquele período.

Próximos passos

Limites de Data StreamCompare os totais com os Requests e o Data Transfer que cada plano inclui.Como o Data Stream funcionaVeja como um stream agrupa linhas de log em lotes e as envia, e onde cada envio fica registrado.Campos da GraphQL API de ConsumptionConsulte cada campo, filtro e produto do dataset workloadConsumptionMetrics.