Fehler debuggen mit ISPConfig auf msrv.io

Beim Debuggen von Webseitenfehlern mit ISPConfig ist es nützlich, auf verschiedene Log-Dateien zuzugreifen. Hier erklären wir, wie Sie Nginx- und PHP-Fehlerprotokolle per SSH oder SFTP abrufen können und wie Sie die Protokolle für cronjobs in der /private-Verzeichnisstruktur finden. Im Anschluss finden Sie konkrete Beispiele für das Debuggen in WordPress, TYPO3, Laravel und Drupal.

Zugriff auf Nginx und PHP Error Logs

Die Nginx- und PHP-Fehlerprotokolle für Ihre Webseite befinden sich im /log-Verzeichnis Ihres ISPConfig-Serverkontos. Sie können per SSH oder SFTP auf diese Dateien zugreifen.

SSH-Zugriff

1. Öffnen Sie ein Terminal (Windows: PowerShell oder Eingabeaufforderung, Mac/Linux: Terminal).
2. Verbinden Sie sich mit dem Server:
   ssh benutzername@serveradresse
3. Geben Sie Ihr Passwort ein, wenn Sie dazu aufgefordert werden.
4. Navigieren Sie zum /log-Verzeichnis:
   cd /var/www/ihre-webseite/log
5. Bei Nginx-Logs anzeigen:
   cat error.log
6. Bei PHP-Logs anzeigen:
   cat php_error.log

SFTP-Zugriff

1. Öffnen Sie Ihr bevorzugtes SFTP-Programm (z.B. FileZilla).
2. Stellen Sie eine Verbindung zu Ihrem Server her, indem Sie die Serveradresse, den Benutzernamen und das Passwort eingeben.
3. Navigieren Sie zum /log-Verzeichnis:
   /var/www/ihre-webseite/log
4. Laden Sie die Dateien error.log und php_error.log herunter und öffnen Sie sie in einem Texteditor.

Logs von Cronjobs

Die Protokolle für Cronjobs finden Sie im /private-Verzeichnis Ihres ISPConfig-Serverkontos. Dort befinden sich die Dateien cron_error.log und cron.log.

SSH-Zugriff

1. Öffnen Sie ein Terminal und verbinden Sie sich mit Ihrem Server per SSH.
2. Navigieren Sie zum /private-Verzeichnis:
   cd /var/www/ihre-webseite/private
3. Bei Cronjob-Error-Logs anzeigen:
   cat cron_error.log
4. Bei allgemeinen Cronjob-Logs anzeigen:
   cat cron.log

SFTP-Zugriff

1. Öffnen Sie Ihr bevorzugtes SFTP-Programm und stellen Sie eine Verbindung zu Ihrem Server her.
2. Navigieren Sie zum /private-Verzeichnis.
3. Laden Sie die Dateien cron_error.log und cron.log herunter und öffnen Sie sie in einem Texteditor.

Beispiele für WordPress, TYPO3, Laravel und Drupal

WordPress

WordPress speichert PHP-Fehler üblicherweise in der wp-config.php-Datei, abhängig von den wp_debug Einstellungen.

• Stellen Sie sicher, dass define('WP_DEBUG', true); und define('WP_DEBUG_LOG', true); in der wp-config.php aktiviert sind.
• Fehlerprotokolle finden Sie zusätzlich unter wp-content/debug.log.

TYPO3

TYPO3 speichert Fehler in der typo3temp-Ordnerstruktur.

• Überprüfen Sie die Protokolle im Verzeichnis typo3temp/var/log.
• Aktivieren Sie das Logging in der LocalConfiguration.php Datei.

Laravel

Laravel zeichnet Fehler im storage/logs-Verzeichnis auf.

• Standardfehlerdatei: storage/logs/laravel.log
• Verwenden Sie die Log Klasse, um Funktionalitäten detaillierter zu protokollieren:
  Log::error('Fehlermeldung');

Drupal

Drupal speichert Fehler im syslog oder in der Datenbank, abhängig von den Einstellungen.

• Überprüfen Sie /var/log oder die Protokolleinträge innerhalb des Admin-Panels.
• Aktivieren Sie das Fehlerprotokollieren in den settings.php Datei.

Chronjobb Anpassung in WordPress

