> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public Endpoint - JSON Metrics

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](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.com/redirect-to/app?to=info). |

```shell Shell theme={null}
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

<CodeGroup>
  ```json JSON theme={null}
  [
    {
      "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" }
    }
  ]
  ```
</CodeGroup>

Beispiel eines durch Zeilenumbrüche getrennten Bodys:

```json JSON theme={null}
{"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
```

<Tip>
  **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.
</Tip>