检查 Codelab

贡献者:cphoenix@、crjohns@、miguelfrde@

在此 Codelab 中,Rust 和 C++ 程序员将学习如何使用 Inspect 库从程序发布诊断信息,以及如何使用 Inspect 信息调试程序。

什么是 Inspect?

借助检查,Fuchsia 组件可以显示有关其当前状态的结构化分层信息。

如需详细了解 Inspect,请参阅 Fuchsia 组件检查文档。

Inspect 具有哪些优势?

组件检查支持很多用例,包括:

  • 调试

    查看“检查来自正在运行的组件的数据”以找出问题。例如,您可以了解组件当前是否连接到依赖项。

  • 监控系统运行状况

    检查数据有助于深入了解系统的整体状态。例如,您可以了解系统未连接到互联网的原因。

  • 收集使用情况或性能统计信息

    您可以同时从多个组件读取检查数据,以了解系统性能。例如,您可以查看组件的传入连接列表以及组件的内存用量。

我可以在 Inspect 中存储哪些类型的信息?

由您决定在“检查”中公开的数据的结构和内容。下面列举了几款带心率传感器的手表:

  • 打开的 Wi-Fi 连接数量。
  • 节目已处理的请求数量。
  • 解析器遇到的错误数量。
  • 数据结构的内容。

API 参考文档

C++

检查库文档

Rust

fuchsia-inspect crate 文档

Codelab

在此 Codelab 中,您将修改程序以输出 Inspect 数据。 您将了解:

  • 如何添加 Inspect 库。

  • 如何在组件中初始化 Inspect。

  • 如何通过写入和读取 Inspect 数据来解决实际 bug。

  • 如何读取检查数据以验证您的程序是否执行所需操作。

所需条件

  • 具备 Rust 或 C++ 的基础知识。
  • 能够访问可在其中执行构建命令的 Fuchsia 源代码树。

开始