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.

Für diese Metriken messen wir nichts selbst. Deine eigene Überwachung schickt uns Werte, wir zeichnen sie. Damit weißt du jederzeit, woher eine Zahl auf deiner Statusseite stammt. Soll Statuswerk eine URL selbst prüfen, ist das Monitoring — dessen Antwortzeiten erscheinen im selben Bereich der Statusseite.

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.

Optional legst du die Achse fest (Achse ab / Achse bis, über die API y_axis_min / y_axis_max), etwa 0 bis 100 für Prozentwerte. Ohne Angabe zoomt das Diagramm auf die gemessenen Werte; kleine Schwankungen sehen dann groß aus. Werte außerhalb der Achse zeigen wir trotzdem, die Achse wird dann breiter.

So liest es sich auf der Seite: Einheit (suffix, z. B. ms oder %) steht hinter jedem Wert, Nachkommastellen (decimals) legt die Stellen fest. Sichtbar (visible) aus hält eine Metrik von der Statusseite fern, während du weiter Werte sendest — etwa um erst ihren Verlauf zu füllen. Position (position) bestimmt die Reihenfolge; kleinere Zahlen stehen vorn.

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.

Wechselst du in einen Tarif ohne Metriken, bleiben sie mit ihren Daten erhalten, sind aber nicht mehr auf der Seite zu sehen und nehmen keine neuen Werte an (403). Nach einem Upgrade geht es weiter.