Habilitar el registro de depuración en ONLYOFFICE Docs

Visión general

En ciertos casos, es necesario ejecutar ONLYOFFICE Docs en modo de depuración, por ejemplo, para solucionar problemas de rendimiento, inspeccionar registros o recopilar información para soporte.

Existen dos opciones para iniciar ONLYOFFICE Docs en modo de depuración.

Opción 1. Usar la variable de entorno (solo Docker)

Si estás gestionando el contenedor de ONLYOFFICE Docs a través de Docker o Docker Compose, es preferible usar una variable de entorno para habilitar el nivel de registro de depuración:

Docker

Establece la variable de entorno con docker run:

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

Reinicia el contenedor si ya está en ejecución:
```
docker restart <container>
```
Los registros se pueden ver con:
```
docker logs -f <container>
```

Docker Compose

Establece la variable de entorno en docker-compose.yml al ejecutar el contenedor:

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

Inicia Docker Compose:
```
docker-compose up -d
```
Reinicia el contenedor si ya está en ejecución:
```
docker-compose restart documentserver
```
Los registros se pueden ver con:
```
docker-compose logs -f documentserver
```

Opción 2. Usar el archivo de configuración log4js

Para iniciar ONLYOFFICE Docs en modo de depuración:

Abre el archivo de configuración log4js. La ruta al archivo depende del sistema operativo que uses:
- Para Windows - C:\Program Files\ONLYOFFICE\DocumentServer\config\log4js\production.json
- Para Linux - /etc/onlyoffice/documentserver/log4js/production.json
- Para Docker - /etc/onlyoffice/documentserver/log4js/production.json (dentro del contenedor Docker)

Consulta el siguiente bloque de código

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

Cambia el valor de level de "WARN" a "DEBUG".
Guarda los cambios en el archivo de configuración production.json.
Aplica los cambios ejecutando el siguiente comando:

Linux
systemctl restart ds-*
Docker
supervisorctl restart all
O reinicia el servicio ONLYOFFICE DocumentServer Proxy para Windows:
```
net stop DsProxySvc net start DsProxySvc net stop DsConverterSvc net start DsConverterSvc net stop DsDocServiceSvc net start DsDocServiceSvc
```
Los registros se almacenan en las siguientes ubicaciones (dependiendo del tipo de instalación):
- Para Windows - C:\Program Files\ONLYOFFICE\DocumentServer\Log
- Para Linux - /var/log/onlyoffice/documentserver
- Para Docker - /var/log/onlyoffice/documentserver (dentro del contenedor Docker) y /app/onlyoffice/DocumentServer/logs/documentserver (en el host si montas el volumen)