JSON 跟踪配置文件

报告问题 查看来源 每晚 · 7.4。 ,了解所有最新动态。 7.3 · 7.2 · 7.1 · 7.0 · 6.5

JSON 轨迹配置文件非常有用,可帮助您快速了解 Bazel 在调用期间花费了时间在哪些方面。

默认情况下,对于所有类似于构建的命令和查询,Bazel 都会将此类配置文件写入 command.profile.gz。您可以配置是否使用 --generate_json_trace_profile 标记以及通过 --profile 标志。以 .gz 结尾的位置信息会使用 GZIP 进行压缩。使用标志 --experimental_announce_profile_path 将此文件的路径输出到日志。

工具

您可以将此配置文件加载到 chrome://tracing,也可以使用其他工具对其进行分析和后处理。

chrome://tracing

如需直观呈现配置文件,请在 Chrome 浏览器标签页中打开 chrome://tracing,点击“加载”,然后选择(可能已压缩的)配置文件。有关 请点击左下角的方框。

配置文件示例:

示例配置文件

图 1. 个人资料示例。

您可以使用以下键盘控件进行导航:

  • 1 即可选择“选择”模式。在此模式下,您可以选择特定框以检查事件详情(请参阅左下角)。选择多个活动可获取摘要和汇总统计信息。
  • 2 即可进入“平移”模式。然后,拖动鼠标即可移动视图。您还可以使用 a/d 向左/向右移动。
  • 3 可进行“缩放”模式。然后拖动鼠标即可缩放。您还可以使用 w/s 放大/缩小。
  • 4 即可选择“计时”在这个模式下,你可以测量距离 两个事件之间的时间间隔
  • ? 可了解所有控件。

bazel analyze-profile

Bazel 子命令 analyze-profile 会使用配置文件格式,并针对每个构建阶段的不同任务类型输出累计统计信息以及对关键路径的分析。

例如,命令

$ bazel build --profile=/tmp/profile.gz //path/to:target
...
$ bazel analyze-profile /tmp/profile.gz

可能生成以下形式的输出:

INFO: Profile created on Tue Jun 16 08:59:40 CEST 2020, build ID: 0589419c-738b-4676-a374-18f7bbc7ac23, output base: /home/johndoe/.cache/bazel/_bazel_johndoe/d8eb7a85967b22409442664d380222c0

=== PHASE SUMMARY INFORMATION ===

Total launch phase time         1.070 s   12.95%
Total init phase time           0.299 s    3.62%
Total loading phase time        0.878 s   10.64%
Total analysis phase time       1.319 s   15.98%
Total preparation phase time    0.047 s    0.57%
Total execution phase time      4.629 s   56.05%
Total finish phase time         0.014 s    0.18%
------------------------------------------------
Total run time                  8.260 s  100.00%

Critical path (4.245 s):
       Time Percentage   Description
    8.85 ms    0.21%   _Ccompiler_Udeps for @local_config_cc// compiler_deps
    3.839 s   90.44%   action 'Compiling external/com_google_protobuf/src/google/protobuf/compiler/php/php_generator.cc [for host]'
     270 ms    6.36%   action 'Linking external/com_google_protobuf/protoc [for host]'
    0.25 ms    0.01%   runfiles for @com_google_protobuf// protoc
     126 ms    2.97%   action 'ProtoCompile external/com_google_protobuf/python/google/protobuf/compiler/plugin_pb2.py'
    0.96 ms    0.02%   runfiles for //tools/aquery_differ aquery_differ

Bazel 调用分析器

开源 Bazel Invocation Analyzer 会使用配置文件格式,并输出有关如何提升 build 性能的建议。您可以使用其 CLI 或在 https://analyzer.engflow.com 上执行此分析。

jq

jq 类似于 JSON 数据的 sed。使用 jq 提取本地操作执行中沙盒创建步骤的所有时长的示例:

