OnWatchers

OnWatchers - Benutzer-Dokumentation

Inhaltsverzeichnis

Einführung und Systemüberblick
Watchers (Überwachungsobjekte)
Benachrichtigungen (Notifiers)
Organisation und Verwaltung
Wie funktioniert OnWatchers?
Schwellenwerte und Details

Einführung und Systemüberblick

Was ist OnWatchers?

OnWatchers ist ein umfassendes Website-Monitoring-System, das Ihnen hilft, die Verfügbarkeit, Sicherheit und Performance Ihrer Websites kontinuierlich zu überwachen. Das System arbeitet vollautomatisch im Hintergrund und informiert Sie sofort, wenn Probleme auftreten.

Hauptfunktionen und Einsatzbereiche

OnWatchers bietet drei zentrale Überwachungsfunktionen:

Verfügbarkeitsüberwachung (Uptime): Stellt sicher, dass Ihre Website jederzeit erreichbar ist
SSL-Zertifikatsüberwachung (Certificate): Überwacht die Gültigkeit Ihrer SSL/TLS-Zertifikate
Performance-Überwachung (Lighthouse): Analysiert die Leistung und Qualität Ihrer Website

Grundlegende Konzepte

Das System basiert auf vier Hauptkomponenten:

Watchers: Die Überwachungsobjekte, die Ihre Websites kontinuierlich prüfen
Notifiers: Benachrichtigungskanäle (E-Mail, SMS), über die Sie bei Problemen informiert werden
Gruppen: Organisatorische Einheiten zur logischen Gruppierung Ihrer Watchers
Tags: Flexible Schlagwörter zur Kategorisierung und Filterung

Watchers (Überwachungsobjekte)

Watchers sind das Herzstück von OnWatchers. Jeder Watcher überwacht einen bestimmten Aspekt Ihrer Website und führt automatisch regelmäßige Prüfungen durch.

Uptime-Watcher (Verfügbarkeitsüberwachung)

Der Uptime-Watcher überwacht die Erreichbarkeit Ihrer Website und stellt sicher, dass Ihre Besucher jederzeit Zugriff haben.

Was wird überwacht?

Erreichbarkeit: Ist die Website online und antwortet sie?
HTTP-Status-Codes: Welcher Status-Code wird zurückgegeben? (z.B. 200 OK, 404 Not Found, 500 Server Error)
Antwortzeit: Wie schnell antwortet der Server?
Inhalts-Validierung: Optional kann nach einem bestimmten Schlüsselwort auf der Seite gesucht werden

Prüfungsintervall

Alle 5 Minuten – So erfahren Sie schnellstmöglich, wenn Ihre Website ausfällt.

Einstellungen

