Metriken abfragen

Lesen Sie Metrikdaten mit der Public API (V2). 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.

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), eine optionale aggregation (siehe Aggregationen) und draw_null_as_zero (wenn true, werden fehlende Punkte mit 0 aufgefüllt) entgegen.

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

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).

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

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.

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.

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.

AppSignal API

MCP-Server

AppSignal CLI

Eine Zeitreihe abfragen

Request-Body

Antwort

Eine Liste abfragen

Request-Body

Antwort

Metriknamen auflisten

Typ und Tags einer Metrik abrufen

Referenz

Felder

Aggregationen

Auflösungen

​Eine Zeitreihe abfragen

​Request-Body

​Antwort

​Eine Liste abfragen

​Request-Body

​Antwort

​Metriknamen auflisten

​Typ und Tags einer Metrik abrufen

​Referenz

​Felder

​Aggregationen

​Auflösungen

Eine Zeitreihe abfragen

Request-Body

Antwort

Eine Liste abfragen

Request-Body

Antwort

Metriknamen auflisten

Typ und Tags einer Metrik abrufen

Referenz

Felder

Aggregationen

Auflösungen