Update FAQ documentation to include log collection and saving instructions

This commit is contained in:
slz
2026-02-05 14:22:57 +08:00
parent 9c505f5581
commit f8bd740dc1
2 changed files with 24 additions and 8 deletions
+12 -4
View File
@@ -25,11 +25,19 @@ If the camera node crashes unexpectedly, it will generate a crash log in the cur
- To make this change permanent, check [this link](https://github.com/OpenKinect/libfreenect2/issues/807). - To make this change permanent, check [this link](https://github.com/OpenKinect/libfreenect2/issues/807).
### Additional Troubleshooting ### How to Collect and Save Logs
- If you encounter other issues, set the `log_level` parameter to `debug`. This will generate an SDK log file in the running directory: `Log/OrbbecSDK.log.txt`. Please provide this file to the support team for further assistance. 1. **SDK debug logs**
- If firmware logs are required, set the `log_level` parameter to `debug` and set `enable_heartbeat` to `true` to activate this feature. Set the launch parameter `log_level` to `debug`. After running, the SDK will generate log files in the `Log/` folder under the current project directory. If you want a more recognizable file name for this test, you can set the parameter `log_file_name`.
- If you set the `log_level` parameter to `debug` and do not want the terminal to refresh too many logs, you can change `output="screen"` to `output="log"` in `launch`, and the logs will be saved in the `~/.ros/log` directory.
> SDK logs are appended to the same file: multiple launches will continue writing into the same log file.
> Recommendation: before packaging logs to send to technical support, delete old log files, then reproduce the issue and collect new logs. This keeps the logs cleaner and makes troubleshooting more accurate.
2. **ROS 2 logs (`~/.ros/log`)**
In the launch file, set the node (or composable node container) parameter `output` to `"log"` to save ROS 2 logs locally.
> After setting `output="log"`, ROS 2 logs will be stored in the `~/.ros/log/` directory.
> When submitting an issue, please package both the SDK logs under the `Log/` directory and the corresponding ROS 2 logs under `~/.ros/log/` for the same time period.
### Why Are There So Many Launch Files? ### Why Are There So Many Launch Files?
+12 -4
View File
@@ -25,11 +25,19 @@
- 要使此更改永久生效,请查看[此链接](https://github.com/OpenKinect/libfreenect2/issues/807)。 - 要使此更改永久生效,请查看[此链接](https://github.com/OpenKinect/libfreenect2/issues/807)。
### 其他故障排除 ### 如何采集和保存日志
- 如果遇到其他问题,将 `log_level` 参数设置为 `debug`。这将在运行目录中生成SDK日志文件:`Log/OrbbecSDK.log.txt`。请将此文件提供给支持团队以获得进一步帮助。 1. **SDK debug 日志**
- 如果需要固件日志,将`log_level` 参数设置为 `debug`的同时,将 `enable_heartbeat` 设置为 `true` 以激活此功能。 将 launch 参数 `log_level` 设为 `debug` 运行后,会在当前工程目录下的 `Log/` 文件夹中生成 SDK 日志文件。如果需要为本次测试指定一个更易识别的日志文件名,可以修改参数 `log_file_name`。
- 若将`log_level` 参数设置为 `debug`的同时,又不想终端刷新太多日志,可以在`launch`中将`output="screen"`改为`output="log"`,日志会被保存在`~/.ros/log`目录下。
> SDK 日志是追加写入的:多次启动会在同一个文件里不断累积日志。
> 建议:在准备打包日志发给技术支持前,先删除旧的日志文件,然后重新复现问题并采集新的日志,这样日志更干净、定位更准确。
2. **ROS2 日志(~/.ros/log)**
在 launch 文件中,将节点(或可组合节点容器)的 `output` 参数设为 `"log"`,即可将 ROS2 日志保存到本地:
> 设置为 `output="log"` 后,ROS2 日志将保存在 `~/.ros/log/` 目录下。
> 如需提交问题,请同时打包 `Log/` 目录下的 SDK 日志和 `~/.ros/log/` 下对应时间的 ROS2 日志,一并提供。
### 为什么有这么多启动文件? ### 为什么有这么多启动文件?