Dit StatsD API-endpoint wordt geboden om aanvullende metrics aan AppSignal toe te voegen, wanneer een bestaande integratie niet kan worden gebruikt of de gebruikte taal (nog) niet wordt ondersteund.
Dit endpoint is bedoeld voor integraties die geaggregeerde metrics over een korte periode versturen; het verdient de voorkeur om elke 5 seconden één request met 100 metrics te versturen dan 100 requests per 5 minuten met telkens één metric.
Endpoint
Request-methode: POST
| Endpoint | Beschrijving |
|---|
| https://appsignal-endpoint.net/metrics/statsd | Accepteert (Dog)StatsD-data |
URL-parameters
| Parameter | Type | Beschrijving |
|---|
| api_key | String | Front-end API-sleutel, te vinden in App-instellingen. |
https://appsignal-endpoint.net/metrics/statsd?api_key=<api_key>
Body-parameters
De post-body moet (Dog)StatsD-geformatteerde metrics bevatten, gescheiden door een newline.
Bijvoorbeeld:
login_count:1|c|#hostname:frontend1
stripe_api_duration:19|ms|#function:payment,domain:appsignal
cpu_usage:55.1|g|#hostname:frontend1,cpu:0
Hier is een volledig voorbeeld van hoe u deze metrics kunt versturen met cURL. (Let op het gebruik van enkele aanhalingstekens voor de --data-optie en het voorafgaande $. Alleen dan werken regeleindes in de --data-waarde.)
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"
Let op: dit endpoint is geoptimaliseerd voor grote hoeveelheden verkeer en
valideert de API-sleutel of payload niet; er wordt een 200 (OK)-respons
geretourneerd zolang de body-grootte binnen de limiet van 200k ligt. Dit
betekent niet dat de aanvraag bij ontvangst wordt geaccepteerd.