Einstellung	Beschreibung	Erforderlich
URL	Die vollständige URL Ihrer Website (z.B. https://www.ihre-website.de)	✓ Ja
Schlüsselwort	Ein Text, der auf der Seite vorhanden sein muss (z.B. "Willkommen"). Nützlich, um sicherzustellen, dass nicht nur der Server antwortet, sondern auch der richtige Inhalt ausgeliefert wird.	○ Optional

Beispiel-Szenarien

Szenario 1: Einfache Verfügbarkeitsprüfung

URL: https://www.mein-shop.de
Schlüsselwort: leer
Ergebnis: Prüft, ob die Website mit Status 200 antwortet

Szenario 2: Inhaltsprüfung

URL: https://www.mein-shop.de
Schlüsselwort: Warenkorb
Ergebnis: Prüft nicht nur die Erreichbarkeit, sondern auch, ob das Wort "Warenkorb" auf der Seite vorkommt

Was passiert bei einem Problem?

Wenn die Website nicht erreichbar ist, ein falscher Status-Code zurückgegeben wird oder das Schlüsselwort nicht gefunden wird, führt das System automatisch 3 Wiederholungsversuche im Abstand von 3 Sekunden durch. Nur wenn alle Versuche fehlschlagen, wird eine Benachrichtigung ausgelöst.

Certificate-Watcher (SSL-Zertifikats-Überwachung)

Der Certificate-Watcher überwacht die SSL/TLS-Zertifikate Ihrer Domains und warnt Sie rechtzeitig vor Ablauf oder Problemen.

Was wird überwacht?

Gültigkeit: Ist das Zertifikat für die Domain gültig?
Ablaufdatum: Wann läuft das Zertifikat ab?
Zertifikatskette: Ist die Vertrauenskette korrekt?
Aussteller-Informationen: Wer hat das Zertifikat ausgestellt?
Organisation: Auf welche Organisation ist das Zertifikat ausgestellt?
Alternative Domains: Welche weiteren Domains deckt das Zertifikat ab?

Prüfungsintervall

Einmal täglich – SSL-Zertifikate ändern sich nicht häufig, eine tägliche Prüfung ist ausreichend.

Einstellungen

Einstellung	Beschreibung	Erforderlich
URL/Domain	Die Domain Ihrer Website (z.B. www.ihre-website.de oder ihre-website.de)	✓ Ja

Frühwarnsystem

Das System warnt Sie 7 Tage vor Ablauf des Zertifikats, damit Sie genügend Zeit haben, es zu erneuern.

Mögliche Benachrichtigungen

Certificate Will Expire: Das Zertifikat läuft in 7 Tagen oder weniger ab
Certificate Expired: Das Zertifikat ist bereits abgelaufen
Certificate Invalid: Das Zertifikat ist ungültig oder passt nicht zur Domain

Warum ist das wichtig?

Abgelaufene SSL-Zertifikate führen zu Sicherheitswarnungen im Browser
Besucher können Ihre Website nicht mehr aufrufen
Negative Auswirkungen auf SEO und Vertrauen
Zahlungsanbieter funktionieren nicht mehr

Lighthouse-Watcher (Performance-Überwachung)

Der Lighthouse-Watcher nutzt die Google Lighthouse-Technologie, um die Performance, Barrierefreiheit, Best Practices und SEO Ihrer Website zu analysieren.

Was wird überwacht?

Der Lighthouse-Watcher führt eine umfassende Analyse Ihrer Website durch und bewertet verschiedene Aspekte:

Performance-Metriken (Scores 0-100)

Performance: Wie schnell lädt und reagiert Ihre Website?
Accessibility: Wie barrierefrei ist Ihre Website?
Best Practices: Folgt Ihre Website modernen Web-Standards?
SEO: Ist Ihre Website für Suchmaschinen optimiert?

Core Web Vitals (Ladezeiten in Millisekunden)

First Contentful Paint (FCP): Zeit bis zum ersten sichtbaren Inhalt
Largest Contentful Paint (LCP): Zeit bis zum größten sichtbaren Element
Speed Index: Wie schnell wird der Inhalt sichtbar ausgefüllt?
Total Blocking Time (TBT): Wie lange ist die Seite blockiert?
Time to Interactive (TTI): Wann ist die Seite vollständig interaktiv?
Cumulative Layout Shift (CLS): Wie stark verschiebt sich das Layout beim Laden?

Prüfungsintervall

Einmal täglich – Performance-Analysen sind rechenintensiv, eine tägliche Analyse ist optimal.

Einstellungen

Einstellung	Beschreibung	Erforderlich
URL	Die vollständige URL der zu analysierenden Seite	✓ Ja

Test-Konfiguration

Gerät: Mobile (Smartphone-Simulation)
Netzwerk: Simulierte mobile Verbindung
Browser: Headless Chrome

Vollständiger Report

Zusätzlich zu den Scores und Metriken speichert das System den vollständigen HTML-Report von Lighthouse. So können Sie im Detail sehen, welche Optimierungen empfohlen werden.

Wann werden Benachrichtigungen ausgelöst?

Eine Benachrichtigung wird ausgelöst, wenn einer oder mehrere der folgenden Schwellenwerte unterschritten werden:

Performance-Score < 50
Accessibility-Score < 50
Best Practices-Score < 50
SEO-Score < 50

Benachrichtigungen (Notifiers)

Notifiers sind Ihre Benachrichtigungskanäle. Sie legen fest, wie und wo Sie informiert werden möchten, wenn ein Problem erkannt wird.

Grundprinzip

Benachrichtigungen werden nur bei Status-Änderungen verschickt, nicht bei jeder einzelnen Prüfung. Dies verhindert Benachrichtigungs-Spam und stellt sicher, dass Sie nur wirklich relevante Informationen erhalten.

E-Mail-Benachrichtigungen

Die klassische und universelle Benachrichtigungsmethode.

Eigenschaften

Sofortige Zustellung: Sie erhalten die E-Mail innerhalb weniger Sekunden nach Erkennung des Problems
Konfigurierbare Adresse: Jeder Notifier kann an eine beliebige E-Mail-Adresse senden
Mehrsprachig: Die Benachrichtigungen werden in Ihrer bevorzugten Sprache versendet
Detaillierte Informationen: Die E-Mail enthält alle relevanten Details zum Problem

Einrichtung

Erstellen Sie einen neuen Notifier
Wählen Sie "E-Mail" als Typ
Geben Sie die E-Mail-Adresse ein
Verbinden Sie den Notifier mit einem oder mehreren Watchers

SMS-Benachrichtigungen

Für zeitkritische Alarme, die Sie auch unterwegs erreichen sollen.

Eigenschaften

Sofortige Zustellung: SMS erreicht Sie auch ohne Internetverbindung
Zeitkritisch: Ideal für geschäftskritische Websites
Kurz und prägnant: Kompakte Zusammenfassung des Problems
Telefonnummer: Benötigt eine gültige Mobilfunknummer

Einrichtung

Erstellen Sie einen neuen Notifier
Wählen Sie "SMS" als Typ
Geben Sie die Telefonnummer ein (internationales Format)
Verbinden Sie den Notifier mit einem oder mehreren Watchers

Mögliche Benachrichtigungs-Ereignisse

Je nach Watcher-Typ können folgende Ereignisse auftreten:

Uptime-Watcher Ereignisse

Ereignis	Beschreibung	Kritikalität
URL Down	Website ist nicht erreichbar oder liefert einen Fehler-Status	🔴 Kritisch
URL Up	Website ist wieder erreichbar (nach einem Down)	🟢 Informativ

Certificate-Watcher Ereignisse

Ereignis	Beschreibung	Kritikalität
Certificate Invalid	SSL-Zertifikat ist ungültig oder passt nicht zur Domain	🔴 Kritisch
Certificate Expired	SSL-Zertifikat ist abgelaufen	🔴 Kritisch
Certificate Will Expire	SSL-Zertifikat läuft in 7 Tagen oder weniger ab	🟡 Warnung

Lighthouse-Watcher Ereignisse

Ereignis	Beschreibung	Kritikalität
Lighthouse Issues Detected	Ein oder mehrere Scores sind unter den Schwellenwerten	🟡 Warnung

Verknüpfung von Watchers und Notifiers

Die Verknüpfung zwischen Watchers und Notifiers ist flexibel und many-to-many:

Flexible Konfiguration

Ein Watcher → Mehrere Notifiers: Sie können einen Watcher mit mehreren Notifiers verbinden
- Beispiel: Website-Downtime wird per E-Mail UND SMS gemeldet
Ein Notifier → Mehrere Watchers: Sie können einen Notifier für mehrere Watchers verwenden
- Beispiel: Eine zentrale Admin-E-Mail-Adresse erhält Benachrichtigungen von allen Watchers

Beispiel-Szenarien

Szenario 1: Kritische Produktions-Website

Watcher: Uptime-Check für https://shop.beispiel.de
Notifier 1: E-Mail an admin@beispiel.de
Notifier 2: SMS an +49 xxx xxx xxx
Ergebnis: Doppelte Absicherung für maximale Erreichbarkeit

Szenario 2: Mehrere Websites, ein Admin

Watcher 1: Uptime-Check für https://website1.de
Watcher 2: Uptime-Check für https://website2.de
Watcher 3: Uptime-Check für https://website3.de
Notifier: E-Mail an admin@beispiel.de
Ergebnis: Zentrale Benachrichtigung für alle Websites

Szenario 3: Team-Benachrichtigungen

Watcher: Uptime-Check für https://firma.de
Notifier 1: E-Mail an entwicklung@firma.de
Notifier 2: E-Mail an support@firma.de
Notifier 3: E-Mail an geschaeftsfuehrung@firma.de
Ergebnis: Alle relevanten Teams werden informiert

Organisation und Verwaltung

Bei vielen Watchers wird die Organisation wichtig. OnWatchers bietet zwei Methoden zur Strukturierung: Gruppen und Tags.

Gruppen (Groups)

Gruppen helfen Ihnen, Ihre Watchers logisch zu organisieren und einen besseren Überblick zu behalten.

Eigenschaften

Eindeutige Zuordnung: Jeder Watcher kann einer Gruppe zugeordnet werden
Hierarchische Organisation: Ideal für projektbasierte oder kundenbasierte Strukturierung
Übersichtlichkeit: Besonders wichtig bei vielen Watchers

Anwendungsbeispiele

Nach Umgebungen

📁 Produktions-Websites
   ├── Watcher: shop.beispiel.de (Uptime)
   ├── Watcher: shop.beispiel.de (Certificate)
   └── Watcher: shop.beispiel.de (Lighthouse)

📁 Test-Umgebungen
   ├── Watcher: staging.beispiel.de (Uptime)
   └── Watcher: dev.beispiel.de (Uptime)

Nach Kunden

📁 Kunde: Müller GmbH
   ├── Watcher: mueller-gmbh.de (Uptime)
   └── Watcher: shop.mueller-gmbh.de (Uptime)

📁 Kunde: Schmidt AG
   ├── Watcher: schmidt-ag.de (Uptime)
   └── Watcher: schmidt-ag.de (Certificate)

Nach Projekten

📁 E-Commerce Projekt
   ├── Watcher: Frontend (Uptime)
   ├── Watcher: Backend API (Uptime)
   └── Watcher: Admin Panel (Uptime)

📁 Corporate Website
   ├── Watcher: Hauptseite (Uptime)
   ├── Watcher: Hauptseite (Lighthouse)
   └── Watcher: SSL-Zertifikat (Certificate)

Schlagwörter (Tags)

Tags bieten eine flexible, nicht-hierarchische Kategorisierung Ihrer Watchers.

Eigenschaften

Mehrfachzuordnung: Jeder Watcher kann mehrere Tags haben
Freie Vergabe: Sie können beliebige Schlagwörter vergeben
Filterung: Erleichtert das Finden und Filtern von Watchers
Kombinierbar: Tags ergänzen die Gruppen-Organisation

Anwendungsbeispiele

Nach Kritikalität

kritisch – Geschäftskritische Websites
wichtig – Wichtige, aber nicht kritische Websites
test – Test- und Entwicklungsumgebungen

Nach Technologie

wordpress – WordPress-basierte Websites
laravel – Laravel-Anwendungen
react – React-Frontend-Anwendungen
api – API-Endpunkte

Nach Funktion

e-commerce – Online-Shops
blog – Blog-Websites
landingpage – Marketing-Landingpages
saas – SaaS-Anwendungen

Nach Verantwortlichkeit

team-frontend – Verantwortung: Frontend-Team
team-backend – Verantwortung: Backend-Team
extern – Extern gehostete Services

Kombinations-Beispiel

Ein Watcher kann mehrere Tags kombinieren:

Watcher: https://shop.beispiel.de
Gruppe: Produktion
Tags: kritisch, e-commerce, laravel, team-backend

→ Ergebnis: Produktions-Shop, kritisch, Laravel-basiert, 
            Backend-Team ist verantwortlich

Gruppen vs. Tags: Wann was verwenden?

Kriterium	Gruppen	Tags
Struktur	Hierarchisch, eindeutig	Flexibel, mehrfach
Verwendung	Hauptkategorisierung	Zusätzliche Merkmale
Anzahl pro Watcher	1 Gruppe	Mehrere Tags
Beispiel	"Kunde XY", "Produktion"	"kritisch", "wordpress", "api"

Empfehlung: Nutzen Sie Gruppen für die Hauptstruktur (Kunde, Projekt, Umgebung) und Tags für zusätzliche Eigenschaften (Technologie, Kritikalität, Verantwortlichkeit).

Wie funktioniert OnWatchers?

OnWatchers arbeitet vollautomatisch im Hintergrund. Hier erfahren Sie, wie das System technisch funktioniert.

Automatische Prüfungs-Intervalle

Das System führt automatisch und regelmäßig Prüfungen durch:

Watcher-Typ	Intervall	Grund
Uptime	Alle 5 Minuten	Schnelle Erkennung von Ausfällen
Certificate	Einmal täglich	Zertifikate ändern sich selten
Lighthouse	Einmal täglich	Performance-Analysen sind rechenintensiv

Sie müssen nichts tun!

✓ Keine manuelle Auslösung erforderlich
✓ Keine Wartung notwendig
✓ Läuft 24/7 automatisch
✓ Auch an Wochenenden und Feiertagen

Benachrichtigungslogik

OnWatchers nutzt eine intelligente Benachrichtigungslogik, um Sie nur bei relevanten Änderungen zu informieren.

Status-Änderungs-Erkennung

Das System vergleicht immer das aktuelle Prüfergebnis mit dem vorherigen Prüfergebnis:

Prüfung 1: Website online ✓
Prüfung 2: Website online ✓  → Keine Benachrichtigung
Prüfung 3: Website offline ✗ → ⚠️ Benachrichtigung "URL Down"
Prüfung 4: Website offline ✗ → Keine Benachrichtigung
Prüfung 5: Website online ✓  → ✅ Benachrichtigung "URL Up"

Vermeidung von Spam

Ohne intelligente Logik würden Sie bei einem 2-stündigen Ausfall:

24 E-Mails erhalten (alle 5 Minuten eine)
Ihr Postfach wäre überflutet
Wichtige Nachrichten gehen unter

Mit intelligenter Logik erhalten Sie:

1 E-Mail bei Ausfall
1 E-Mail bei Wiederherstellung
Klare, übersichtliche Kommunikation

Wiederholungsversuche (nur Uptime)

Beim Uptime-Watcher wird ein zusätzlicher Mechanismus eingesetzt, um Fehlalarme zu vermeiden:

Erste Prüfung schlägt fehl → Warte 3 Sekunden
Zweite Prüfung → Schlägt auch fehl → Warte 3 Sekunden
Dritte Prüfung → Schlägt auch fehl → Warte 3 Sekunden
Vierte Prüfung → Schlägt auch fehl → Jetzt erst wird Benachrichtigung verschickt

Vorteil: Kurze Netzwerk-Störungen oder Server-Neustarts führen nicht sofort zu Alarmen.

Verarbeitungsweise

OnWatchers nutzt moderne Technologien für optimale Performance und Zuverlässigkeit.

Hintergrund-Verarbeitung

Asynchron: Prüfungen laufen im Hintergrund
Keine Verzögerungen: Die Benutzeroberfläche bleibt immer responsiv
Queue-System: Alle Jobs werden in Warteschlangen organisiert
Separate Queues: Jeder Watcher-Typ hat seine eigene Queue

Datenspeicherung und Reports

Historische Daten: Alle Prüfergebnisse werden dauerhaft gespeichert
Trend-Analysen: Verfolgen Sie die Entwicklung über Wochen und Monate
Detaillierte Reports: Jede Prüfung enthält alle relevanten Informationen
Charts und Grafiken: Visuelle Aufbereitung der Daten

Zuverlässigkeit

Mehrfache Redundanz: System läuft auf mehreren Servern
Monitoring des Monitors: Das System überwacht sich selbst
Automatische Wiederherstellung: Bei Problemen erfolgt automatischer Neustart
99.9% Uptime-Garantie: OnWatchers selbst ist hochverfügbar

Schwellenwerte und Details

Hier finden Sie alle technischen Details zu den Schwellenwerten und Konfigurationen der einzelnen Checker.

Uptime-Checker - Technische Details

Timeout-Einstellungen

Parameter	Wert	Bedeutung
Connect Timeout	20 Sekunden	Maximale Zeit für Verbindungsaufbau
Read Timeout	20 Sekunden	Maximale Zeit für Datenempfang
Gesamt-Timeout	60 Sekunden	Maximale Gesamtdauer der Anfrage

Wiederholungsversuche

Parameter	Wert	Bedeutung
Anzahl Versuche	3	Bei Fehler wird 3-mal wiederholt
Wartezeit	3 Sekunden	Pause zwischen den Versuchen
Gesamtdauer	~9 Sekunden	Maximale Zeit bis zur finalen Entscheidung

Antwortzeit-Überwachung

Schwellenwert: 1000 ms (1 Sekunde)
Messung: Gesamte Übertragungszeit (Transfer Time)
Einheit: Millisekunden

Interpretation:

< 500 ms: Sehr gut ✓✓
500-1000 ms: Gut ✓
1000-2000 ms: Akzeptabel ~
> 2000 ms: Langsam ✗

HTTP-Einstellungen

User-Agent: "OnWatchers"
Redirects: Automatisch folgen (enabled)
SSL-Verifizierung: Deaktiviert (um auch selbst-signierte Zertifikate zu prüfen)
HTTP-Fehler: Werden nicht als Exceptions behandelt

Certificate-Checker - Technische Details

Prüfkriterien

Kriterium	Prüfung
Gültigkeit	Ist das Zertifikat für die Domain gültig?
Ablauf	Ist das Zertifikat noch gültig oder abgelaufen?
Gültigkeitszeitraum	Von wann bis wann ist das Zertifikat gültig?
Domain-Match	Passt das Zertifikat zur angeforderten Domain?
Alternative Domains	Welche weiteren Domains deckt das Zertifikat ab?
Aussteller	Wer hat das Zertifikat ausgestellt? (CA)
Organisation	Auf welche Organisation läuft das Zertifikat?

Warnschwellen

Zeitraum	Aktion	Benachrichtigung
> 7 Tage bis Ablauf	Keine	–
≤ 7 Tage bis Ablauf	⚠️ Warnung	Certificate Will Expire
Abgelaufen	🔴 Kritisch	Certificate Expired
Ungültig	🔴 Kritisch	Certificate Invalid

Verwendete Technologie

SSL-Library: Spatie SSL Certificate Package
Verbindung: Direkter SSL-Handshake zur Domain
Port: Standard HTTPS Port (443)

Lighthouse-Checker - Technische Details

Score-Schwellenwerte

Benachrichtigungen werden ausgelöst, wenn Scores unter folgende Werte fallen:

Metrik	Schwellenwert	Bewertung
Performance	< 50	Kritisch
Accessibility	< 50	Kritisch
Best Practices	< 50	Kritisch
SEO	< 50	Kritisch

Score-Skala: 0-100 (100 = perfekt)

Core Web Vitals - Schwellenwerte

Metrik	Schwellenwert	Beschreibung
First Contentful Paint (FCP)	> 2000 ms	Zeit bis zum ersten sichtbaren Inhalt
Largest Contentful Paint (LCP)	> 2500 ms	Zeit bis zum größten Content-Element
Speed Index	> 2500 ms	Wie schnell wird Inhalt sichtbar?
Total Blocking Time (TBT)	> 400 ms	Blockierzeit für Interaktionen
Time to Interactive (TTI)	> 5000 ms	Zeit bis zur vollen Interaktivität
Cumulative Layout Shift (CLS)	> 0.25	Visuelles Layout-Verschieben

Test-Konfiguration

Parameter	Einstellung
Form Factor	Mobile (Smartphone)
Browser	Chrome Headless
Netzwerk	Simulierte mobile Verbindung
Chrome Flags	`--headless`, `--no-sandbox`
Timeout	300 Sekunden (5 Minuten)

Output

Scores: Performance, Accessibility, Best Practices, SEO (0-100)
Metriken: Alle Core Web Vitals in Millisekunden
HTML-Report: Vollständiger Lighthouse-Report als HTML
- Kann im Browser geöffnet werden
- Enthält detaillierte Optimierungsvorschläge
- Screenshots der Website

Google Lighthouse Version

OnWatchers verwendet die aktuelle Version der Lighthouse-API für akkurate und aktuelle Messungen.

Zusammenfassung

OnWatchers bietet Ihnen ein umfassendes, vollautomatisches Website-Monitoring mit:

✓ Drei Watcher-Typen für Verfügbarkeit, SSL-Zertifikate und Performance
✓ Flexible Benachrichtigungen per E-Mail und SMS
✓ Intelligente Alarmierung nur bei Status-Änderungen
✓ Organisation durch Gruppen und Tags
✓ Automatische Prüfungen im 5-Minuten- bis Tages-Intervall
✓ Historische Daten für Trend-Analysen
✓ Vollständige Reports mit detaillierten Informationen

OnWatchers arbeitet für Sie – rund um die Uhr, vollautomatisch und zuverlässig.

Version 1.0.0 | Stand: Oktober 2025