> ## 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.
# Metriken abfragen
Lesen Sie Metrikdaten mit der [Public API (V2)](/api/v2/overview). Holen Sie eine
Zeitreihe für Graphen, eine aggregierte Liste für Tabellen oder ermitteln Sie,
welche Metriken und Tags eine Site bietet. Alle Endpunkte authentifizieren sich
mit Ihrem persönlichen API-Token und sind auf eine einzelne `site_id` begrenzt.
## Eine Zeitreihe abfragen
Dieser Endpunkt gibt eine oder mehrere Serien von Datenpunkten über einen
Zeitbereich zurück. Verwenden Sie ihn zum Zeichnen von Graphen.
```shell Endpoint theme={null}
POST /api/v2/metrics/timeseries
```
### Request-Body
| Feld | Typ | Erforderlich | Beschreibung |
| ------------ | --------------------- | ------------ | ------------------------------------------------------------------------ |
| `site_id` | string | Ja | Abzufragende Site. |
| `from` | string (ISO 8601) | Ja | Start des Zeitbereichs (inklusive). |
| `to` | string (ISO 8601) | Ja | Ende des Zeitbereichs (inklusive). |
| `select` | TimeseriesSelector\[] | Ja | Welche Metriken, Felder und Tags abgerufen werden. |
| `resolution` | Resolution | Nein | Intervall zwischen Datenpunkten. Wird bei Weglassen automatisch gewählt. |
| `limit` | number | Nein | Maximale Anzahl zurückzugebender Serien. |
Jeder `select`-Eintrag nimmt einen `name` einer Metrik, ein `tags`-Objekt zum
Filtern (Werte können `*` als Platzhalter verwenden), ein `field` (siehe
[Felder](#fields)), eine optionale `aggregation` (siehe
[Aggregationen](#aggregations)) und `draw_null_as_zero` (wenn `true`, werden
fehlende Punkte mit `0` aufgefüllt) entgegen.
```json body.json theme={null}
{
"site_id": "YOUR-SITE-ID",
"from": "2026-06-22T00:00:00Z",
"to": "2026-06-22T01:00:00Z",
"resolution": "MINUTELY",
"select": [
{
"name": "transaction_duration",
"tags": { "namespace": "web" },
"field": "mean",
"aggregation": "avg",
"draw_null_as_zero": false
}
],
"limit": null
}
```
### Antwort
Gibt eine `Timeseries` mit der abgefragten `resolution`, `from`, `to` und einem
`series`-Array zurück. Jede Serie hat eine `id`, den Metrik-`name`, ihre `tags`,
das `field`, das sie repräsentiert, `min` und `max` über den Bereich sowie ein
`data`-Array von Punkten. Jeder Punkt hat einen `timestamp` und einen numerischen
`value`.
## Eine Liste abfragen
Dieser Endpunkt gibt aggregierte Metrikwerte gruppiert in Zeilen zurück. Verwenden
Sie ihn, um Tabellen zu erstellen.
```shell Endpoint theme={null}
POST /api/v2/metrics/list
```
### Request-Body
| Feld | Typ | Erforderlich | Beschreibung |
| ------------ | ----------------- | ------------ | -------------------------------------------------- |
| `site_id` | string | Ja | Abzufragende Site. |
| `from` | string (ISO 8601) | Ja | Start des Zeitbereichs (inklusive). |
| `to` | string (ISO 8601) | Ja | Ende des Zeitbereichs (inklusive). |
| `select` | ListSelector\[] | Ja | Welche Metriken, Felder und Tags abgerufen werden. |
| `group_by` | GroupBy\[] | Ja | Wie Zeilen gruppiert werden. |
| `resolution` | Resolution | Nein | Intervall für die Aggregation. |
| `limit` | number | Nein | Maximale Anzahl zurückzugebender Zeilen. |
Ein `ListSelector` ist wie ein Timeseries-Selector mit einer zusätzlichen `id`,
die den Wert des Selectors im `data`-Objekt jeder Zeile benennt. `group_by`-Einträge
sind `Name` (nach Metrikname gruppieren) oder `Tag` (nach Tag-Wert gruppieren).
```json body.json theme={null}
{
"site_id": "YOUR-SITE-ID",
"from": "2026-06-22T00:00:00Z",
"to": "2026-06-22T01:00:00Z",
"resolution": "HOURLY",
"select": [
{
"id": "mean",
"name": "transaction_duration",
"tags": { "namespace": "*" },
"field": "mean",
"aggregation": "avg"
}
],
"group_by": ["Name"],
"limit": 50
}
```
### Antwort
Gibt eine `List` mit der abgefragten `resolution`, `from`, `to` und einem
`rows`-Array zurück. Jede Zeile hat eine `id`, ein `group`-Objekt mit den
Tag-Werten, die sie definieren, und ein `data`-Objekt mit aggregierten Werten,
indiziert nach Selector-`id` (zum Beispiel `{ "mean": 42.5 }`).
## Metriknamen auflisten
Gibt jeden für eine Site verfügbaren Metriknamen zurück.
```shell Endpoint theme={null}
GET /api/v2/metrics/names/{site_id}
```
Gibt ein Array von Strings zurück.
## Typ und Tags einer Metrik abrufen
Gibt den Typ einer Metrik und die Tag-Kombinationen zurück, mit denen sie abgefragt
werden kann.
```shell Endpoint theme={null}
GET /api/v2/metrics/type_and_tags/{site_id}/{metric_name}
```
Gibt einen `metric_type` (`gauge`, `counter` oder `measurement`) und
`available_tags` zurück, ein Array, dessen Einträge jeweils eine gültige
Kombination von Tag-Schlüsseln sind.
## Referenz
### Felder
Das `field` wählt aus, welche Messung aus einer Metrik abgerufen wird:
| Wert | Beschreibung |
| -------------- | ------------------------------------------------------------------------------------------------------------ |
| `gauge` | Der Wert der Metrik zu einem einzelnen Zeitpunkt, etwa aktuelle CPU- oder Speichernutzung. |
| `counter` | Aus `counter`-Metriken der kumulierte Wert, der mit der Zeit nur steigt, etwa die Anzahl bedienter Anfragen. |
| `mean` | Der Mittelwert der im Zeitfenster aufgezeichneten Werte, etwa die durchschnittliche Antwortzeit. |
| `count` | Aus `measurement`-Metriken: wie viele Werte im Zeitfenster aufgezeichnet wurden. |
| `min` | Der niedrigste im Zeitfenster aufgezeichnete Wert. |
| `max` | Der höchste im Zeitfenster aufgezeichnete Wert. |
| `p_90`, `p_95` | Perzentilwerte. |
Weitere Typreferenzen finden Sie in der [AppSignal V2 API-Dokumentation](https://appsignal.com/api/v2/docs).
### Aggregationen
Die `aggregation` kombiniert mehrere Werte innerhalb eines Zeitfensters: `sum`,
`avg`, `min`, `max`, `first` oder `last`.
### Auflösungen
`resolution` akzeptiert `MINUTELY`, `FIVE_MINUTELY`, `TEN_MINUTELY`,
`FIFTEEN_MINUTELY`, `HOURLY` oder `DAILY`.