Como consultar dados de uso do Data Stream

O conjunto de dados workloadConsumptionMetrics permite que você obtenha dados agregados em tempo real relacionados ao consumo e uso dos produtos da Azion, incluindo o Data Stream.

As informações podem ser acessadas através da API GraphQL, permitindo que você transfira esses dados para uma plataforma de terceiros e possibilite análises e revisões adicionais. Além disso, os dados estão disponíveis por até 24 meses.

Este guia explica como consultar o total de dados transmitidos pelo Data Stream usando o GraphiQL Playground.

Consulte o total de dados transmitidos

Para consultar o total de dados transmitidos pelo Data Stream, siga os passos abaixo:

Acesse o Playground GraphiQL no seguinte link: https://api.azion.com/v4/consumption/graphql.
- Você precisa estar logado na sua conta Azion. Caso contrário, receberá uma mensagem de erro.
Envie uma consulta seguindo este formato:

query {
  workloadConsumptionMetrics(
    filter: {
      tsRange: {
        begin: "2025-02-01T00:00:00",
        end: "2025-03-01T00:00:00",
      }
      productId: 1498670028
      metricName: ["data_streamed", "requests"]
    }
    aggregate: {
      sum: accounted
    }
    limit: 10000
    groupBy: [clientId, workloadId, productId, metricName]
  ) {
    clientId
    workloadId
    productId
    metricName
    total: sum
  }
}

Onde:

Campo	Descrição
`filter`	Define os critérios usados para filtrar os dados retornados pela consulta.
`tsRange`	Um subcampo de `filter`. Especifica um intervalo de tempo para filtrar os dados. Inclui os campos `begin` e `end` para definir o tempo inicial e final. Formato: `"YYYY-MM-DDTHH:mm:ss"`; exemplo: `"2024-04-11T00:00:00"`.
`sum: accounted`	Como um subcampo de `aggregate`, calcula o uso total contabilizado para eventos que correspondem aos filtros e grupos da consulta.
`limit`	Especifica o número máximo de resultados a serem retornados. Máximo do sistema: `10000`.
`groupBy`	Especifica os campos pelos quais os resultados da consulta devem ser agrupados. Exemplo: `[clientId, metricName]`.
`productId`	Identificador único do produto sendo usado. Neste caso, `1498670028` para o Data Stream.
`metricName`	Nome da métrica calculada para análise. Neste caso, `data_streamed` e `requests`.

Você receberá uma resposta JSON similar a esta:

{
  "data": {
    "workloadConsumptionMetrics": [
      {
        "clientId": "0000z",
        "workloadId": 7584931026,
        "productId": 1498670028,
        "metricName": "requests",
        "total": 1112
      },
      {
        "clientId": "0000z",
        "workloadId": 7584931026,
        "productId": 1498670028,
        "metricName": "data_streamed",
        "total": 6126218
      },
      {
        "clientId": "0000z",
        "workloadId": 1938475620,
        "productId": 1498670028,
        "metricName": "requests",
        "total": 2310065538
      },
      {
        "clientId": "0000z",
        "workloadId": 1938475620,
        "productId": 1498670028,
        "metricName": "data_streamed",
        "total": 74047917265
      },
      {
        "clientId": "0000z",
        "workloadId": 4829103746,
        "productId": 1498670028,
        "metricName": "data_streamed",
        "total": 4302538389
      }
    ]
  }
}

Onde:

Campo	Descrição
`clientId`	Identificador único do cliente na Azion. Exemplo: `8437r`.
`workloadId`	Identificador para a carga de trabalho associada ao uso. Exemplo: `4829301746`.
`productId`	Identificador único do produto sendo usado. Neste caso, `1498670028` para o Data Stream.
`metricName`	Nome da métrica medida para análise. Exemplo: `data_streamed` e `requests`.
`total`	Para `data_streamed`, número total de dados transmitidos pelo Data Stream. Este campo é o resultado de uma soma, em bytes. Exemplo: `268675`. Para `requests`: número total de requisições processadas. Este campo é o resultado de uma soma. Exemplo: `1112`.