Passer au contenu principal
Ce point de terminaison d’API StatsD est fourni pour ajouter des métriques supplémentaires à AppSignal, lorsqu’une intégration existante ne peut pas être utilisée ou que le langage utilisé n’est pas (encore) pris en charge. Ce point de terminaison est destiné aux intégrations qui envoient des métriques agrégées sur une courte période. Il est préférable d’envoyer une requête toutes les 5 secondes contenant 100 métriques plutôt que 100 requêtes toutes les 5 minutes avec une métrique chacune.

Point de terminaison

Méthode de requête : POST
Point de terminaisonDescription
https://appsignal-endpoint.net/metrics/statsdAccepte les données (Dog)StatsD

Paramètres d’URL

ParamètreTypeDescription
api_keyStringClé d’API Front-end, peut être trouvée dans les paramètres de l’application.
Shell
https://appsignal-endpoint.net/metrics/statsd?api_key=<api_key>

Paramètres du corps

Le corps de la requête POST doit contenir des métriques formatées (Dog)StatsD séparées par un saut de ligne. Par exemple :
login_count:1|c|#hostname:frontend1
stripe_api_duration:19|ms|#function:payment,domain:appsignal
cpu_usage:55.1|g|#hostname:frontend1,cpu:0
Voici un exemple complet d’envoi de ces métriques à l’aide de cURL. (Notez l’utilisation des guillemets simples pour l’option --data et le $ précédent. Ce n’est qu’à cette condition que les sauts de ligne fonctionneront dans la valeur --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"
Note : Cet endpoint est optimisé pour de grands volumes de trafic et ne valide pas la clé API ni la charge utile. Une réponse 200 (OK) est renvoyée lorsque la taille du corps est dans la limite de 200k. Cela ne signifie pas que la requête est acceptée lors de sa réception.