Pular para o conteúdo principal
Leia dados de métrica com a API pública (V2). Busque uma timeseries para gráficos, uma lista agregada para tabelas ou descubra quais métricas e tags um site possui. Todos os endpoints autenticam com seu token pessoal de API e têm escopo de um único site_id.

​
Consultar uma timeseries

Este endpoint retorna uma ou mais séries de pontos de dados ao longo de um intervalo de tempo. Use-o para desenhar gráficos. 
POST /api/v2/metrics/timeseries

​
Corpo da requisição

CampoTipoObrigatórioDescrição
site_idstringSimSite a ser consultado.
fromstring (ISO 8601)SimInício do intervalo de tempo (inclusivo).
tostring (ISO 8601)SimFim do intervalo de tempo (inclusivo).
selectTimeseriesSelector[]SimQuais métricas, campos e tags buscar.
resolutionResolutionNãoIntervalo entre pontos de dados. Escolhido automaticamente quando omitido.
limitnumberNãoNúmero máximo de séries a retornar.
Cada entrada de select recebe um name de métrica, um objeto tags para filtrar (os valores podem usar * como wildcard), um field (veja fields), uma aggregation opcional (veja aggregations) e draw_null_as_zero (quando true, pontos ausentes são preenchidos com 0). 
{
  "site_id": "YOUR-SITE-ID",
  "from": "2026-06-22T00:00:00Z",
  "to": "2026-06-22T01:00:00Z",
  "resolution": "MINUTELY",
  "select": [
    {
      "name": "transaction_duration",
      "tags": { "namespace": "web" },
      "field": "mean",
      "aggregation": "avg",
      "draw_null_as_zero": false
    }
  ],
  "limit": null
}

​
Resposta

Retorna um Timeseries com a resolution, from, to consultados e um array series. Cada série tem um id, o name da métrica, suas tags, o field que ela representa, min e max no intervalo e um array data de pontos. Cada ponto tem um timestamp e um value numérico.

​
Consultar uma lista

Este endpoint retorna valores de métrica agregados agrupados em linhas. Use-o para construir tabelas. 
POST /api/v2/metrics/list

​
Corpo da requisição

CampoTipoObrigatórioDescrição
site_idstringSimSite a ser consultado.
fromstring (ISO 8601)SimInício do intervalo de tempo (inclusivo).
tostring (ISO 8601)SimFim do intervalo de tempo (inclusivo).
selectListSelector[]SimQuais métricas, campos e tags buscar.
group_byGroupBy[]SimComo agrupar as linhas.
resolutionResolutionNãoIntervalo usado para agregação.
limitnumberNãoNúmero máximo de linhas a retornar.
Um ListSelector é como um seletor de timeseries, com um id extra que nomeia o valor do seletor no objeto data de cada linha. As entradas de group_by são Name (agrupa por nome da métrica) ou Tag (agrupa pelo valor de uma tag). 
{
  "site_id": "YOUR-SITE-ID",
  "from": "2026-06-22T00:00:00Z",
  "to": "2026-06-22T01:00:00Z",
  "resolution": "HOURLY",
  "select": [
    {
      "id": "mean",
      "name": "transaction_duration",
      "tags": { "namespace": "*" },
      "field": "mean",
      "aggregation": "avg"
    }
  ],
  "group_by": ["Name"],
  "limit": 50
}

​
Resposta

Retorna uma List com a resolution, from, to consultados e um array rows. Cada linha tem um id, um objeto group com os valores de tag que a definem e um objeto data com valores agregados indexados pelo id do seletor (por exemplo, { "mean": 42.5 }).

​
Listar nomes de métrica

Retorna todos os nomes de métrica disponíveis para um site. 
GET /api/v2/metrics/names/{site_id}
Retorna um array de strings.

​
Obter o tipo e as tags de uma métrica

Retorna o tipo de uma métrica e as combinações de tags com que ela pode ser consultada. 
GET /api/v2/metrics/type_and_tags/{site_id}/{metric_name}
Retorna um metric_type (gauge, counter ou measurement) e available_tags, um array em que cada entrada é uma combinação válida de chaves de tag.

​
Referência

​
Fields

O field seleciona qual medição obter de uma métrica:
ValorDescrição
gaugeO valor da métrica em um único instante, como uso atual de CPU ou memória.
counterDe métricas counter, o valor cumulativo, que só aumenta com o tempo, como o número de requisições atendidas.
meanA média dos valores registrados no bucket de tempo, como tempo médio de resposta.
countDe métricas measurement, quantos valores foram registrados durante o bucket de tempo.
minO menor valor registrado no bucket de tempo.
maxO maior valor registrado no bucket de tempo.
p_90, p_95Valores de percentil.
Para mais referências de tipo, leia a documentação da API V2 da AppSignal.

​
Aggregations

A aggregation combina vários valores dentro de um bucket de tempo: sum, avg, min, max, first ou last.

​
Resolutions

resolution aceita MINUTELY, FIVE_MINUTELY, TEN_MINUTELY, FIFTEEN_MINUTELY, HOURLY ou DAILY.