jax.profiler.start_trace

目录

jax.profiler.start_trace#

jax.profiler.start_trace(log_dir, create_perfetto_link=False, create_perfetto_trace=False)[源代码][源代码]#

开始一个性能分析跟踪。

跟踪将捕获 CPU、GPU 和/或 TPU 活动，包括 Python 函数和 JAX 设备操作。使用 stop_trace() 结束跟踪并将结果保存到 log_dir。

生成的跟踪结果可以使用 TensorBoard 查看。请注意，在收集跟踪时，TensorBoard 不需要运行。

一次只能收集一个跟踪。如果在另一个跟踪运行时调用 start_trace() ，将会引发 RuntimeError。

参数:

  • log_dir (os.PathLike | str) – 保存分析器跟踪的目录（通常是 TensorBoard 日志目录）。

  • create_perfetto_link (bool) – 一个布尔值，如果为真，则创建并打印指向 Perfetto 跟踪查看器 UI (https://ui.perfetto.dev) 的链接。程序将阻塞，直到链接被打开并且 Perfetto 加载跟踪。

  • create_perfetto_trace (bool) – 一个布尔值，如果为真，则会额外生成一个 perfetto_trace.json.gz 文件，该文件兼容 Perfetto 跟踪查看器 UI（https://ui.perfetto.dev）的上传。如果 create_perfetto_link 为真，也会生成该文件。如果你想在不阻塞进程的情况下生成一个兼容 Perfetto 的跟踪文件，这可能会很有用。

返回类型:

None

目录