ascendai/npu-exporter

集群调度组件 NPU Exporter

镜像概述

NPU Exporter是MindCluster集群调度组件，部署在计算节点上，用于报告Ascend AI处理器的各类芯片数据指标，并支持Prometheus和Telegraf监控集成。

核心功能

• 从驱动获取芯片及网络数据指标；
• 适配Prometheus钩子函数，提供标准接口供Prometheus服务调用；
• 适配Telegraf钩子函数，提供标准接口供Telegraf服务调用；
• 支持实时监控Ascend AI处理器的利用率、温度、电压、内存等数据指标；
• 支持监控虚拟NPU（vNPU）的AI Core利用率、总内存及已用内存；
• 支持自定义指标开发——用户可通过提供的示例开发自定义指标插件。

使用场景

在任务执行过程中，除芯片故障外，常需监控芯片网络与计算利用率以识别性能瓶颈、找到优化任务性能的方向。MindCluster提供部署在计算节点的NPU Exporter组件，用于报告各类芯片数据指标。

配置说明

上下游依赖

1. 从驱动获取芯片及网络信息并存储到本地缓存；
2. 从K8s标准CRI接口获取容器信息并存储到本地缓存；
3. 实现Prometheus或Telegraf接口，供周期性检索缓存数据。

支持的标签与Dockerfile链接

标签约定

标签格式为 <version>-<os>，各字段说明如下：

NPU Exporter 26.1.0

快速开始

前提条件

软件依赖

硬件要求

本地构建

bash
docker build --no-cache -t npu-exporter:{tag} ./ -f Dockerfile.{os}

注意：

• TARGETPLATFORM是Docker BuildKit提供的全局内置参数，用于获取当前构建的目标平台（如linux/amd64、linux/arm64）；
• 仅当BuildKit启用时自动注入该变量，旧版Docker或未启用BuildKit的环境中不可用。执行构建命令前可临时启用：export DOCKER_BUILDKIT=1。

部署NPU Exporter

1. 拉取镜像

bash
docker pull swr.cn-south-1.myhuaweicloud.com/ascendhub/npu-exporter:{tag}

2. 重新打标签

bash
docker tag swr.cn-south-1.myhuaweicloud.com/ascendhub/npu-exporter:{tag} npu-exporter:{tag}

3. 启动NPU Exporter 将npu-exporter-{version}.yaml文件中的{tag}替换为实际镜像标签，执行：

bash
kubectl apply -f npu-exporter-{version}.yaml

4. 验证部署

bash
kubectl get pods -A | grep npu-exporter

5. 访问监控指标

bash
curl http://<pod-ip>:8082/metrics

支持的硬件

关于支持的Ascend硬件型号，请参考官方文档：支持的产品形态和OS列表

许可证

查看镜像中包含的Mind系列软件的https://www.hiascend.com/document/detail/en/mindcluster/600/clustersched/introduction/schedulingsd/mxdlug_005.html。 与所有容器镜像一样，预安装的软件包（Python、系统库等）可能受其各自许可协议约束。