Omogućavanje debug logovanja u ONLYOFFICE Docs

Pregled

U određenim slučajevima, potrebno je pokrenuti ONLYOFFICE Docs u debug režimu — na primer, za rešavanje problema sa performansama, pregled logova ili prikupljanje informacija za podršku.

Postoje dve opcije za pokretanje ONLYOFFICE Docs u debug režimu.

Opcija 1. Korišćenje promenljive okruženja (samo za Docker)

Ako upravljate ONLYOFFICE Docs kontejnerom putem Docker-a ili Docker Compose-a, preporučljivo je koristiti promenljivu okruženja za omogućavanje nivoa debug logovanja:

Docker

1. Postavite promenljivu okruženja sa docker run:

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

2. Ponovo pokrenite kontejner ako je već pokrenut:

   docker restart <container>

3. Logove možete pregledati sa:

   docker logs -f <container>

Docker Compose

1. Postavite promenljivu okruženja u docker-compose.yml prilikom pokretanja kontejnera:

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

2. Pokrenite Docker Compose:

   docker-compose up -d

3. Ponovo pokrenite kontejner ako je već pokrenut:

   docker-compose restart documentserver

4. Logove možete pregledati sa:

   docker-compose logs -f documentserver

Opcija 2. Korišćenje log4js konfiguracione datoteke

Da biste pokrenuli ONLYOFFICE Docs u debug režimu:

1. Otvorite log4js konfiguracionu datoteku. Putanja do datoteke zavisi od operativnog sistema koji koristite:

   • Za Windows - C:\Program Files\ONLYOFFICE\DocumentServer\config\log4js\production.json
   • Za Linux - /etc/onlyoffice/documentserver/log4js/production.json
   • Za Docker - /etc/onlyoffice/documentserver/log4js/production.json (unutar Docker kontejnera)

2. Pogledajte sledeći blok koda

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

3. Promenite vrednost level sa "WARN" na "DEBUG".

4. Sačuvajte izmene u production.json konfiguracionoj datoteci.

5. Primenite izmene izvršavanjem sledeće komande:

   Linux

   systemctl restart ds-*

   Docker

   supervisorctl restart all

   Ili ponovo pokrenite ONLYOFFICE DocumentServer Proxy servis za Windows:

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

6. Logovi se čuvaju na sledećim lokacijama (u zavisnosti od tipa instalacije):

   • Za Windows - C:\Program Files\ONLYOFFICE\DocumentServer\Log
   • Za Linux - /var/log/onlyoffice/documentserver
   • Za Docker - /var/log/onlyoffice/documentserver (unutar Docker kontejnera) i /app/onlyoffice/DocumentServer/logs/documentserver (na hostu ako montirate volumen)