⚡

DOCADPA高层追踪器Skill doca-dpa-hl-tracer

本技能指导用户使用 DOCA DPA 高层追踪器（doca_dpa_hl_tracer）捕获、解码和分析 DPA 编程事件层的高层踪迹，帮助定位 DPA 内核错误与性能瓶颈，覆盖 TRACE/CRIT 模式选择、JSON 配置调优、ELF 匹配解码以及空捕获/截断等常见故障诊断。关键词：DOCA DPA、高层追踪、doca_dpa_hl_tracer、DPA事件捕获、TRACE/CRIT、RDMA WR、同步点、BlueField、DPACC、DPA调试、性能分析、追踪配置、二进制解码、错误诊断。

调试工具 0 次安装 0 次浏览 更新于 9/6/2026
开源协议 Apache-2.0
名称 doca-dpa-hl-tracer
描述 当用户运行 doca_dpa_hl_tracer 捕获或解码 DPA 编程事件层（内核进入/退出、同步点、通信原语、RDMA WR 提交、完成排空）踪迹时使用，也用于选择 TRACE/CRIT 模式、调整 JSON 配置（文件大小限制策略、线程优先级/核绑定）、对照 DPA 侧 ELF 解码，以及诊断空捕获、噪声捕获、文件截断等问题。

DOCA DPA 高层追踪器

这是一个工具类技能，围绕主机侧 CLI doca_dpa_hl_tracer 提供操作指导。它从编程事件层捕获 DPA 侧执行轨迹，而不是原始周期计数。

用途

  • 定位 DPA 内核返回错误结果但主机侧完成正常的问题。
  • 分析 DPA 侧性能瓶颈：内核进入到首个通信原语、RDMA WR 提交到完成排空、同步点驻留时间等。
  • 在 TRACE 与 CRIT 捕获模式之间选择，平衡观测粒度与对 DPA 运行的额外延迟开销。
  • 调优 JSON 配置：log/bin 文件大小上限、file_size_limit_policy、接收线程/写文件线程的优先级和 CPU 亲和性。
  • 对照正确版本且匹配的 DPA 侧 ELF 解码二进制 trace 文件。
  • 排查空捕获、噪声捕获、运行中截断、版本不匹配等问题。

范围

  • 受众：已通过 doca-dpa 启动过 DPA 工作负载的开发者/运维/ AI agent。
  • 不覆盖：DPA 内核编程、DPA-Comms/DPA-Verbs 编程、原始 per-cycle 分析、主机侧 doca-dpa 调试、生产环境 DPA 遥测。
  • 配套文件：CAPABILITIES.md（事件分类、模式与开销、错误分类、版本兼容、安全策略），TASKS.md（install/configure/run/debug 等工作流）。

相关技能

doca-dpa、doca-debug、doca-public-knowledge-map、doca-version、doca-setup 等。