问题排查工具参考文档

本页旨在指导用户找到能够解决 Fuchsia 开发者可能会遇到的常见问题的工具。

问题

  • 我想了解组件在运行时的活动。

    • 检查

      • 公开组件的结构化状态。即时监控组件的状态。 借助检查工具，组件可以显示类型化键值对的任意层次结构，并在执行过程中对其进行更新。在该组件仍在运行时，可截取和查看这些数据的快照。 检查通常用于表示关于组件工作集和近期历史记录的信息，以帮助调试。 组件作者使用 Inspect 的方式是，依赖于采用所选语言的库（目前支持 Rust、C++ 和 Dart），并调用适当的方法来改变其记录的状态。 可以使用 ffx component inspect 工具或 ffx target snapshot 读取检查数据。

    • 日志

      • 在组件执行期间输出字符串日志。 与许多系统一样，Fuchsia 支持基本的字符串日志记录，以便在执行特定源代码行时记录一些信息。 日志按 Archivist 组件汇总。可以使用“ffx log”读取这些日志。

    • 结构化日志

      • 在日志消息中存储结构化键值对。 除了基于文本的日志之外，Fuchsia 还支持编码为类型化键值对层次结构的全结构化日志记录。开发者可以使用 Rust 中的 tracing crate 宏或 C++ 中的 FX_SLOG 宏写入结构化日志。

  • 我想在特定条件下自动触发快照拍摄

    • 检测

      • 检测扫描。检查设备上的数据，以决定何时提交崩溃报告。 检测扫描使用分类语言配置，并且每隔几分钟运行一次。

    • 分类

      • 分类功能会选择和处理“诊断”数据中的值，从而在设备端和设备外生成有用的操作和数据洞见。 分类可以：显示计算值；文件快照（当作为 Detect 引擎在设备上运行时）；以及输出有关偏离标称值的警告。

  • 我想自动对快照进行后处理，以识别值得注意的值或错误情况

    • 分类

      • 分类功能会选择和处理“诊断”数据中的值，从而在设备端和设备外生成有用的操作和数据洞见。 分类可以：显示计算值；文件快照（当作为 Detect 引擎在设备上运行时）；以及输出有关偏离标称值的警告。

工具

  • 公开组件的结构化状态。即时监控组件的状态。 借助检查工具，组件可以显示类型化键值对的任意层次结构，并在执行过程中对其进行更新。在该组件仍在运行时，可截取和查看这些数据的快照。 检查通常用于表示关于组件工作集和近期历史记录的信息，以帮助调试。 组件作者使用 Inspect 的方式是，依赖于采用所选语言的库（目前支持 Rust、C++ 和 Dart），并调用适当的方法来改变其记录的状态。 可以使用 ffx component inspect 工具或 ffx target snapshot 读取检查数据。

    Inspect 可以解决的问题：

    • 我想了解组件在运行时的活动。
    • 分类

  • 在组件执行期间输出字符串日志。 与许多系统一样，Fuchsia 支持基本的字符串日志记录，以便在执行特定源代码行时记录一些信息。 日志按 Archivist 组件汇总。可以使用“ffx log”读取这些日志。

    日志可以解决的问题：

    • 我想了解组件在运行时的活动。
    • 结构化日志

  • 在日志消息中存储结构化键值对。 除了基于文本的日志之外，Fuchsia 还支持编码为类型化键值对层次结构的全结构化日志记录。开发者可以使用 Rust 中的 tracing crate 宏或 C++ 中的 FX_SLOG 宏写入结构化日志。

    结构化日志可以解决的问题：

    • 我想了解组件在运行时的活动。

  • 持久性操作会存储检查数据，并在后续启动时发布检查数据。 有时，在设备重新启动之前（例如网络出现问题时），才能从设备导出诊断数据。保留功能会将所选的检查数据写入磁盘，然后在下次启动时将其发布回 Inspect。

    持久性可以解决的问题：

    • 检查

  • 采样器从 Inspect 中读取数据，并将其转发到 Cobalt。 采样器提供了一种将数据发送到 Cobalt 的简单方法。您无需将应用关联到 Cobalt 服务并直接使用它，只需在 Inspect 中发布数据并编写一个简单的配置文件条目，即可告知 Sampler 提取您的数据并将其发送到 Cobalt。

    采样器可以解决的问题：

    • 检查

  • 分类功能会选择和处理“诊断”数据中的值，从而在设备端和设备外生成有用的操作和数据洞见。 分类可以：显示计算值；文件快照（当作为 Detect 引擎在设备上运行时）；以及输出有关偏离标称值的警告。

    分类可以解决的问题：

    • 我想在特定条件下自动触发快照拍摄
    • 我想自动对快照进行后处理，以识别值得注意的值或错误情况
    • 检查
    • 检测

  • 检测扫描。检查设备上的数据，以决定何时提交崩溃报告。 检测扫描使用分类语言配置，并且每隔几分钟运行一次。

    检测可以解决的问题：

    • 我想在特定条件下自动触发快照拍摄
    • 检查
    • 分类