Publiek endpoint - JSON Metrics - AppSignal Documentation

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.

Shell

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

Voorbeeld van een JSON-body

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

Voorbeeld van een door newlines gescheiden body:

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

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.

​Endpoint

​URL-parameters

​Body-parameters

Endpoint

URL-parameters

Body-parameters