Zum Hauptinhalt springen
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

FeldTypErforderlichBeschreibung
site_idstringJaAbzufragende Site.
fromstring (ISO 8601)JaStart des Zeitbereichs (inklusive).
tostring (ISO 8601)JaEnde des Zeitbereichs (inklusive).
selectTimeseriesSelector[]JaWelche Metriken, Felder und Tags abgerufen werden.
resolutionResolutionNeinIntervall zwischen Datenpunkten. Wird bei Weglassen automatisch gewählt.
limitnumberNeinMaximale 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

FeldTypErforderlichBeschreibung
site_idstringJaAbzufragende Site.
fromstring (ISO 8601)JaStart des Zeitbereichs (inklusive).
tostring (ISO 8601)JaEnde des Zeitbereichs (inklusive).
selectListSelector[]JaWelche Metriken, Felder und Tags abgerufen werden.
group_byGroupBy[]JaWie Zeilen gruppiert werden.
resolutionResolutionNeinIntervall für die Aggregation.
limitnumberNeinMaximale 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:
WertBeschreibung
gaugeDer Wert der Metrik zu einem einzelnen Zeitpunkt, etwa aktuelle CPU- oder Speichernutzung.
counterAus counter-Metriken der kumulierte Wert, der mit der Zeit nur steigt, etwa die Anzahl bedienter Anfragen.
meanDer Mittelwert der im Zeitfenster aufgezeichneten Werte, etwa die durchschnittliche Antwortzeit.
countAus measurement-Metriken: wie viele Werte im Zeitfenster aufgezeichnet wurden.
minDer niedrigste im Zeitfenster aufgezeichnete Wert.
maxDer höchste im Zeitfenster aufgezeichnete Wert.
p_90, p_95Perzentilwerte.
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.