Zum Inhalt

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, Reiter SLA-Berichte (Standard-Reiter).

Definition

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

Gerechnet wird über die Zeit, nicht über gespeicherte Messpunkte: jeder Status zählt so lange, wie er galt. Eine Minute CRITICAL in einer ruhigen Stunde wiegt also eine Minute.

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

Was zählt als Ausfall:

  • WARNING-, CRITICAL- und UNKNOWN-Zeit (gleich gewertet — es gibt keine Option, WARNING aus der Rechnung zu nehmen)
  • NO_DATA-Zeit (Agent/Collector offline, Check überfällig) — immer als Ausfall gerechnet, auch innerhalb einer Wartung

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

  • Zeit innerhalb einer geplanten Downtime, minutengenau und nur für die Checks, die die Downtime betrifft (Check, Gerät oder ganzer Tenant) — nicht umschaltbar

ACK-Phasen zählen weiterhin als Ausfall — ACK pausiert nur Benachrichtigungen, die Welt war deshalb nicht OK.

Ansicht

/reports → SLA-Berichte:

Element Bedeutung
Zeitraum 7, 30 (Vorgabe) oder 90 Tage oder Benutzerdefiniert (Von/Bis)
Tenant-Auswahl nur für Super-Admins (Mehrfachauswahl, tenantübergreifend); alle anderen sehen ihren Tenant
SLA-Ziel Vergleichswert 99 / 99,5 / 99,9 (Vorgabe) / 99,99 % — rein visuell: grün ab Ziel, gelb bis 0,5 Punkte darunter, sonst rot; wird nicht gespeichert
Ausschlüsse einzelne Hosts/Checks lassen sich aus der Ansicht nehmen (Filter-Chips), z. B. für eine Stichprobe

Ausgabe: Tabelle mit Verfügbarkeit pro Zeile, aufklappbar Tenant → Host → Check. Der Wert „Tenant gesamt" ist der ungewichtete Mittelwert der Check-Werte.

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

Berechnung

flowchart LR
    CR[Check-Ergebnisse] --> RATIO[OK-Zeit je Check]
    DT[Downtimes] --> EXCL[Zeit ausschließen]
    SH[Status-Verlauf] --> ND[NO_DATA-Zeit]
    RATIO --> CALC[Verfügbarkeit %]
    EXCL --> CALC
    ND --> CALC

Der Bericht über viele Tenants wird in Blöcken gerechnet und bleibt auch bei großen Beständen bedienbar.

Endpunkte

Endpunkt Scope
GET /api/v1/sla/services/{service_id}/sla ein einzelner Check (Recht reports.view)
GET /api/v1/sla/tenants/{tenant_id}/sla-report alle Checks eines Tenants (Recht reports.view)
GET /api/v1/sla/sla-report tenantübergreifend, nur Super-Admin

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

Export

Format Wofür
Ansicht im Browser interaktiv, mit Ausschlüssen
CSV („CSV exportieren") wird im Browser aus der geladenen Ansicht erzeugt (UTF-8 mit BOM, Excel-tauglich); Namen, die mit =, +, -, @ oder einem Tabulator beginnen, werden so geschrieben, dass Excel/LibreOffice keine Formel daraus machen

Einen eigenen Server-Export-Endpunkt für die Ansicht gibt es nicht.

SLA als PDF

Der PDF-Berichtstyp sla existiert, ist aber nur über die API wählbar — die Oberfläche der PDF-Reports bietet Executive und Technisch an (der technische Bericht enthält eine SLA-Tabelle).

Mehrere SLA-Ziele

Wenn unterschiedliche Checks unterschiedliche Erwartungen haben („API: 99,9 %, Wiki: 99,0 %"), nimm die übrigen Checks über die Ausschlüsse aus der Ansicht und stelle das passende Ziel ein — das SLA-Ziel dient nur als visueller Vergleichswert.

Anschluss