Questo articolo è stato tradotto dall’AI

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

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

Riavvia il container se è già in esecuzione:
```
docker restart <container>
```
I log possono essere visualizzati con:
```
docker logs -f <container>
```

Docker Compose

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"

Avvia Docker Compose:
```
docker-compose up -d
```
Riavvia il container se è già in esecuzione:
```
docker-compose restart documentserver
```
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:

Apri il file di configurazione log4js. Il percorso del file dipende dal sistema operativo utilizzato:
- 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)

Fai riferimento al seguente blocco di codice

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

Cambia il valore level da "WARN" a "DEBUG".
Salva le modifiche nel file di configurazione production.json.
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
```
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 (sul host se monti il volume)