快捷方式

CUDA 流分析器

注意

这是一个原型功能,这意味着它处于早期阶段,用于反馈和测试,其组件可能会发生变化。

概述

此模块介绍了 CUDA 流分析器,这是一个用于检测在不同流上运行的内核之间的同步错误的工具。

它存储有关对张量访问的信息,以确定它们是否已同步。如果在 python 程序中启用它,并检测到可能的竞争条件,则会打印详细的警告,程序将退出。

可以通过导入此模块并调用 enable_cuda_sanitizer() 或通过导出 TORCH_CUDA_SANITIZER 环境变量来启用它。

用法

以下是一个在 PyTorch 中出现简单同步错误的示例

import torch

a = torch.rand(4, 2, device="cuda")

with torch.cuda.stream(torch.cuda.Stream()):
    torch.mul(a, 5, out=a)

张量 a 在默认流上初始化,并在没有任何同步方法的情况下在一个新流上修改。这两个内核将在同一个张量上并发运行,这可能会导致第二个内核在第一个内核能够写入之前读取未初始化的数据,或者第一个内核可能会覆盖第二个内核的结果的一部分。当在命令行上运行此脚本时,使用

TORCH_CUDA_SANITIZER=1 python example_error.py

CSAN 会打印以下输出

============================
CSAN detected a possible data race on tensor with data pointer 139719969079296
Access by stream 94646435460352 during kernel:
aten::mul.out(Tensor self, Tensor other, *, Tensor(a!) out) -> Tensor(a!)
writing to argument(s) self, out, and to the output
With stack trace:
  File "example_error.py", line 6, in <module>
    torch.mul(a, 5, out=a)
  ...
  File "pytorch/torch/cuda/_sanitizer.py", line 364, in _handle_kernel_launch
    stack_trace = traceback.StackSummary.extract(

Previous access by stream 0 during kernel:
aten::rand(int[] size, *, int? dtype=None, Device? device=None) -> Tensor
writing to the output
With stack trace:
  File "example_error.py", line 3, in <module>
    a = torch.rand(10000, device="cuda")
  ...
  File "pytorch/torch/cuda/_sanitizer.py", line 364, in _handle_kernel_launch
    stack_trace = traceback.StackSummary.extract(

Tensor was allocated with stack trace:
  File "example_error.py", line 3, in <module>
    a = torch.rand(10000, device="cuda")
  ...
  File "pytorch/torch/cuda/_sanitizer.py", line 420, in _handle_memory_allocation
    traceback.StackSummary.extract(

这提供了对错误来源的广泛了解

  • 一个张量从 id 为 0(默认流)和 94646435460352(新流)的流中被错误地访问

  • 张量是通过调用 a = torch.rand(10000, device="cuda") 分配的

  • 错误访问是由以下运算符引起的
    • a = torch.rand(10000, device="cuda") 在流 0 上

    • torch.mul(a, 5, out=a) 在流 94646435460352 上

  • 错误消息还显示了调用的运算符的模式,以及显示运算符的哪些参数对应于受影响的张量的注释。

    • 在示例中,可以看出张量 a 对应于调用运算符 torch.mul 的参数 selfoutoutput 值。

另请参见

可以在 此处 查看支持的 torch 运算符及其模式列表。

可以通过强制新流等待默认流来修复错误

with torch.cuda.stream(torch.cuda.Stream()):
    torch.cuda.current_stream().wait_stream(torch.cuda.default_stream())
    torch.mul(a, 5, out=a)

再次运行脚本时,没有错误报告。

API 参考

torch.cuda._sanitizer.enable_cuda_sanitizer()[源代码]

启用 CUDA 流分析器。

分析器将开始分析 torch 函数调用的低级 CUDA 调用,以查找同步错误。所有发现的数据竞争都将与疑似原因的堆栈跟踪一起打印到标准错误输出。为了获得最佳结果,应在程序开始时启用分析器。

文档

访问 PyTorch 的全面开发者文档

查看文档

教程

获取针对初学者和高级开发者的深入教程

查看教程

资源

查找开发资源并获得问题的解答

查看资源