Primeiros passos com Real-Time Metrics

Leia os totais de requisições e de dados transferidos das suas aplicações no Azion Console ou com uma query GraphQL e restrinja-os a 24 horas e a um host.

Última atualização

Ver como Markdown Configurar agente

Este guia orienta você a ler os seus primeiros números de tráfego em Real-Time Metrics, no Azion Console ou com a API GraphQL.

  • Leia o total de requisições e o total de dados transferidos das suas aplicações.
  • Defina o intervalo de tempo para as últimas 24 horas.
  • Restrinja os dois totais a um host.

Real-Time Metrics não cria nada e não há nada para ativar: o produto está ativo em toda conta Azion. Ele lê as métricas que as suas aplicações e outros produtos geram à medida que recebem tráfego e as mostra em gráficos assim que o tráfego chega. Duas coisas estão por trás de cada número desta página:

  1. Uma aplicação que já atendeu requisições. Essas requisições são os dados.
  2. O dataset httpMetrics, que registra as requisições das suas aplicações. Os gráficos da aba Applications e a API GraphQL leem esse dataset, então as duas interfaces retornam os mesmos totais para o mesmo intervalo e o mesmo filtro.

Real-Time Metrics mostra números agregados. Para os logs por trás de cada número, consulte Real-Time Events.

Selecione a sua interface uma vez. Os pré-requisitos e cada etapa abaixo mostram apenas esse caminho.

Pré-requisitos

  • Uma conta Azion. Para criar uma, consulte Criar uma conta.
  • Uma aplicação atendida por um workload, com requisições nas últimas 24 horas.
  • Um host em que o workload responde, como www.example.com. Você filtra as métricas por ele.

Abra as métricas de requisições das suas aplicações

Sem filtro, Real-Time Metrics conta as requisições e os dados transferidos de todas as aplicações da sua conta.

Para ler os dois totais com a API GraphQL, envie uma requisição POST para https://api.azion.com/v4/metrics/graphql. A query seleciona requestsTotal e dataTransferredTotal do dataset httpMetrics, e as variáveis definem um intervalo de uma hora.

Substitua [TOKEN VALUE] pelo seu personal token e os valores de begin e end pela hora que você quer ler:

Shell
01curl -X POST 'https://api.azion.com/v4/metrics/graphql' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"query":"query TrafficLastHour($begin: DateTime!, $end: DateTime!) { httpMetrics(limit: 1, filter: { tsRange: { begin: $begin, end: $end } }) { requestsTotal dataTransferredTotal } }","variables":{"begin":"2026-01-02T11:00:00","end":"2026-01-02T12:00:00"}}'

A API responde 200 com uma linha:

JSON
01{
02 "data": {
03 "httpMetrics": [
04 {
05 "requestsTotal": 0,
06 "dataTransferredTotal": 0.0
07 }
08 ]
09 }
10}

A linha contém os totais do intervalo. Um 0 significa que nenhuma requisição chegou às suas aplicações naquela hora. A API exige um intervalo: uma query sem tsRange retorna 400 com To execute queries it is mandatory to provide the desired time interval.

Para todos os campos do dataset, consulte Campos da API GraphQL do Real-Time Metrics.

Para ler os dois totais no Azion Console:

Abra Real-Time Metrics

Acesse Azion Console > Real-Time Metrics.

A página abre na categoria Build, na aba Applications e no dashboard Data Transferred.

Leia os dados transferidos

No gráfico Edge Cache, encontre a entrada Data Transferred Total na legenda.

Selecione Requests no seletor de dashboards
Leia a contagem de requisições

No gráfico Total Requests, encontre a entrada Edge Requests Total na legenda.

Os dois gráficos cobrem Last 5 minutes, o intervalo com que a página abre. Cada entrada da legenda mostra <Series> - <total>, em que o total soma todo o intervalo.

O dropdown de categoria também oferece Secure e Observe, cada uma com as próprias abas de produto. Para o layout completo, consulte Filtros e intervalo de tempo.

Defina o intervalo de tempo para as últimas 24 horas

O intervalo de tempo define o período que cada total cobre. Nas duas interfaces, esta etapa lê as mesmas 24 horas.

