Dit 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/json | Accepteert JSON-geformatteerde data |
URL-parameters
| Parameter | Type | Beschrijving |
|---|
| api_key | String | Front-end API-sleutel, te vinden in App-instellingen. |
https://appsignal-endpoint.net/metrics/json?api_key=<api_key>
Body-parameters
De post-body moet JSON-geformatteerde metrics bevatten, gescheiden door een newline, of als een volledige json-body.
| Parameter | Type | Beschrijving |
|---|
| name | String | Naam van de metric, mag geen spaties of speciale tekens bevatten, bijv. alleen ([a-zA-Z0-9-_]) |
| metricType | String | Metrictype, kan een van [gauge, counter, timing, histogram] zijn |
| value | Float | (Float) waarde |
| tags | Object<String, String> | Object met tags. Zowel key als value moet een string zijn, bijvoorbeeld: { "hostname": "frontend1" } |
[
{
"name": "traffic_gauge",
"metricType": "gauge",
"value": 19.8,
"tags": { "hostname": "frontend1" }
},
{
"name": "error_counter",
"metricType": "counter",
"value": 10,
"tags": { "hostname": "frontend1", "disk": "vda" }
},
{
"name": "duration_timing",
"metricType": "timing",
"value": 19,
"tags": { "lambda": "login" }
},
{
"name": "duration_timing",
"metricType": "histogram",
"value": 5,
"tags": { "lambda": "login" }
}
]
{"name": "traffic_gauge", "metricType": "gauge", "value": 19.8, "tags": {"hostname": "frontend1"}}\n
{"name": "error_counter", "metricType": "counter", "value": 10, "tags": {"hostname": "frontend1", "disk": "vda"}}\n
{"name": "duration_timing", "metricType": "timing", "value": 19, "tags": {"lambda": "login"}}\n
{"name": "duration_timing", "metricType": "histogram", "value": 5, "tags": {"lambda": "login"}}\n
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.
