Systemmetriken

Neben dem Status Deiner Komponenten kannst Du eigene Messwerte auf der Statusseite zeigen — Antwortzeiten, Durchsatz, Warteschlangenlänge, was immer für Deine Kunden relevant ist.

Wir messen dabei nichts selbst. Deine eigene Überwachung schickt uns Werte, wir zeichnen sie. Damit weißt Du jederzeit, woher eine Zahl auf Deiner Statusseite stammt.

Metrik anlegen

Unter Dashboard → Statusseiten → Systemmetriken → Anlegen. Wichtig sind zwei Felder:

• Key — der Name, gegen den Du später sendest, z. B. api_response_time. Er steht in der API-URL. Änderst Du ihn später, hört alles auf zu funktionieren, was bereits sendet.
• Aggregation — wie Werte für längere Zeiträume zusammengefasst werden. Antwortzeiten bildest Du als Durchschnitt ab, Zähler wie „Anfragen pro Minute" als Summe. Falsch gewählt wird das Monatsdiagramm unbrauchbar.

Werte senden

Einen einzelnen Wert:

curl -X POST https://statuswerk.eu/api/v1/metrics/api_response_time/points \
  -H "Authorization: Bearer $STATUSWERK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"value": 128.4}'

Ohne Zeitstempel gilt der Wert als „jetzt". Mehrere Werte auf einmal — bis zu 5.000 pro Aufruf:

curl -X POST https://statuswerk.eu/api/v1/metrics/api_response_time/points \
  -H "Authorization: Bearer $STATUSWERK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "points": [
          {"value": 128.4, "timestamp": "2026-09-07T12:00:00Z"},
          {"value": 131.9, "timestamp": "2026-09-07T12:01:00Z"}
        ]
      }'

Die Antwort ist 202 Accepted.

Wie oft senden?

Mindestens alle fünf Minuten, sonst entsteht eine sichtbare Lücke in der Tagesansicht. Einmal pro Minute ist der übliche Rhythmus.

Werte werden auf 60-Sekunden-Intervalle gerundet. Schickst Du innerhalb einer Minute mehrere Werte, gewinnt der letzte.

Wiederholungen sind ungefährlich

Derselbe Aufruf zweimal erzeugt keine doppelten Daten — jeder Wert landet in seinem Zeitfenster und überschreibt es. Du kannst den Aufruf also ohne Absicherung in einen Cronjob legen und bei Fehlern einfach erneut versuchen.

Ein Beispiel für einen Cronjob, der jede Minute läuft:

* * * * * /usr/local/bin/push-latency.sh || true

Historie nachtragen

Beim Umzug von einem anderen Anbieter kannst Du Werte bis zu 28 Tage rückwirkend nachtragen — schicke sie einfach mit dem passenden timestamp. Sonst startet Deine Statusseite mit leeren Diagrammen.

Zeitstempel in der Zukunft werden abgelehnt.

Wie lange wir Daten aufbewahren

Ältere Werte werden automatisch verdichtet, nicht verworfen. In den verdichteten Stufen bleiben Minimum und Maximum erhalten — Ausreißer verschwinden also nicht im Durchschnitt.

Wenn nichts mehr ankommt

Kommt längere Zeit kein Wert, zeigt die Statusseite „Keine aktuellen Daten" statt der letzten bekannten Zahl. Ein veralteter Wert, der aussieht wie ein aktueller, wäre auf einer Statusseite das Schlimmste.

Weitere Endpunkte

GET    /api/v1/metrics                    Metriken auflisten
POST   /api/v1/metrics                    Metrik anlegen
GET    /api/v1/metrics/{key}
PATCH  /api/v1/metrics/{key}
DELETE /api/v1/metrics/{key}              löscht auch alle Werte
GET    /api/v1/metrics/{key}/points       Werte zurücklesen

Beim Zurücklesen kannst Du from, to und resolution (60, 300 oder 3600) angeben.

Tarife

Die Anzahl der Metriken hängt vom Tarif ab: Starter 2, Basic 5, Pro 15, Business 50.