Passa al contenuto principale

Abilitare il logging di debug in ONLYOFFICE Docs

Panoramica​

In alcuni casi, è necessario eseguire ONLYOFFICE Docs in modalità debug, ad esempio per risolvere problemi di prestazioni, ispezionare i log o raccogliere informazioni per il supporto.

Ci sono due opzioni per avviare ONLYOFFICE Docs in modalità debug.

Opzione 1. Utilizzo della variabile d'ambiente (solo Docker)​

Se gestisci il container di ONLYOFFICE Docs tramite Docker o Docker Compose, è preferibile utilizzare una variabile d'ambiente per abilitare il livello di log di debug:

Docker​

  1. Imposta la variabile d'ambiente con docker run:

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

  2. Riavvia il container se è già in esecuzione:

    docker restart <container>

  3. I log possono essere visualizzati con:

    docker logs -f <container>

Docker Compose​

  1. Imposta la variabile d'ambiente in docker-compose.yml quando esegui il container:

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

  2. Avvia Docker Compose:

    docker-compose up -d

  3. Riavvia il container se è già in esecuzione:

    docker-compose restart documentserver

  4. I log possono essere visualizzati con:

    docker-compose logs -f documentserver

Opzione 2. Utilizzo del file di configurazione log4js​

Per avviare ONLYOFFICE Docs in modalità debug:

  1. Apri il file di configurazione log4js. Il percorso del file dipende dal sistema operativo che utilizzi:

    • Per Windows - C:\Program Files\ONLYOFFICE\DocumentServer\config\log4js\production.json
    • Per Linux - /etc/onlyoffice/documentserver/log4js/production.json
    • Per Docker - /etc/onlyoffice/documentserver/log4js/production.json (all'interno del container Docker)

  2. Fai riferimento al seguente blocco di codice

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

  3. Cambia il valore level da "WARN" a "DEBUG".

  4. Salva le modifiche nel file di configurazione production.json.

  5. Applica le modifiche eseguendo il seguente comando:

    Linux

    systemctl restart ds-*

    Docker

    supervisorctl restart all

    Oppure riavvia il servizio ONLYOFFICE DocumentServer Proxy per Windows:

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

  6. I log sono memorizzati nelle seguenti posizioni (a seconda del tipo di installazione):

    • Per Windows - C:\Program Files\ONLYOFFICE\DocumentServer\Log
    • Per Linux - /var/log/onlyoffice/documentserver
    • Per Docker - /var/log/onlyoffice/documentserver (all'interno del container Docker) e /app/onlyoffice/DocumentServer/logs/documentserver (sull'host se monti il volume)