O filtro tsRange define o período com begin e end. Para ler as últimas 24 horas com a API, envie a mesma query com begin 24 horas antes de end. O nome da operação diz o que o intervalo cobre:

Shell
01curl -X POST 'https://api.azion.com/v4/metrics/graphql' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"query":"query TrafficLast24Hours($begin: DateTime!, $end: DateTime!) { httpMetrics(limit: 1, filter: { tsRange: { begin: $begin, end: $end } }) { requestsTotal dataTransferredTotal } }","variables":{"begin":"2026-01-01T12:00:00","end":"2026-01-02T12:00:00"}}'

A API responde 200 com os totais dessas 24 horas:

JSON
01{
02 "data": {
03 "httpMetrics": [
04 {
05 "requestsTotal": 1985,
06 "dataTransferredTotal": 149684815.0
07 }
08 ]
09 }
10}

requestsTotal conta as requisições que as suas aplicações atenderam no intervalo. dataTransferredTotal está em bytes e soma os dados transferidos de entrada e de saída.

Para definir o intervalo no Azion Console:

Abra o seletor de intervalo de tempo

Na linha de filtros, selecione o seletor de intervalo de tempo.

Selecione Last 24 hours

Na aba Quick, em Commonly used, selecione Last 24 hours.

Selecione Update

Depois que o intervalo muda, o botão Refresh ao lado do seletor passa a mostrar Update.

Todos os gráficos são recarregados para as últimas 24 horas, e a entrada Edge Requests Total da legenda passa a totalizar esse período.

Para um início e um fim personalizados, ou para recarregar os gráficos automaticamente em intervalos fixos, consulte Filtros e intervalo de tempo.

Filtre por um host

Um filtro mantém apenas as requisições que correspondem a ele, e todos os totais acompanham o filtro. Esta etapa mantém as requisições para o host www.example.com. Substitua-o por um host em que o seu workload responde.

Para filtrar com a API, adicione hostEq a filter, ao lado de tsRange. A query mantém o intervalo de 24 horas que você definiu:

Shell
01curl -X POST 'https://api.azion.com/v4/metrics/graphql' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"query":"query TrafficForHost($begin: DateTime!, $end: DateTime!) { httpMetrics(limit: 1, filter: { tsRange: { begin: $begin, end: $end }, hostEq: \"www.example.com\" }) { requestsTotal dataTransferredTotal } }","variables":{"begin":"2026-01-01T12:00:00","end":"2026-01-02T12:00:00"}}'

A API responde 200 com os totais desse host apenas:

JSON
01{
02 "data": {
03 "httpMetrics": [
04 {
05 "requestsTotal": 982,
06 "dataTransferredTotal": 114490585.0
07 }
08 ]
09 }
10}

Os totais agora contam apenas as requisições para esse host, uma parte dos totais da conta no mesmo intervalo. Para os outros operadores que um filtro aceita, consulte Queries da API GraphQL.

Para filtrar o dashboard no Azion Console:

Adicione um filtro

Na linha de filtros, selecione o ícone de filtro, cujo tooltip mostra Add filter.

Selecione o campo Host

Em Filter, selecione Host.

Selecione o operador Equals

Em Operator, selecione Equals.

Insira o host

Insira www.example.com como valor.

Selecione Apply

Um chip abaixo da linha de filtros mostra Host equals: www.example.com. Todos os gráficos passam a mostrar apenas as requisições para esse host, nas últimas 24 horas.

Para filtrar por workload em vez de host, selecione o campo Domain, chamado Workload em algumas contas, e selecione o workload na lista do campo. Para todos os campos e operadores, consulte Filtros e intervalo de tempo.

Próximos passos

Filtros e intervalo de tempoTodos os controles acima dos gráficos: presets, atualização automática, fuso horário, operadores e o campo de query.Dashboards de BuildO que cada gráfico dos dashboards de Applications mede e o campo que o retorna.Detalhe as requisições por status codeDivida as requisições das suas aplicações pelo status code que elas retornaram.Como Real-Time Metrics funcionaO caminho de uma requisição até um gráfico e como o intervalo define a resolução de cada gráfico.