Naar hoofdinhoud gaan
Lees metricgegevens met de Public API (V2). Haal een timeseries op voor grafieken, een geaggregeerde lijst voor tabellen of ontdek welke metrics en tags een site heeft. Alle eindpunten authenticeren met uw persoonlijke API-token en zijn beperkt tot één site_id.

​
Een timeseries opvragen

Dit eindpunt retourneert een of meer reeksen datapunten over een tijdsbereik. Gebruik het om grafieken te tekenen. 
POST /api/v2/metrics/timeseries

​
Request body

VeldTypeVereistBeschrijving
site_idstringJaSite om op te vragen.
fromstring (ISO 8601)JaStartpunt van het tijdsbereik (inclusief).
tostring (ISO 8601)JaEindpunt van het tijdsbereik (inclusief).
selectTimeseriesSelector[]JaWelke metrics, velden en tags moeten worden opgehaald.
resolutionResolutionNeeInterval tussen datapunten. Automatisch gekozen wanneer weggelaten.
limitnumberNeeMaximum aantal reeksen om te retourneren.
Elke select-entry neemt een metric-name, een tags-object om op te filteren (waarden mogen * als wildcard gebruiken), een field (zie velden), een optionele aggregation (zie aggregaties) en draw_null_as_zero (wanneer true worden ontbrekende punten gevuld met 0). 
{
  "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
}

​
Response

Retourneert een Timeseries met de opgevraagde resolution, from, to en een series-array. Elke reeks heeft een id, de metric-name, zijn tags, het field dat hij vertegenwoordigt, min en max over het bereik, en een data-array van punten. Elk punt heeft een timestamp en een numerieke value.

​
Een lijst opvragen

Dit eindpunt retourneert geaggregeerde metric-waarden gegroepeerd in rijen. Gebruik het om tabellen te bouwen. 
POST /api/v2/metrics/list

​
Request body

VeldTypeVereistBeschrijving
site_idstringJaSite om op te vragen.
fromstring (ISO 8601)JaStartpunt van het tijdsbereik (inclusief).
tostring (ISO 8601)JaEindpunt van het tijdsbereik (inclusief).
selectListSelector[]JaWelke metrics, velden en tags moeten worden opgehaald.
group_byGroupBy[]JaHoe rijen te groeperen.
resolutionResolutionNeeInterval gebruikt voor aggregatie.
limitnumberNeeMaximum aantal rijen om te retourneren.
Een ListSelector is als een timeseries-selector, met een extra id die de waarde van de selector benoemt in het data-object van elke rij. group_by-entries zijn Name (groeperen op metricnaam) of Tag (groeperen op een tag-waarde). 
{
  "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
}

​
Response

Retourneert een List met de opgevraagde resolution, from, to en een rows-array. Elke rij heeft een id, een group-object van de tag-waarden die hem definiëren, en een data-object van geaggregeerde waarden, gerangschikt op selector-id (bijvoorbeeld { "mean": 42.5 }).

​
Metric-namen opsommen

Retourneert elke metric-naam die beschikbaar is voor een site. 
GET /api/v2/metrics/names/{site_id}
Retourneert een array van strings.

​
Type en tags van een metric ophalen

Retourneert het type van een metric en de tagcombinaties waarmee deze kan worden opgevraagd. 
GET /api/v2/metrics/type_and_tags/{site_id}/{metric_name}
Retourneert een metric_type (gauge, counter of measurement) en available_tags, een array waarbij elke entry één geldige combinatie van tag-sleutels is.

​
Referentie

​
Velden

Het field selecteert welke meting moet worden opgehaald uit een metric:
WaardeBeschrijving
gaugeDe waarde van de metric op één moment, zoals huidig CPU- of geheugengebruik.
counterUit counter-metrics, de cumulatieve waarde, die alleen toeneemt in de tijd, zoals het aantal bediende verzoeken.
meanHet gemiddelde van de waarden vastgelegd in het tijdsbucket, zoals de gemiddelde responstijd.
countUit measurement-metrics, hoeveel waarden zijn vastgelegd tijdens het tijdsbucket.
minDe laagste waarde vastgelegd in het tijdsbucket.
maxDe hoogste waarde vastgelegd in het tijdsbucket.
p_90, p_95Percentielwaarden.
Voor meer typereferenties, lees de AppSignal V2 API-documentatie.

​
Aggregaties

De aggregation combineert meerdere waarden binnen een tijdsbucket: sum, avg, min, max, first of last.

​
Resoluties

resolution accepteert MINUTELY, FIVE_MINUTELY, TEN_MINUTELY, FIFTEEN_MINUTELY, HOURLY of DAILY.