jax.profiler.trace

内容

jax.profiler.trace#

jax.profiler.trace(log_dir, create_perfetto_link=False, create_perfetto_trace=False)[source]#

上下文管理器用于执行分析器跟踪。

该跟踪将捕获 CPU、GPU 和/或 TPU 活动,包括 Python 函数和 JAX 设备上的操作。

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

一次只能收集一个跟踪。如果在另一个跟踪正在运行时启动跟踪,则将引发 RuntimeError。

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

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

  • create_perfetto_trace – 如果为真,则额外转储一个与 Perfetto 跟踪查看器 UI (https://ui.perfetto.dev) 兼容的 perfetto_trace.json.gz 文件。如果 create_perfetto_link 为真,也会生成该文件。如果你想生成一个与 Perfetto 兼容的跟踪文件而又不阻塞进程,这将非常有用。