Berichte

Jedes Team bekommt einen Monatsbericht: eine E-Mail am 1. jedes Monats und denselben Bericht als PDF, bereit zum Weiterleiten an einen Kunden. Außerdem hat jeder Monitor einen eigenen PDF-Bericht für einen Zeitraum von 7 Tagen bis 12 Monaten.

Der Monatsbericht

Der Bericht deckt den vorigen Kalendermonat für alle Monitore des Teams ab:

• Zusammenfassung: Verfügbarkeit, bestätigte Vorfälle und empfohlene Maßnahmen, dazu was sich geändert hat und warum es zählt.
• Dienste: Verfügbarkeit, Ausfallzeit, Median und 95. Perzentil der Antwortzeit, Ablauf von Zertifikat und Domain sowie der Zustand jedes Monitors am Monatsende, dazu die mittlere Antwortzeit der letzten vier Monate.
• Qualitätssignale: die letzten Lighthouse-Werte, Core Web Vitals, Sicherheits-Header, IP-Blacklists, defekte Links und DNS-Änderungen, sofern diese Checks eingerichtet sind.
• Geplante Jobs und Server-Agenten mit ihren verpassten Läufen.
• Vorfälle: der längste als Zeitleiste (erkannt, benachrichtigt, erstes Update, behoben) und eine Liste aller Vorfälle. Eine KI-Vorfallsanalyse, die du für einen Vorfall erstellt hast, wird mit ihrem Datum zitiert.
• Empfohlene Maßnahmen: Jede folgt aus einer Messung im Bericht, etwa einem Zertifikat, das in den nächsten 30 Tagen abläuft, oder einem fehlerhaften Check. Der Bericht sagt, was zu prüfen ist, nicht wer es tun soll.
• Umfang & Methodik: der Berichtszeitraum und wie jede Zahl gemessen wird.

Jede Zahl stammt aus den gespeicherten Ergebnissen deiner Checks. Verfügbarkeit ist der Anteil erfolgreicher Prüfungen, geplante Wartungsfenster zählen nicht mit. Ausfallzeit ist die Gesamtdauer der Vorfälle, die im Monat begonnen haben; ein noch offener zählt bis zum Monatsende. Antwortzeiten stammen nur aus erfolgreichen Prüfungen. Monitore erscheinen mit ihrem Hostnamen, nie mit der vollständigen URL.

PDF herunterladen

1. Gehe zu Einstellungen → Team → E-Mail-Versand, Abschnitt Monatsbericht.
2. Wähle unter PDF-Bericht einen Monat: den letzten, einen der zwölf davor oder den laufenden Monat bis heute.
3. Klicke auf PDF herunterladen.

Jedes Teammitglied kann es herunterladen; die E-Mail-Einstellungen ändern nur Admins. Dasselbe PDF hängt an der monatlichen E-Mail.

Branding

Das PDF trägt das Branding deines Teams: sein Logo, seine Farben (der dunkle Ton und die Akzentfarbe werden aus deiner Primärfarbe abgeleitet) und seinen Namen. Wird dein Team von einem Reseller verwaltet, trägt der Bericht das Branding des Resellers und nichts von Hoppla. Ist kein Logo gesetzt, steht dort der Name.

KI-Zusammenfassung

Ab Starter kannst du die drei Texte der Zusammenfassung im PDF (Überblick, was sich geändert hat, warum es zählt) mit KI-Unterstützung formulieren lassen. Schalte dazu KI-Zusammenfassung im PDF in den Einstellungen des Monatsberichts ein.

• Die KI schreibt nur Text. Sie bekommt die Zahlen des Berichts und soll sie beschreiben, ohne eine Zahl zu nennen. Jeder Text wird geprüft; enthält er eine Ziffer, ein Zahlwort, eine Prozentangabe, einen Link oder eine Formatierung, wird er verworfen und durch den Standardsatz ersetzt. Die Zahlen im PDF stammen immer aus deinen Monitoring-Daten.
• Das PDF kennzeichnet die Zusammenfassung als mit KI-Unterstützung formuliert.
• Sie wird im heruntergeladenen Bericht und in der automatischen Monats-E-Mail verwendet.
• Wie viele KI-Zusammenfassungen du pro Monat bekommst, hängt von deinem Tarif ab (Starter 2, Pro 10). Lädst du denselben Bericht erneut herunter, zählt das nicht noch einmal. Ist das Monatskontingent aufgebraucht, verwendet das PDF die Standardsätze.

Für eine Zusammenfassung werden der Teamname, die Namen der Monitore und Jobs, Hostnamen (ohne Pfade), die Zahlen des Berichts sowie Titel und Dauer von Vorfällen mit einer pseudonymen Teamkennung übermittelt. Die Daten gehen an OpenRouter, das sie an einen Modellanbieter weiterleitet. Texte von Vorfall-Updates und deine gespeicherten KI-Vorfallsanalysen werden nicht übermittelt.

Das PDF pro Monitor

Öffne einen Monitor und wähle Bericht herunterladen, um sein PDF für 7 Tage, 30 Tage, 90 Tage oder 12 Monate zu erhalten. Es hat dasselbe Layout, beschränkt auf diesen Monitor, und zusätzlich eine Tabelle Tag für Tag (bei 12 Monaten Monat für Monat) mit Verfügbarkeit und mittlerer Antwortzeit.

API

Bericht	Endpunkt
Monatsbericht deines Teams	GET /api/v1/reports/monthly/pdf?month=YYYY-MM
Monatsbericht eines verwalteten Teams (Reseller)	GET /api/v1/reseller/managed-teams/{id}/reports/monthly/pdf?month=YYYY-MM
Monitor-Bericht	GET /api/v1/monitors/{id}/report/pdf?period=7d|30d|90d|12m

month ist standardmäßig der vorige Monat. Die Endpunkte brauchen den Scope monitors:read und antworten mit 503 und einem Retry-After-Header, wenn das PDF gerade nicht erstellt werden kann.