1 of 20
2 of 20
3 of 20
4 of 20
5 of 20
6 of 20
7 of 20
8 of 20
9 of 20
10 of 20
11 of 20
12 of 20
13 of 20
14 of 20
15 of 20
16 of 20
17 of 20
18 of 20
19 of 20
20 of 20

site

doc

blog

success stories

Real-Time Metrics

Edite no GitHub

Através da API do Real-Time Metrics, você pode consultar dados de monitoramento coletados a partir do tráfego de seu conteúdo e aplicações pela Azion.

Os dados estão agrupados de acordo com Produto, Domínio, Métrica e Dimensão.

  1. Obter a lista de domínios por produto
  2. Obter dados de consumo de uma métrica por domínio
  3. Obter dados de consumo da dimensão específica de uma métrica

1. Obter a lista de domínios por produto

Retorna a lista de todos os domínios relacionados ao produto selecionado.

GET /metrics/products/:prod_id/configurations

Permissão necessária: Analytics

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization
*obrigatório
A autenticação por Token previamente criado através do endpoint de Criação de Token.

Por exemplo:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
:prod_id
*obrigatório
ID do produto a ser consultado:

Edge Applications = 1441740010
Data Streaming = 1498670028
Edge Functions = 1531930033
Image Processor = 1441110021
Intelligent DNS = 1563390045
L2 Caching = 1564082375
Load Balancer = 1441740012
path number

Exemplo de Requisição

GET  /metrics/products/1441740010/configurations
Accept: application/json; version=3
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Exemplo de Resposta

