SLA | Output.Rocks Documentation

Die SLA-Ansicht zeigt eine kompakte Service-Level-Auswertung für den aktuellen Mandantenkontext. Sie fasst die API- und SPA-Verfügbarkeit sowie die wichtigsten Rendering-Mengen für die letzten zwei Monate und den laufenden Monat zusammen.

Sie finden die Ansicht im App-Backend unter Berichte → SLA. Direkt aufrufbar ist sie über /reports/sla.

Die Seite ist eine Live-Zusammenfassung. Es wird kein separater Bericht erzeugt und keine PDF-Datei bereitgestellt.

Zugriff

Für die SLA-Ansicht ist die Berechtigung Template Editor erforderlich. Die angezeigten Daten folgen dem angemeldeten Kontext:

Mandant des angemeldeten Benutzers
optionaler Umgebungs-Mandant, falls der Benutzer in einem solchen Kontext arbeitet

Ohne Umgebungs-Mandant werden die mandantenweiten Statistikwerte ohne Submandantenbezug verwendet.

Zeitraum

Die Ansicht zeigt immer drei Monatszeilen:

den vorletzten abgeschlossenen Monat
den letzten abgeschlossenen Monat
den aktuellen Monat bis zum Zeitpunkt der Abfrage

Für abgeschlossene Monate endet der Zeitraum am letzten Tag des Monats um 23:59:59. Für den laufenden Monat endet er beim aktuellen Stand der Auswertung. Die Zeitzone wird aus den Mandanten-Einstellungen gelesen; falls keine Zeitzone ermittelt werden kann, wird Europe/Berlin verwendet.

Kopfbereich

Im Kopfbereich sehen Sie den Titel SLA, den Hinweis auf den Auswertungszeitraum und die Aktion Aktualisieren.

SLA

Service-Level-Auswertung für die letzten zwei Monate und den aktuellen Monat

Aktualisieren

Lädt die SLA-Zusammenfassung erneut vom Server. Währenddessen zeigt die Schaltfläche einen Ladezustand.

Stand

Nach erfolgreichem Laden zeigt die Seite den Zeitstempel der Auswertung. Dieser Zeitstempel entspricht dem Feld generatedAt der API-Antwort.

Monatskacheln

Für jeden Monat zeigt die Seite eine Kachel mit fünf Kennzahlen.

Kennzahl	Bedeutung	Datenbasis
API-Verfügbarkeit	Durchschnittliche Erfolgsquote der API-Canary-Messung im Auswertungszeitraum.	CloudWatch Synthetics `SuccessPercent`
SPA-Verfügbarkeit	Durchschnittliche Erfolgsquote der SPA-Canary-Messung im Auswertungszeitraum.	CloudWatch Synthetics `SuccessPercent`
Empfangene Requests	Anzahl der eingegangenen Rendering-Requests.	Stündliche Rendering-Request-Statistik `amount`
Gerenderte Dokumente	Anzahl der erzeugten Dokumente.	Monatsstatistik `document_amounts`, sonst stündliche Statistik `docs_amount`
Generierte E-Mails	Anzahl der erzeugten E-Mails.	Monatsstatistik `email_amounts`, sonst stündliche Statistik `emails_amount`

Verfügbarkeitswerte werden ab dem 1. Juni 2026 ausgewertet. Für frühere Zeiträume, fehlende Canary-Daten oder nicht konfigurierte Canary-Messungen zeigt die Ansicht "Keine Daten verfügbar" beziehungsweise "Nicht verfügbar".

Diagramme

Unter den Monatskacheln stehen zwei Balkendiagramme:

Verfügbarkeit vergleicht API-Verfügbarkeit und SPA-Verfügbarkeit je Monat in Prozent.
Mengen pro Monat vergleicht empfangene Requests, gerenderte Dokumente und generierte E-Mails.

Wenn keine Werte vorhanden sind, zeigt die jeweilige Diagrammfläche einen leeren Zustand. Bei Verfügbarkeiten kann das beispielsweise auftreten, wenn alle ausgewählten Monate vor dem Start der SLA-Canary-Messungen liegen oder CloudWatch keine Messwerte liefert.

Fehler- und Leerzustände

Zustand	Anzeige	Bedeutung
Laden	Spinner in der Inhaltsfläche	Die SLA-Zusammenfassung wird geladen.
Aktualisieren	Ladezustand auf der Schaltfläche	Die bestehenden Werte bleiben sichtbar, während neue Werte abgefragt werden.
Keine Monatsdaten	"Keine Daten verfügbar"	Die API hat keine Monatszeilen geliefert.
Fehler	Rote Fehlermeldung und Toast	Die API-Anfrage ist fehlgeschlagen oder der Benutzer hat keinen Zugriff.

Technische Grundlage

Die Frontend-Seite /reports/sla ruft GET /api/spa/sla-report/summary auf. Die Antwort enthält den Auswertungsstand, den Mandantenscope und die drei Monatszeilen.

{
  "generatedAt": "2026-06-07T10:30:00+02:00",
  "scope": {
    "clientId": 12,
    "subClientId": 3
  },
  "months": [
    {
      "key": "2026-06",
      "from": "2026-06-01T00:00:00+02:00",
      "to": "2026-06-07T10:30:00+02:00",
      "availability": {
        "apiPercent": 99.95,
        "spaPercent": 99.91
      },
      "requests": {
        "received": 1247
      },
      "documents": {
        "rendered": 1219
      },
      "emails": {
        "generated": 834
      }
    }
  ]
}

Die Verfügbarkeitswerte werden als Prozentwerte mit zwei Nachkommastellen angezeigt. Mengenwerte werden als ganze Zahlen lokal formatiert.