SLA-Reports¶

Vorschau-Funktion

SLA-Reports (Teil von Reports) sind standardmäßig ausgeschaltet — Menüpunkt, Seite und API sind gesperrt, bis ein Super-Admin den Bereich unter Admin → System → Vorschau-Funktionen freischaltet. Der Bereich ist noch nicht stabil.

Wie viel war ein Check in einem Zeitraum verfügbar? /reports (Standard-Reiter SLA).

Definition¶

Verfügbarkeit (%) = OK-Zeit ÷ überwachte Zeit × 100

Was zählt als verfügbar: ausschließlich Zeit mit Status OK.

Was zählt als Ausfall:

WARNING- und CRITICAL-Zeit (beides gleich gewertet — es gibt keine Option, WARNING aus der Rechnung rauszunehmen)
NO_DATA-Zeit (Agent/Collector offline) — immer als Ausfall gerechnet

Was komplett aus der Rechnung fällt (weder Ausfall noch Verfügbarkeit):

Zeit innerhalb einer aktiven, geplanten Downtime — das ist fix so und nicht umschaltbar
ACK-Phasen zählen weiterhin als Ausfall — ACK ist nur eine Notification-Pause, kein „die Welt war OK"

Ansicht¶

/reports → SLA:

Element	Bedeutung
Zeitraum	Tage-Slider oder eigenes Start/Ende
Tenant-Auswahl	Mehrfachauswahl (Super-Admin: tenantübergreifend; sonst automatisch auf den eigenen Scope begrenzt)
SLA-Ziel	frei einstellbarer Vergleichswert (Default 99,9 %) — rein visuell, wird nicht gespeichert oder validiert
Ausschlüsse	einzelne Hosts/Checks lassen sich clientseitig aus der Ansicht nehmen, z. B. für eine Stichprobe

Output: Tabelle mit Verfügbarkeit pro Zeile, aufklappbar bis auf Host-Ebene.

Beispiel-Output¶

Tenant Acme — April 2026
─────────────────────────────────────────────────────────────────
Service                       Verfügbar   Downtime
api.acme.com / HTTP             99.92%     00:32h
api.acme.com / TLS-Cert        100.00%     -
db01.acme.local / Postgres     100.00%     -
sw-core / IF Gi1/0/1            99.45%     03:58h
sw-core / IF Gi1/0/2           100.00%     -
─────────────────────────────────────────────────────────────────
Tenant gesamt                   99.83%     04:30h

Berechnungsmethodik¶

flowchart LR
    CR[check_results] --> RATIO[OK-Anteil je Check]
    DT[aktive Downtimes] --> EXCL[Zeit ausschließen]
    SH[state_history] --> ND[NO_DATA-Sekunden]
    RATIO --> CALC[Verfügbarkeit %]
    EXCL --> CALC
    ND --> CALC

Endpunkte¶

Endpunkt	Scope
`GET /api/v1/services/{service_id}/sla`	ein einzelner Check, normaler Tenant-Zugriff
`GET /api/v1/tenants/{tenant_id}/sla-report`	alle Checks eines Tenants, normaler Tenant-Zugriff
`GET /api/v1/sla-report`	tenantübergreifend, nur Super-Admin

Zeitraum per start/end-Parameter, Default die letzten 30 Tage.

Export¶

Format	Wofür
Ansicht im Browser	interaktiv, mit Ausschlüssen
CSV	wird clientseitig aus der geladenen Ansicht erzeugt (UTF-8 mit BOM, Excel-tauglich)
PDF	separater Weg über PDF-Reports mit `report_type: sla`

Es gibt keinen eigenen Server-Export-Endpunkt für die SLA-Ansicht — CSV entsteht direkt im Browser aus den bereits geladenen Zahlen.

Geplante SLA-PDFs¶

Ein monatlicher PDF-Report pro Tenant lässt sich unter PDF-Reports mit report_type: sla planen — automatisch generiert und per Mail verschickt.

Mehrere SLA-Ziele¶

Wenn unterschiedliche Checks unterschiedliche Erwartungen haben („API: 99,9 %, Wiki: 99,0 %"), arbeite mit Tags und filtere die Ansicht pro Tag getrennt — das SLA-Ziel-Feld dient dabei nur als visueller Vergleichswert.

Anschluss¶

PDF-Reports — Versand-Workflow für SLA als PDF
Downtimes — wie Wartungen aus der Rechnung fallen