OnlyOffice状态监控与日志查看方法

本文系统介绍了五种实用且互补的OnlyOffice Document Server状态监控与日志排查方法——从快速查看Docker容器实时日志、深入容器内分析本地日志文件，到启用DEBUG级别获取底层运行细节，再到分别验证ds-converter、ds-docservice等核心服务进程状态，以及精准定位并追踪converter.out.log等关键out.log专用输出日志；无论您是刚部署遇到服务异常，还是在生产环境中持续运维，这些方法都能帮助您高效诊断组件是否正常运行、快速定位崩溃根源（如内存溢出或段错误），真正实现对OnlyOffice服务健康状况的全面掌控。

如果您部署了OnlyOffice Document Server，但无法确认其内部服务是否全部正常运行，则需要通过日志输出和状态检查手段验证各组件工作状况。以下是监控OnlyOffice服务状态并查看日志的多种方法：

一、使用docker logs命令实时查看容器日志

该方法适用于Docker部署场景，直接捕获容器标准输出与错误流，是最快捷的状态观察方式。

1、执行docker ps命令，查找OnlyOffice容器的名称或ID。

2、运行docker logs -f ，持续输出日志流。

3、如需仅查看最近100行日志，使用docker logs --tail 100 -f 。

4、按Ctrl + C可中断实时日志输出。

二、进入容器内部查看本地日志文件

该方法可访问容器内持久化存储的日志路径，适用于需分析历史记录、排查特定时间点问题的情形。

1、执行docker ps获取运行中OnlyOffice容器的ID或名称。

2、运行docker exec -it /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 /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即表明服务已崩溃，需立即检查资源分配。

好了，本文到此结束，带大家了解了《OnlyOffice状态监控与日志查看方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！