Dieser API-Endpunkt ermöglicht es, zusätzliche Metriken an AppSignal zu senden, wenn eine bestehende Integration nicht verwendet werden kann oder die verwendete Sprache (noch) nicht unterstützt wird.
Dieser Endpunkt ist für Integrationen gedacht, die aggregierte Metriken über einen kurzen Zeitraum senden. Es ist besser, alle 5 Sekunden eine Anfrage mit 100 Metriken zu senden als 100 Anfragen pro 5 Minuten mit jeweils einer Metrik.
Endpunkt
Request-Methode: POST
| Endpunkt | Beschreibung |
|---|
| https://appsignal-endpoint.net/metrics/json | Akzeptiert JSON-formatierte Daten |
URL-Parameter
| Parameter | Typ | Beschreibung |
|---|
| api_key | String | Front-end-API-Schlüssel, zu finden in den App-Einstellungen. |
https://appsignal-endpoint.net/metrics/json?api_key=<api_key>
Body-Parameter
Der POST-Body sollte JSON-formatierte Metriken enthalten, getrennt durch einen Zeilenumbruch, oder als vollständiger JSON-Body.
| Parameter | Typ | Beschreibung |
|---|
| name | String | Name der Metrik, sollte keine Leerzeichen oder Sonderzeichen enthalten, z. B. nur ([a-zA-Z0-9-_]) |
| metricType | String | Metriktyp, einer von [gauge, counter, timing, histogram] |
| value | Float | (Float-)Wert |
| tags | Object<String, String> | Objekt mit Tags. Sowohl Schlüssel als auch Wert sollten ein String sein, zum Beispiel: { "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
Hinweis: Dieser Endpoint ist für hohe Traffic-Mengen optimiert und validiert
weder den API-Schlüssel noch den Payload. Eine 200-Antwort (OK) wird zurückgegeben, wenn
die Body-Größe innerhalb des Limits von 200k liegt. Das bedeutet nicht, dass die Anfrage
beim Empfang akzeptiert wurde.
