如何开启 Debug 日志
排查米家拉流、HomeKit 配对、摄像头转码等问题时,开发者常会要一份 更细的 Olink 运行日志。默认级别可能不够,需要把 log4rs.yaml 里的 root 级别改成 debug。
找到配置文件
日志由 log4rs 控制。配置文件名是:
text
log4rs.yaml常见位置(与 data 目录同级,在安装根目录下):
| 部署方式 | 典型路径 |
|---|---|
| 旗舰板 / 本机安装 | /opt/olink/log4rs.yaml(旁边是 /opt/olink/data/) |
| 工作目录运行 | 进程工作目录下的 log4rs.yaml(同级有 data/) |
| Docker | 以实际挂载为准,常见在容器内与 /data 配套的安装目录,或映射进来的 log4rs.yaml |
进安装目录后可先确认:
bash
ls /opt/olink/log4rs.yaml
ls /opt/olink/data/log/仓库里的参考文件与线上结构一致,可见项目中的 log4rs.yaml(root.level、滚动日志路径等)。
改成 Debug 级别
用编辑器打开 log4rs.yaml,找到文件靠后的 root: 段,把 level 设为 debug:
yaml
root:
level: debug
appenders:
- stdout
- rolling_appender若原来是 info / warn,改成 debug 即可。保存文件后 必须重启 Olink,新级别才会生效:
bash
sudo systemctl restart olink(Docker 则重启对应容器。)不要只改文件空等——改完不重启,日志级别通常仍是旧的。
说明:
- 个别模块在
loggers:下另有级别(如压成info);root 改成 debug 后,未单独覆盖的模块会按 debug 输出。 - Debug 日志量大,占磁盘也快;问题复现完建议改回
info并再次重启,或只在短时排查时打开。
日志写在哪里
默认滚动日志在 data 目录下,例如:
text
data/log/current.log
data/log/archive/app_*.log板子上多为:
text
/opt/olink/data/log/current.log复现问题后,把该时段的 current.log(或对应归档)交给开发者;若同时有 iOS 日志 或摄像头 输入抓取,一并附上更好。