HTTP/2 200
  {  
     “id”:  1571935365,
     “name”:  “edgeapplication1”,
     “active”:  true,
     “domains”:  [
             1571944666,
             1573685184,
             1573735195,
             1573735196,
             1573755201,
             1573755203,
             1574345332,
             1574345333,
             1609959772
       ]
  },
  {
     “id”:  1575396468,
     “name”:  “edgeapplication2”,
     “active”:  true,
     “domains”:  [
             1575395594
  ]

2. Obter dados de consumo de uma métrica por domínio

Retorna o consumo de dados das métricas por domínio relacionado ao produto selecionado.

GET /metrics/products/:prod_id/configurations/:conf_id/metrics/:metric_name

Permissão necessária: Analytics

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization
*obrigatório
A autenticação por Token previamente criado através do endpoint de Criação de Token.

Por exemplo:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
:prod_id
*obrigatório
ID do produto a ser consultado:

Edge Applications = 1441740010
Data Streaming = 1498670028
Edge Functions = 1531930033
Image Processor = 1441110021
Intelligent DNS = 1563390045
L2 Caching = 1564082375
Load Balancer = 1441740012
path number
:conf_id
*obrigatório
Código do domínio a ser consultado
Para obter o ID de uma configuração, siga as orientações descritas em Consultando a Lista de Domínios por Produto.
path number
:metric_name
*obrigatório
Nome da métrica a ser consultada:

Data Streaming
data_streaming_data_streamed
data_streaming_requests

Edge Applications
data_transferred
data_offloaded
cdn_requests
requests_per_second
requests_offloaded
status_code
http_method
waf
connected_users
bandwidth

Edge Functions
invocations

Intelligent DNS
idns_queries
hosted_zones

Image Processor
images_processed

L2 Caching
l2_data_transferred

Load Balancer
load_balancer_data_transferred
path string
date_from
*obrigatório
Data e horário de início da consulta no formato “YYYY-MM-DDThh:mm” (Local Time) ou “YYYY-MM-DDThh:mmZ” (UTC). Também poderá ser especificada a duração utilizando um dos seguintes valores, sendo que o parâmetro date_to deverá ser omitido nesse caso:
last-hour
last-3-days
last-3-hours
last-7-days
last-6-hours
last-15-days
last-24-hours
last-30-days
query string
date_to
*opcional
Data e horário de final da consulta no formato “YYYY-MM-DDThh:mm” (Local Time) ou “YYYY-MM-DDThh:mmZ” (UTC). Também poderá ser especificada a duração utilizando o valor “now”, sendo que em caso de omissão será considerado como o valor default. query string
human_readable
*opcional
Com o objetivo de tornar o timestamp apresentado pela API mais fácil de ser entendido por usuários humanos, o parâmetro chamado “human_readable” foi adicionado. Por padrão, este parâmetro é definido como “false”, mas ao passá-lo para “true”, o usuário receberá o timestamp no seguinte formato: YYYY-MM-DD hh:mm

Exemplo: 2021-05-19 16:14

Observação: Esse parâmetro não é case sensitive, por isso pode receber qualquer variação de true, como por exemplo: True, TRUE, TrUe.
query boolean

Exemplo de Requisição

GET  /metrics/products/1441740010/configurations/1573735195/metrics/data_transferred?date_from=2021-02-03...
Accept: application/json; version=3
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Exemplo de Resposta

HTTP/2 200
             1612313100000.0,
              0.001946
  ],
  [
             1612314000000.0,
              0.001678
  ],
  [
             1612313700000.0,
              0.002853
  ],
  [
             1612314000000.0,
              0.003564
  ],
  [

3. Obter dados de consumo da dimensão específica de uma métrica

Retorna o consumo da dimensão específica de uma métrica relacionado ao produto selecionado.

GET /metrics/products/:prod_id/configurations/:conf_id/metrics/:metric_name/dimensions/:dim_name

Permissão necessária: Analytics

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization
*obrigatório
A autenticação por Token previamente criado através do endpoint de Criação de Token.

Exemplo:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
:prod_id
*obrigatório
ID do produto a ser consultado:

Edge Applications = 1441740010
Data Streaming = 1498670028
Edge Functions = 1531930033
Image Processor = 1441110021
Intelligent DNS = 1563390045
L2 Caching = 1564082375
Load Balancer = 1441740012
path number
:conf_id
*obrigatório
Código do domínio a ser consultado
Para obter o ID de uma configuração, siga as orientações descritas em Consultando a Lista de Domínios por Produto.
path number
:metric_name
*obrigatório
Nome da métrica a ser consultada:

Data Streaming
data_streaming_data_streamed
data_streaming_requests

Edge Applications
data_transferred
data_offloaded
cdn_requests
requests_per_second
requests_offloaded
status_code
http_method
waf
connected_users
bandwidth

Edge Functions
invocations

Intelligent DNS
idns_queries
hosted_zones

Image Processor
images_processed

L2 Caching
l2_data_transferred

Load Balancer
load_balancer_data_transferred
path string
:dim_name
*obrigatório
Nome da dimensão da métrica a ser consultada. path string
date_from
*obrigatório
Data e horário de início da consulta no formato “YYYY-MM-DDThh:mm” (Local Time) ou “YYYY-MM-DDThh:mmZ” (UTC). Também poderá ser especificada a duração utilizando um dos seguintes valores, sendo que o parâmetro date_to deverá ser omitido nesse caso:
last-hour
last-3-days
last-3-hours
last-7-days
last-6-hours
last-15-days
last-24-hours
last-30-days
query string
date_to
*opcional
Data e horário de final da consulta no formato “YYYY-MM-DDThh:mm” (Local Time) ou “YYYY-MM-DDThh:mmZ” (UTC). Também poderá ser especificada a duração utilizando o valor “now”, sendo que em caso de omissão será considerado como o valor default. query string
human_readable
*opcional
Com o objetivo de tornar o timestamp apresentado pela API mais fácil de ser entendido por usuários humanos, o parâmetro chamado “human_readable” foi adicionado. Por padrão, este parâmetro é definido como “false”, mas ao passá-lo para “true”, o usuário receberá o timestamp no seguinte formato: YYYY-MM-DD hh:mm

Exemplo:2021-05-19 16:14

Observação: Esse parâmetro não é case sensitive, por isso pode receber qualquer variação de true, como por exemplo: True, TRUE, TrUe.
query boolean

Exemplo de Requisição

GET        /metrics/products/1441740010/configurations/1573735195/metrics/data_transferred/dimensions/total?date_from=2021-02-03 00:00&date_to=2021-02-03 05:00
Accept: application/json; version=3
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Exemplo de Resposta

HTTP/2 200
  ],
  [
     161231400000.0
     0.0014359999999999995

  ],
  […
  ],
  […
  ],
  [
     161231400000.0
     0.0000289999999999995

  ],
  […
  ],
  [
     161231400000.0
     0.0046559999999999995
  ],

Exemplo de requisição para o parâmetro human_readable

GET /metrics/products/1441740010/configurations/1573735195/metrics/data_transferred/dimensions/total?date_from=2021-05-19 17:35&date_to=2021-05-19 17:40&human_readable=true
Accept: application/json; version=3
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Exemplo de resposta para o parâmetro human_readable

HTTP/2 200
],
  [
     "2021-05-19 17:36"
     0.0014359999999999995

  ],
  […
  ],
  […
  ],
  [
     "2021-05-19 17:37"
     0.0000289999999999995

  ],
  […
  ],
  [
     "2021-05-19 17:38"
     0.0046559999999999995
  ],

Não encontrou o que procurava? Abra um ticket.