Este endpoint da API StatsD é fornecido para adicionar métricas adicionais ao AppSignal, onde uma integração existente não pode ser usada ou a linguagem usada ainda não é suportada.
Este endpoint é destinado a integrações que enviam métricas agregadas em um curto período; é preferível enviar uma requisição a cada 5 segundos com 100 métricas do que 100 requisições a cada 5 minutos com uma métrica cada.
Endpoint
Método da requisição: POST
Parâmetros de URL
| Parâmetro | Tipo | Descrição |
|---|
| api_key | String | Chave de API Front-end, pode ser encontrada nas configurações do App. |
https://appsignal-endpoint.net/metrics/statsd?api_key=<api_key>
Parâmetros do corpo
O corpo do post deve conter métricas formatadas em (Dog)StatsD separadas por uma nova linha.
Por exemplo:
login_count:1|c|#hostname:frontend1
stripe_api_duration:19|ms|#function:payment,domain:appsignal
cpu_usage:55.1|g|#hostname:frontend1,cpu:0
Aqui está um exemplo completo de como enviar essas métricas usando cURL. (Observe o uso de aspas simples para a opção --data e o $ no início. Somente assim as quebras de linha funcionarão no valor de --data.)
curl -H "Content-Type: text/plain" -X POST --data $'login_count:10|c|#hostname:frontend1\nstripe_api_duration:19|ms|#function:payment,domain:appsignal' "https://appsignal-endpoint.net/metrics/statsd?api_key=FRONTEND-API-KEY"
Nota: Este endpoint é otimizado para grandes volumes de tráfego e não
valida a chave da API ou o payload, uma resposta 200 (OK) é retornada quando o
tamanho do corpo está dentro do limite de 200k. Isso não significa que a requisição é
aceita ao ser recebida.