Plugin zeigt offline — kompletter Diagnose-Flow

Eine verbundene Site zeigt Offline, wenn Hubbee innerhalb der konfigurierten Schwelle (Standard: 3× das Heartbeat-Intervall — also 15 Minuten beim 5-Minuten-Default) keinen Heartbeat vom Plugin empfangen hat.

Geh die Schritte der Reihe nach durch. Die meisten Probleme lösen sich bei Schritt 1 oder 2.

Schritt 1 — Ist die WP-Site überhaupt erreichbar?

Öffne die Homepage im Browser. Wenn die Homepage auch down ist, liegt’s am Host oder DNS, nicht am Hubbee-Plugin. Behebe die Grund-Störung; sobald die Site wieder erreichbar ist, flippt der nächste Heartbeat (binnen 5 Minuten) Hubbee zurück auf Online.

Schritt 2 — Ist das WP-Plugin aktiv?

WP-Admin → Plugins → bestätige, dass “Hubbee” aktiviert ist.

• Deaktiviert → reaktivieren. Binnen 1-2 Minuten feuert der Heartbeat und das Dashboard zeigt Online.
• Fehlt → Plugin wurde entweder deinstalliert oder das WP-Dateisystem hat Probleme. Neu installieren via WP-Admin → Plugins → Installieren → Suche nach “Hubbee”.

Hinweis: Neu-Installation behält das bestehende api_secret und die Tabellen — keine Neu-Verbindung nötig.

Schritt 3 — Feuert der Heartbeat-Cron?

Hubbee nutzt einen WordPress-Cron-Event namens hubbee_heartbeat, Standard alle 5 Minuten.

WP-Admin → Werkzeuge → Site Health → Info → Geplante Events (oder per WP-CLI: wp cron event list). Such nach hubbee_heartbeat:

• Next run liegt in der Vergangenheit → Cron hängt. Manuell triggern: wp cron event run hubbee_heartbeat
• Next run in der Zukunft → Cron ist gesund. Weiter zu Schritt 4.
• Event nicht gelistet → wp eval 'do_action("hubbee_init_cron");' reregistriert den Schedule.

Wenn wp-cron selbst deaktiviert ist (DISABLE_WP_CRON = true), brauchst du einen serverseitigen Cron, der alle 5 Minuten wp-cron.php pingt.

Schritt 4 — Erreicht die Site Hubbees API?

Der Heartbeat schickt einen ausgehenden HTTPS-Request an api.hubbee.io. Wenn der WP-Server ausgehende HTTPS-Requests blockiert, schlagen Heartbeats stumm fehl.

Vom Server testen (SSH):

curl -I https://api.hubbee.io/healthz

Erwartet: HTTP/2 200. Bei Timeout oder Netzwerk-Fehler blockiert dein Host ausgehende Verbindungen. api.hubbee.io (Port 443) in der Host-Firewall freigeben.

Schritt 5 — Plugin-Debug-Log prüfen

WP-Admin → Hubbee → Einstellungen → Debug-Log. Zeigt die letzten 100 Heartbeat-Versuche mit Status-Codes.

Häufige Muster:

• 401 Unauthorized → api_secret falsch, meist nach DB-Klon. Re-Verbinden für frisches Secret.
• 429 Too Many Requests → Rate-Limit (selten; meist nur wenn 100+ Sites mit derselben IP heartbeat-en). Support kontaktieren.
• 5xx-Fehler → vorübergehendes Hubbee-Problem. Heartbeats werden auto-retried; Site flippt zurück sobald nächster erfolgreich ist.

Schritt 6 — Manuellen Heartbeat erzwingen

WP-CLI:

wp eval 'hubbee_send_heartbeat();'

Umgeht den Cron-Schedule und feuert sofort. Beobachte das Dashboard — Site sollte binnen 5 Sekunden auf Online flippen.

Schritt 7 — Immer noch offline

Support-Thread öffnen auf support@hubbee.io und mitschicken:

• Site-URL
• Hubbee-Plugin-Version (WP-Admin → Plugins)
• WordPress-Version + PHP-Version (WP-Admin → Werkzeuge → Site Health)
• Letzte 20 Zeilen des Plugin-Debug-Logs
• Output von wp cron event list | grep hubbee

Werktags antworten wir meist innerhalb weniger Stunden.

Was das Dashboard während Recovery zeigt

Das Dashboard refreshed Status alle 60 Sekunden. Nachdem du das Problem behoben hast und ein erfolgreicher Heartbeat eingegangen ist, kann es bis zu 60 zusätzliche Sekunden dauern, bis das Badge im Browser auf Online flippt. Bei Bedarf F5 drücken.