GPU 管理命令行工具（MTGMI）

GPU 管理命令行工具（MT GPU Management Instrument，MTGMI）通过 mthreads-gmi 命令查询、监控和管理摩尔线程 GPU。该工具通常随 GPU 驱动程序安装，适合系统管理员、开发者和现场支持人员在主机上快速确认设备状态、收集运行信息和定位常见问题。

能力概览

mthreads-gmi 按命令提供以下功能：

• 设备查询与状态监控：查看 GPU 清单、设备属性、利用率、温度、功率和时钟等信息；
• 持续采集与输出：按 GPU 查询，持续采集信息，并将结果保存为文件或 JSON；
• 进程、拓扑与互联信息：查看 GPU 进程、设备拓扑、P2P 和 MTLink 状态；
• 资源与会话管理：在支持的环境中查询和管理 MPC、vGPU 及视频编解码会话。

---

使用场景

• 安装后确认：部署驱动或 GPU 节点后，确认工具已安装、GPU 已被识别且设备状态正常。
• 日常巡检和监控：定期采集 GPU 利用率、温度、功率、进程和拓扑信息，辅助节点运维和资源管理。
• 故障初步定位：设备不可见、作业异常或性能异常时，保存设备、进程和互联信息，为后续诊断和问题上报提供现场数据。
• 自动化运维：以 JSON 或文件输出对接脚本、监控系统和集群管理工具。

---

快速入门

• 确认工具和 GPU：先确认命令可用，再列出设备和 UUID。

  command -v mthreads-gmi
  mthreads-gmi --list-gpus

• 查询并保存状态：查询单块 GPU，或持续采集并保存所有 GPU 的信息。

  mthreads-gmi --query -i 0
  mthreads-gmi --query -l 10 -f mthreads-gmi-query.log
  mthreads-gmi --query --json

---

相关文档

• 使用手册：查看完整命令、参数、示例和版本变更。
• 常见问题（FAQ）：处理安装、查询、容器、vGPU 和故障上报问题。
• 版本说明：确认当前版本的环境要求和变更。
• GPU 故障排查规范：保存现场、分流问题并提交诊断证据。
• GPU 管理库（MTML）：通过编程接口将 GPU 管理能力集成到应用或服务中。