Public Endpoint - JSON Metrics - AppSignal Documentation

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.

Shell

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" }`

Beispiel eines JSON-Bodys

[
  {
    "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" }
  }
]

Beispiel eines durch Zeilenumbrüche getrennten Bodys:

JSON

{"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.

​Endpunkt

​URL-Parameter

​Body-Parameter

Endpunkt

URL-Parameter

Body-Parameter