a7e211ce创建于 22 天前历史提交

MindStudio Profiler Tools Interface

昇腾 Profiling 工具接口

📢 最新消息

[2026.02.06]：版本说明新增 26.0.0-alpha.1 发布记录，兼容 CANN > 8.5.0，详情请参见《版本说明》。

📌 简介

msPTI（MindStudio Profiler Tools Interface）是面向 Ascend 设备的 Profiling API 集合，帮助开发者为 NPU 应用构建性能采集与分析工具，适用于推理与训练场景。

msPTI 主要提供以下能力：

Tracing：采集 CANN API、Kernel、内存拷贝、通信、打点等时间戳及附加信息，用于定位执行链路中的性能瓶颈。
Profiling：单独采集一个或一组 Kernel 的 NPU 性能指标，支撑计算与通信分析。

🔍 目录结构

├─docs
│  └─zh                  # 中文文档、安装指南、版本说明、安全声明、API 参考
├─csrc                   # C/C++ 核心实现
│  ├─activity            # Activity 数据采集与解析
│  ├─callback            # Callback 订阅与回调管理
│  ├─common              # 公共基础能力
│  └─include             # msPTI C API 头文件
├─mspti                  # Python 封装
│  ├─monitor             # Kernel / HCCL / MSTX Monitor
│  └─csrc                # Python 扩展绑定实现
├─samples                # C++ / Python 样例
├─scripts                # 构建、打包、安装、测试脚本
├─test                   # UT / ST 测试代码
├─CMakeLists.txt         # C++ 构建入口
└─README.md              # 仓库总览

📖 功能介绍

模块	功能简介	文档
`Activity API`	采集 API、Kernel、Memory、HCCL、Marker、External Correlation 等活动数据，用于构建 Tracing / Profiling 工具。	C API 参考
`Callback API`	订阅 Runtime / HCCL 回调，在 API 调用前后执行自定义逻辑或关联采集数据。	C API 参考
`Python API`	提供 `KernelMonitor`、`HcclMonitor`、`MstxMonitor`、`CommunicationMonitor` 等接口，快速接入 Python 场景分析能力。	Python API 参考
`样例集`	覆盖 callback、activity、correlation、HCCL、Python monitor 等典型场景，便于快速上手。	样例说明 / 用户指南

🛠️ 安装指南

msPTI 运行依赖配套版本的 CANN 环境。安装 msPTI 前，请先完成以下环境准备：

硬件环境请参见《昇腾产品形态说明》。
软件环境请参见CANN快速安装安装配套版本的 CANN Toolkit 开发套件包和 ops 算子包。

完成上述准备后，可通过以下两种方式安装 msPTI：

方式一：从 releases 页面下载预构建的 run 包，执行 MD5 校验后安装。
方式二：从源码仓执行 bash scripts/build.sh [<version>] 先构建 run 包，再安装。

完整环境准备、两种安装方式的详细步骤、安装参数与示例命令请参见《msPTI 工具安装指南》。

🚀 快速入门

快速入门介绍msPTI工具的使用流程，具体请参见《msPTI快速入门》。

📝 相关说明

《安全声明》
LICENSE
Third_Party_Open_Source_Software_Notice
欢迎通过 Issues 和 Pull Request 参与贡献；提交前请完成本地自测并确保新增能力带有必要测试。

💬 建议与交流

欢迎大家为社区做贡献。如果有任何疑问或建议，请提交 Issues，我们会尽快回复。感谢你的支持。

诚邀参与满意度问卷调查抽取惊喜好礼😎。

💬 技术交流群	📢 官方公众号	🤝 更多加入渠道
_{扫码直接加入技术交流群}	_{扫码关注获取最新动态}	欢迎扫码关注技术交流群跟官方公众号。这里是 MindStudio 用户与开发者最快捷的交流阵地：快速提问：与社区小伙伴即时探讨技术问题掌握动态：第一时间获取版本发布与功能更新通知经验共享：与其他开发者交流最佳实践 🛠️ 其他渠道： 👉 昇腾助手： 👉 昇腾论坛：

🤝 致谢

msPTI 由华为昇腾计算 MindStudio 开发部贡献，感谢来自社区的每一个 PR，欢迎持续参与共建。

关于 MindStudio 团队

MindStudio 团队围绕昇腾开发场景持续建设训练、推理、性能分析等工具链能力。更多信息请访问昇腾社区和昇腾论坛。