Aktivieren der Debug-Protokollierung in ONLYOFFICE Docs

Überblick

In bestimmten Fällen ist es erforderlich, ONLYOFFICE Docs im Debug-Modus auszuführen – zum Beispiel, um Leistungsprobleme zu beheben, Protokolle zu prüfen oder Informationen für den Support zu sammeln.

Es gibt zwei Möglichkeiten, ONLYOFFICE Docs im Debug-Modus zu starten.

Option 1. Verwenden der Umgebungsvariable (nur Docker)

Wenn Sie den ONLYOFFICE Docs-Container über Docker oder Docker Compose verwalten, empfiehlt es sich, die Debug-Protokollebene über eine Umgebungsvariable zu aktivieren:

Docker

1. Legen Sie die Umgebungsvariable mit docker run fest:

   docker run -i -t -d -p 8080:80 \
     -e DS_LOG_LEVEL=DEBUG \
     onlyoffice/documentserver-de:latest

2. Starten Sie den Container neu, wenn er bereits ausgeführt wird:

   docker restart <container>

3. Die Protokolle können wie folgt angezeigt werden:

   docker logs -f <container>

Docker Compose

1. Legen Sie die Umgebungsvariable beim Ausführen des Containers in docker-compose.yml fest:

   services:
       documentserver:
         image: onlyoffice/documentserver-de:latest
         container_name: documentserver
         restart: always
         environment:
           - DS_LOG_LEVEL=DEBUG
         ports:
           - "8080:80"

2. Starten Sie Docker Compose:

   docker-compose up -d

3. Starten Sie den Container neu, wenn er bereits ausgeführt wird:

   docker-compose restart documentserver

4. Die Protokolle können wie folgt angezeigt werden:

   docker-compose logs -f documentserver

Option 2. Verwenden der log4js-Konfigurationsdatei

So starten Sie ONLYOFFICE Docs im Debug-Modus:

1. Öffnen Sie die log4js-Konfigurationsdatei. Der Pfad zur Datei hängt vom verwendeten Betriebssystem ab:

   • Für Windows - C:\Program Files\ONLYOFFICE\DocumentServer\config\log4js\production.json
   • Für Linux - /etc/onlyoffice/documentserver/log4js/production.json
   • Für Docker - /etc/onlyoffice/documentserver/log4js/production.json (innerhalb des Docker-Containers)

2. Sehen Sie sich den folgenden Codeblock an

   {
     "categories": {
       "default": {
         "appenders": [
           "default"
         ],
         "level": "WARN"
       }
     }
   }

3. Ändern Sie den Wert level von "WARN" in "DEBUG".

4. Speichern Sie die Änderungen in der Konfigurationsdatei production.json.

5. Übernehmen Sie die Änderungen, indem Sie den folgenden Befehl ausführen:

   Linux

   systemctl restart ds-*

   Docker

   supervisorctl restart all

   Oder starten Sie unter Windows den Dienst ONLYOFFICE DocumentServer Proxy neu:

   net stop DsProxySvc
   net start DsProxySvc
   net stop DsConverterSvc
   net start DsConverterSvc
   net stop DsDocServiceSvc
   net start DsDocServiceSvc

6. Die Protokolle werden an den folgenden Speicherorten gespeichert (je nach Installationstyp):

   • Für Windows - C:\Program Files\ONLYOFFICE\DocumentServer\Log
   • Für Linux - /var/log/onlyoffice/documentserver
   • Für Docker - /var/log/onlyoffice/documentserver (innerhalb des Docker-Containers) und /app/onlyoffice/DocumentServer/logs/documentserver (auf dem Host, wenn Sie das Volume einbinden)