Health Check — Benutzerhandbuch | YoBench

Was das Modul „Health Check" leistet

Das Modul überwacht kontinuierlich die Verfügbarkeit Ihrer Websites und APIs über HTTP. Sie müssen keinen UptimeRobot-Tab offen halten oder einen externen Monitoring-Dienst bezahlen — YoBench fragt die konfigurierten URLs in einem festgelegten Intervall ab, erfasst die Antwortzeit, berechnet die Uptime und sendet eine Benachrichtigung, sobald eine Seite nicht mehr antwortet.

Anders als der Sicherheits-Scanner (der Konfiguration prüft: SSL, Header, Ports) beantwortet Health Check eine einzige Frage: „Ist diese Seite gerade erreichbar?" — aber regelmäßig, über Jahre hinweg, mit voller Historie.

Was Sie bekommen:

• Lokales Uptime-Monitoring — Daten liegen in der verschlüsselten Datenbank auf Ihrem Computer, ohne Abhängigkeit von externen SaaS-Diensten.
• Antwortzeit — letzter Wert plus Durchschnitt über den Speicherzeitraum der Logs (Standard: 7 Tage).
• Uptime % über 7 Tage — aus den Logs jeder Prüfung berechnet.
• Benachrichtigungen nur bei Statuswechsel — beim Übergang „erreichbar → nicht erreichbar" oder Timeout, kein Spam bei jedem erfolgreichen Aufruf.
• Proxy- und Timeout-Unterstützung — für Ressourcen in privaten Netzen oder langsamen Backends.

Monitoring-Parameter

Beim Anlegen einer Prüfung geben Sie an:

• Name — beliebige Bezeichnung (in der Liste sichtbar).
• URL — die abzufragende Adresse. Das Modul nutzt HTTP GET; andere Methoden werden derzeit nicht unterstützt.
• Beschreibung (optional) — Notiz für sich selbst oder das Team.
• Timeout — maximale Wartezeit in Millisekunden. Erlaubt 500–60.000 ms, Standard 5.000.
• Proxy (optional) — Proxy-Profil aus den Einstellungen wählen; alle Anfragen dieser Prüfung laufen darüber.
• Aktiviert — Aktivitäts-Flag. Häkchen entfernen, um eine Prüfung zu pausieren, ohne sie zu löschen.

Was als Erfolg zählt. Eine Prüfung gilt als erfolgreich, wenn der HTTP-Statuscode < 500 ist. Alles von 200 bis 499 ist success. Ein Netzwerkfehler ergibt error. Eine Überschreitung des Timeouts ist timeout.

Request-Header. Alle Anfragen verwenden den festen User-Agent: AutomationsDesk/1.0 HealthCheck.

SSL. Zertifikate werden auf die übliche Weise validiert; ein UI-Schalter zum Deaktivieren der SSL-Validierung existiert nicht.

Globale Modul-Einstellungen

Konfiguriert unter Einstellungen → Health Check:

• Automatische Prüfungen aktivieren — Hauptschalter für den Scheduler. Standardmäßig aus — solange Sie es nicht einschalten, laufen Prüfungen nur auf Anforderung.
• Prüfintervall (Minuten) — wie oft der Scheduler jede aktivierte URL abfragt. Wert von 1 bis 1440 (1 Minute bis 24 Stunden); Standard 5 Minuten. Das Intervall gilt modulweit; ein Intervall pro Prüfung ist nicht konfigurierbar.
• Speicherzeit der Logs (Tage) — wie lange die Historie in der Datenbank bleibt. Standard 7 Tage. Aus demselben Zeitraum werden Uptime % und durchschnittliche Antwortzeit berechnet.
• Bei Timeouts benachrichtigen — Benachrichtigung senden, wenn eine Seite innerhalb des Timeouts nicht antwortet. Standardmäßig an.
• Bei Fehlern benachrichtigen — Benachrichtigung bei Netzwerkfehler oder 5xx-Antwort. Standardmäßig an.

Benachrichtigungen werden nur bei Statuswechsel ausgelöst (z. B. letzter Status success, aktueller timeout). Keine „alles in Ordnung"-Erinnerungen.

Benachrichtigungen

Benachrichtigungen gehen über zwei Kanäle, die im zentralen Benachrichtigungsbereich der App konfiguriert werden:

• Telegram — Bot-Token + Chat-ID.
• E-Mail — SMTP (Host, Port, Benutzername, Passwort, Absender, Empfänger, TLS-Schalter).

Kanäle werden einmal für ganz YoBench konfiguriert und automatisch von allen Modulen genutzt, die Benachrichtigungen senden. Andere Kanäle (Discord, Slack, Push, Webhook) werden derzeit nicht unterstützt.

Ablauf

1. Prüfung anlegen

1. Öffnen Sie das Modul Health Check im linken Menü.
2. Klicken Sie auf + Seite hinzufügen.
3. Tragen Sie Name, URL und (optional) Beschreibung ein.
4. Setzen Sie Timeout und wählen Sie bei Bedarf einen Proxy.
5. Lassen Sie Aktiviert angehakt, um die Prüfung sofort zu starten.
6. Speichern.

2. Automatische Prüfungen einschalten

1. Öffnen Sie Monitoring-Einstellungen im Kopfbereich der Health-Check-Seite.
2. Aktivieren Sie Automatische Prüfungen aktivieren.
3. Setzen Sie das Intervall in Minuten (Standard 5).
4. Konfigurieren Sie Log-Speicherzeit und Benachrichtigungskanäle.
5. Speichern.

Ab sofort fragt der Scheduler jede aktivierte URL im Intervall ab.

3. Manuell prüfen

Sie können eine Prüfung jederzeit ausführen, ohne auf den nächsten Scheduler-Tick zu warten:

• Prüfen neben einer Zeile — fragt eine einzelne URL ab.
• Alle prüfen im Kopfbereich — fragt alle aktivierten Prüfungen parallel ab.

4. Ergebnisse prüfen

Die Hauptseite zeigt eine Tabelle mit folgenden Spalten:

Für die volle Historie klicken Sie Logs neben einer Prüfung. Es öffnet sich ein Panel mit Zeitstempel, Status, Antwortzeit und Fehlertext pro Zeile. Mit Filter nach Status (Alle / Erreichbar / Nicht erreichbar / Timeout) und Pagination zu je 50 Zeilen.

5. Prüfungen verwalten

• Bearbeiten — Parameter ändern (URL, Timeout, Proxy).
• „Aktiviert" abhaken — pausiert eine Prüfung, ohne sie zu löschen.
• Löschen (×) — entfernt die Prüfung samt Logs (mit Bestätigung).

Nächste Schritte

• Verbinden Sie Benachrichtigungen (Telegram/E-Mail), um über Ausfälle sofort informiert zu werden.
• Konfigurieren Sie Proxies, falls Sie Ressourcen in einem privaten Netz überwachen müssen.
• Wenn Konfigurationssicherheit ebenso wichtig ist wie Uptime, lassen Sie parallel den Sicherheits-Scanner laufen.

Hilfe und Feedback

Bug gefunden oder Feature-Idee? Schreiben Sie uns über das Feedback-Formular.