可通过五种方法监控OnlyOffice服务状态并查看日志:一、用docker logs实时查看容器日志;二、进入容器查看/var/log/onlyoffice/documentserver下本地日志文件;三、启用DEBUG日志级别获取详细信息;四、检查ds-converter、ds-docservice等关键服务进程状态;五、定位并追踪converter.out.log等专用out.log文件。

如果您部署了OnlyOffice Document Server,但无法确认其内部服务是否全部正常运行,则需要通过日志输出和状态检查手段验证各组件工作状况。以下是监控OnlyOffice服务状态并查看日志的多种方法:
一、使用docker logs命令实时查看容器日志
该方法适用于Docker部署场景,直接捕获容器标准输出与错误流,是最快捷的状态观察方式。
1、执行docker ps命令,查找OnlyOffice容器的名称或ID。
2、运行docker logs -f <container_name_or_id>,持续输出日志流。
3、如需仅查看最近100行日志,使用docker logs --tail 100 -f <container_name_or_id>。
4、按Ctrl + C可中断实时日志输出。
二、进入容器内部查看本地日志文件
该方法可访问容器内持久化存储的日志路径,适用于需分析历史记录、排查特定时间点问题的情形。
1、执行docker ps获取运行中OnlyOffice容器的ID或名称。
2、运行docker exec -it <container_id> /bin/bash进入容器终端。
3、切换至日志目录:cd /var/log/onlyoffice/documentserver。
4、列出日志文件:ls -l,常见文件包括converter.out.log、docservice.out.log、storage.out.log等。
5、查看某日志内容:cat docservice.out.log 或使用tail -n 50 docservice.out.log查看末尾50行。
三、启用调试日志级别以获取更详细信息
默认日志级别为INFO或WARN,启用DEBUG可暴露服务初始化、连接建立、请求处理等底层细节,便于深度排障。
1、若使用Docker部署,启动容器时添加环境变量:-e DS_LOG_LEVEL=DEBUG。
2、若容器已运行,修改docker-compose.yml中environment字段,加入- DS_LOG_LEVEL=DEBUG,再执行docker-compose restart documentserver。
3、若为非Docker安装(Linux),编辑/etc/onlyoffice/documentserver/log4js/production.json,将"level": "WARN"改为"level": "DEBUG"。
4、保存后执行systemctl restart ds-*重启所有Document Server服务。
注意:DEBUG日志量显著增大,生产环境启用后应及时恢复原级别。
四、检查关键服务进程状态
OnlyOffice Document Server由多个独立服务组成,需分别确认其运行状态,避免单点失效导致整体不可用。
1、在宿主机(Linux)上执行systemctl list-units | grep ds-,查看ds-converter、ds-docservice、ds-storage等服务是否处于active (running)状态。
2、对任一服务,运行systemctl status ds-docservice查看详细状态及最近失败原因。
3、若服务异常退出,检查其对应日志文件(如/var/log/onlyoffice/documentserver/docservice.out.log)中的ERROR或FATAL条目。
4、Windows环境下,打开“服务”管理器,确认DsDocServiceSvc、DsConverterSvc、DsProxySvc三项服务状态均为“正在运行”。
五、定位并查看out.log类专用输出日志
OnlyOffice各核心组件(如转换器、文档服务)会将标准输出重定向至独立的out.log文件,该类日志不经过log4js配置,始终保留原始启动与崩溃信息。
1、进入OnlyOffice容器:docker exec -it <container_id> /bin/bash。
2、执行find / -name "out.log" 2>/dev/null定位所有out.log文件路径。
3、典型路径包括:/var/log/onlyoffice/documentserver/converter.out.log、/var/log/onlyoffice/documentserver/docservice.out.log。
4、使用tail -f /var/log/onlyoffice/documentserver/converter.out.log实时追踪转换器输出。
关键提示:out.log中出现Segmentation fault或java.lang.OutOfMemoryError即表明服务已崩溃,需立即检查资源分配。


