$ zcat $(../bazel-6.0.0rc1-linux-x86_64 info output_base)/command.profile.gz | jq '.traceEvents | .[] | select(.name == "sandbox.createFileSystem") | .dur'
6378
7247
11850
13756
6555
7445
8487
15520
[...]

资料信息

配置文件包含多个行。通常,大部分行代表 Bazel 线程及其对应的事件,但也包含一些特殊行。

包含的特殊行取决于在 配置文件已创建,并可通过不同的标志进行自定义。

图 1 显示了使用 Bazel v5.3.1 创建的配置文件,其中包含以下行:

  • action count:显示正在执行的并发操作数。点击该值即可查看实际值。应最高为 清理完毕:--jobs build。
  • CPU usage (Bazel):在构建过程中的每一秒,显示 Bazel 使用的 CPU(值为 1 表示一个核心处于 100% 繁忙状态)。
  • Critical Path:针对关键路径上的每个操作显示一个块。
  • Main Thread:Bazel 的主线程。有助于大致了解 Bazel 正在执行的操作,例如“Launch Blaze”“evaluateTargetPatterns”和“runAnalysisPhase”。
  • Garbage Collector:显示次要和主要垃圾回收 (GC) 暂停。

常见的性能问题

分析性能配置文件时,请查找以下内容:

  • 分析阶段 (runAnalysisPhase) 的速度比预期慢,尤其是在增量 build 上。这可能表明规则实施效果不佳, 软件包加载可能会 过多的目标、复杂的宏或递归的 glob。
  • 个别操作运行缓慢,尤其是关键路径上的操作。您或许可以将大型操作拆分为多个较小的操作,或者减少一组(传递)依赖项,以加快操作速度。此外,请检查非 PROCESS_TIME 是否异常偏高(例如 REMOTE_SETUPFETCH)。
  • 瓶颈,即少数线程处于忙碌状态,而所有其他线程处于空闲/等待结果状态(请参阅图 1 中的 22 秒和 29 秒左右)。若要对此进行优化,很可能需要修改规则实现或 Bazel 本身,以引入更多并行性。如果 GC 次数异常多,也可能会发生这种情况。

配置文件格式

顶级对象包含元数据 (otherData) 和实际跟踪数据 (traceEvents)。元数据包含额外信息,例如调用 ID Bazel 调用的日期和日期

示例:

{
  "otherData": {
    "build_id": "101bff9a-7243-4c1a-8503-9dc6ae4c3b05",
    "date": "Wed Oct 26 08:22:35 CEST 2022",
    "profile_finish_ts": "1677666095162000",
    "output_base": "/usr/local/google/_bazel_johndoe/573d4be77eaa72b91a3dfaa497bf8cd0"
  },
  "traceEvents": [
    {"name":"thread_name","ph":"M","pid":1,"tid":0,"args":{"name":"Critical Path"}},
    ...
    {"cat":"build phase marker","name":"Launch Blaze","ph":"X","ts":-1306000,"dur":1306000,"pid":1,"tid":21},
    ...
    {"cat":"package creation","name":"foo","ph":"X","ts":2685358,"dur":784,"pid":1,"tid":246},
    ...
    {"name":"thread_name","ph":"M","pid":1,"tid":11,"args":{"name":"Garbage Collector"}},
    {"cat":"gc notification","name":"minor GC","ph":"X","ts":825986,"dur":11000,"pid":1,"tid":11},
    ...
    {"cat":"action processing","name":"Compiling foo/bar.c","ph":"X","ts":54413389,"dur":357594,"pid":1,"args":{"mnemonic":"CppCompile"},"tid":341},
 ]
}

轨迹事件中的时间戳 (ts) 和时长 (dur) 以微秒为单位。类别 (cat) 是 ProfilerTask 的枚举值之一。请注意,如果某些事件非常短且彼此相近,系统会将它们合并在一起;如果您想防止事件合并,请传递 --noslim_json_profile

另请参阅 Chrome 跟踪事件格式规范