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 terminaison | Description |
|---|
| https://appsignal-endpoint.net/metrics/statsd | Accepte les données (Dog)StatsD |
Paramètres d’URL
| Paramètre | Type | Description |
|---|
| api_key | String | Clé d’API Front-end, peut être trouvée dans les paramètres de l’application. |
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.