Skip to content

如何开启 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 日志 或摄像头 输入抓取,一并附上更好。

相关文档 ​