--- name: azion-consulte-dados-de-uso-do-data-stream description: >- Leia o uso que Data Stream contabiliza na sua conta, por workload e métrica, com uma query GraphQL à API de consumo da Azion. --- # Consulte dados de uso do Data Stream Você pode consultar o uso que [Data Stream](/pt-br/documentacao/plataforma/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](/pt-br/documentacao/plataforma/data-stream/como-funciona/#registros-de-entrega-e-metricas). 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](/pt-br/documentacao/plataforma/data-stream/limites/#uso-incluido-por-plano). --- ## Pré-requisitos - Um stream que enviou logs durante o período que você consulta. Para criar um, consulte [Primeiros passos do Data Stream](/pt-br/documentacao/plataforma/data-stream/primeiros-passos/). - Um personal token. Para criar um, consulte [Como criar um personal token](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/). - `curl`. --- ## 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 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 } } ``` 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: ```bash curl -X POST 'https://api.azion.com/v4/consumption/graphql' \ -H 'Content-Type: application/json' \ -H 'Authorization: Token [TOKEN VALUE]' \ -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 { "data": { "workloadConsumptionMetrics": [] } } ``` 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](/pt-br/documentacao/devtools/graphql/playground-graphql/) 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](/pt-br/documentacao/devtools/graphql/campos-gql-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: ```bash curl -X POST 'https://api.azion.com/v4/consumption/graphql' \ -H 'Content-Type: application/json' \ -H 'Authorization: Token [TOKEN VALUE]' \ -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 { "data": { "workloadConsumptionMetrics": [ { "productId": 1441740010, "metricName": "requests", "total": 514.0 }, { "productId": 1441740010, "metricName": "data_transferred_total", "total": 17057621.0 } ] } } ``` 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 Stream](/pt-br/documentacao/plataforma/data-stream/limites.md#uso-incluido-por-plano): Compare os totais com os Requests e o Data Transfer que cada plano inclui. - [Como o Data Stream funciona](/pt-br/documentacao/plataforma/data-stream/como-funciona.md): Veja como um stream agrupa linhas de log em lotes e as envia, e onde cada envio fica registrado. - [Campos da GraphQL API de Consumption](/pt-br/documentacao/devtools/graphql/campos-gql-consumption.md): Consulte cada campo, filtro e produto do dataset workloadConsumptionMetrics.