• Prüfen Sie den wp-config.php, um sicherzustellen das der WP_CRON korrekt gesetzt ist.
• Achten Sie auf korrekte Pfade und Abhängigkeiten in den Croniniert Jobs.

FAQ: Fehler debuggen mit ISPConfig

1. Wie kann ich feststellen, ob ein Fehler durch Nginx oder PHP verursacht wird?

Im /log-Verzeichnis Ihres ISPConfig-Serverkontos finden Sie separate Dateien für Nginx (error.log) und PHP (php_error.log). Überprüfen Sie beide Log-Dateien, um die genaue Quelle des Fehlers zu ermitteln.

2. Warum kann ich mich nicht per SSH mit meinem Server verbinden?

Stellen Sie sicher, dass SSH auf Ihrem Server korrekt konfiguriert ist und dass Sie die richtigen Zugangsdaten verwenden. Überprüfen Sie auch, ob der SSH-Dienst läuft und der SSH-Port (standardmäßig 22) nicht blockiert wird.

3. Welche Tools kann ich verwenden, um SFTP-Verbindungen herzustellen?

Beliebte SFTP-Clients sind FileZilla, WinSCP (Windows) und Cyberduck (Mac). Diese Tools bieten eine grafische Benutzeroberfläche, die das Navigieren und Übertragen von Dateien erleichtert.

4. Wo finde ich die Protokolle für cronjobs?

Die Protokolle für cronjobs befinden sich im /private-Verzeichnis Ihres ISPConfig-Serverkontos. Die relevanten Dateien sind cron_error.log für Fehlerprotokolle und cron.log für allgemeine Protokolle.

5. Was soll ich tun, wenn ich keine Fehlerprotokolle finde?

Stellen Sie sicher, dass das Logging auf Ihrem Server korrekt konfiguriert ist. Bei WordPress, TYPO3, Laravel und Drupal müssen möglicherweise die jeweiligen Konfigurationsdateien angepasst werden, um das Fehlerprotokollieren zu aktivieren. Beispielsweise können Sie in WordPress define('WP_DEBUG', true); und define('WP_DEBUG_LOG', true); in die wp-config.php Datei einfügen.

6. Kann ich die Fehlerprotokolle direkt auf dem Server ändern?

Es wird nicht empfohlen, die Fehlerprotokolle selbst zu ändern, da sie wertvolle Informationen zu aufgetretenen Fehlern enthalten. Stattdessen sollten Sie den Quellcode Ihrer Webseite oder die entsprechenden Konfigurationsdateien anpassen, um die Ursachen der Fehler zu beheben.

7. Wie häufig werden die Protokolldateien aktualisiert?

Die Protokolldateien werden in Echtzeit aktualisiert, sobald neue Fehler oder Ereignisse auftreten. Sie können die Dateien regelmäßig überprüfen, um den Status Ihrer Webseite und Serverprozesse zu überwachen.

8. Kann ich alte Fehlerprotokolle archivieren oder löschen?

Ja, Sie können alte Protokolldateien archivieren oder löschen, um Speicherplatz freizugeben. Stellen Sie jedoch sicher, dass Sie alle notwendigen Informationen gesichert haben, bevor Sie dies tun. Sie können dies per SSH oder SFTP durchführen, indem Sie die Dateien umbenennen, verschieben oder löschen.

9. Wie kann ich sicherstellen, dass meine cronjobs ordnungsgemäß ausgeführt werden?

Überprüfen Sie regelmäßig die Dateien cron_error.log und cron.log im /private-Verzeichnis, um sicherzustellen, dass Ihre cronjobs fehlerfrei ausgeführt werden. Stellen Sie außerdem sicher, dass die Cronjob-Scripte korrekt konfiguriert und ausführbar sind.

10. Wie kann ich die Protokollierung für meine Anwendung anpassen?

Jede Anwendung (WordPress, TYPO3, Laravel, Drupal) bietet eigene Konfigurationsmöglichkeiten für die Protokollierung. Überprüfen Sie die Dokumentation der jeweiligen Anwendung und passen Sie die entsprechenden Konfigurationsdateien an, um die Protokollierung nach Ihren Bedürfnissen einzurichten. Beispiel: In Laravel können Sie die config/logging.php Datei anpassen, um das Protokollierungsverhalten zu ändern.