Runbook: Website nicht erreichbar
Für die Bereitschaft, wenn die Exponential-Website eines Kunden keine Seiten ausliefert. Arbeiten Sie von oben nach unten; hören Sie auf, wenn die Ursache gefunden ist. Die Fehlerseiten und ihre Ursachen stammen aus 12.9 Seiten und Fehler zur Laufzeit.
Warnung
.htaccessbremst jede Anfrage. Sind.htaccess-Dateien erlaubt (AllowOverridealles außerNone), geschweige denn genutzt, sucht Apache sie bei jeder Anfrage in jedem Verzeichnis des Pfads und liest und wertet sie aus, und die Ladezeiten der Seiten steigen drastisch (gemessen). Die einzige wirkliche Abhilfe ist, die Funktion für den virtuellen Host abzuschalten:AllowOverride Noneim virtuellen HTTPS-Host, und die Regeln in der Konfiguration des virtuellen Hosts selbst als mod_rewrite-Regeln. Das ist in Geschwindigkeitstests im Produktivbetrieb weit schneller und die Zeit für die Optimierung einer Produktivkonfiguration unbedingt wert. Stellen Sie sofort um: Übernehmen Sie die Regeln des Beispiels für einen virtuellen HTTPS-Host in Ihren virtuellen Host (mit dem statischen Cache auchstaticcache_offload.conf), setzen SieAllowOverride None, führen Sieapachectl configtestaus, laden Sie Apache neu und testen Sie die Website. Dieselben Regeln für andere Server: nginx, LiteSpeed, Caddy, IIS, Velocity (eingebaut); wohin Regeln für virtuelle Hosts in einem Control Panel gehören: Plesk, cPanel, DirectAdmin, ISPConfig. Unter LiteSpeed oder OpenLiteSpeed kann zusätzlich der Seiten-Cache des Servers anonyme Besucher und Crawler ohne PHP bedienen: Seiten-Caching mit LiteSpeed und OpenLiteSpeed.
Inhalt
- Symptome
- Die ersten fünf Minuten
- Welche Seite sieht der Besucher?
- Überhaupt nichts antwortet
- Nach dem Vorfall
Symptome
- Die externe Prüfung löst einen Alarm aus.
- Kunden melden eine Fehlerseite (
Something went wrong,We'll be right back), eine leere Seite oder einen Verbindungsfehler des Browsers.
Die ersten fünf Minuten
Öffnen Sie die Website selbst und notieren Sie genau, was sie zeigt, mit dem HTTP-Status:
curl -sI https://www.example.com/ | head -5Öffnen Sie auch die Administration: Scheitert sie auf dieselbe Weise?
Lesen Sie die neuesten Fehler:
./console exp:logs --tail=var/log/error.log --lines=50Prüfen Sie die Maschine: Speicherplatz (
df -h), Arbeitsspeicher, Last. Eine volle Festplatte verursacht die meisten Symptome unten; siehe Festplatte voll.
Welche Seite sieht der Besucher?
| Der Besucher sieht | Ursache | Tun Sie |
|---|---|---|
We'll be right back (503, Retry-After: 30) | die Datenbank war nicht erreichbar | prüfen Sie, dass der Datenbankserver läuft; prüfen Sie die Zugangsdaten in settings/override/site.ini.append.php; die Log-Zeile enthält die Meldung des Treibers |
Down for maintenance (503) | der Wartungsmodus ist an | php bin/php/maintenance.php status --allow-root-user; wenn die Arbeit erledigt ist: php bin/php/maintenance.php off --allow-root-user; das Löschen von var/maintenance.json beendet ihn, was auch immer sonst falsch ist |
The site is missing the software libraries it needs (503) | vendor/ fehlt, wurde verschoben oder umbenannt | legen Sie vendor/ zurück oder führen Sie composer install --no-dev aus; dann php bin/php/ezcache.php --clear-all, und starten Sie Velocity neu, wenn er die Website ausliefert |
Something went wrong on our side (500) mit ERR-... | ein nicht abgefangener Fehler | ./console exp:logs --reference=ERR-...; die Zeile nennt Meldung, Datei und Zeile (Einen Fehler über seine Referenz finden) |
Eine leere Seite, oder 500 ohne etwas in error.log | PHP scheiterte, bevor Exponential protokollieren konnte: Syntaxfehler, fehlende Erweiterung, Speicher erschöpft | lesen Sie das Fehlerlog des Webservers oder von PHP-FPM; php -l auf einer kürzlich geänderten Datei |
| 404 für jede Seite unter Apache | .htaccess wird nicht gelesen oder mod_rewrite ist aus | erlauben Sie Overrides, aktivieren Sie mod_rewrite (Apache mit PHP-FPM) |
Tipp Fehler, die direkt nach einem Ausrollen oder einem Update begonnen haben: Die Ursache liegt fast immer in dieser Änderung. Unter Velocity braucht eine geänderte Klasse oder Einstellung
exp:velocity restartoderexp:velocity deploy; siehe Änderungen ausrollen.
Überhaupt nichts antwortet
Die Verbindung wird abgelehnt oder läuft in eine Zeitüberschreitung.
Unter Velocity:
php bin/php/console exp:velocity status --allow-root-userstatus meldet nur dann „running“, wenn der Server eine Anfrage beantwortet; sonst gibt es die gefundenen Probleme aus und endet mit 1.
Wenn er nicht läuft, starten Sie ihn (exp:velocity start) und lesen Sie var/vc/qbix/run/console.log, wenn er nicht hochkommt; siehe
Velocity startet nicht. Ein Server, der läuft, aber nicht antwortet: exp:velocity restart, und wenn ein
Worker festhängt, exp:velocity kill und dann start.
Unter Apache oder nginx mit PHP-FPM:
- Läuft der Webserver? Läuft der PHP-FPM-Pool der Website? (
systemctl status <service>; auf Plesk ist der Dienstplesk-php<XY>-fpm.) - Sind alle PHP-FPM-Kinder beschäftigt? Die Statusseite oder das Log des Pools sagt es; siehe Langsame Website.
Davor: Ein Load Balancer, Reverse Proxy, CDN oder eine Firewall-Regel könnte der Teil sein, der scheitert. Testen Sie den Origin direkt.
Nach dem Vorfall
- To do: Leeren Sie die Caches, die die Abhilfe braucht, und mit Velocity seinen Antwort-Cache nach jedem Neustart
(
php bin/php/console exp:velocity cache clear --apply --allow-root-user). - To do: Prüfen Sie: Startseite, Administration, eine Anmeldung, eine Veröffentlichung.
- To do: Schreiben Sie die Notiz zum Vorfall: Beginn, Erkennung, Ursache, Abhilfe, Ende, was eine Wiederholung verhindert.
- To do: Informieren Sie den Kunden.
- To do: Wenn die Ursache ein Fehler in Exponential ist, melden Sie ihn (Wenn etwas schiefgeht).
Verwandte Seiten
- Langsame Website
- Velocity startet nicht
- Kapitel 12: Fehlersuche
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.