kali20gakki/msAgent / skills/host-cpu/msagent-perf-cpu-config-audit
msagent-perf-cpu-config-audit
Verified昇腾训练/推理主机的环境配置体检:对 NUMA 亲和、大页/THP、governor 频率、cgroup 限流、IRQ smp_affinity、环境变量等 8 个配置域做单点快照审计,输出分级 Finding 与可回滚修改建议,不改动运行状态。触发:检查环境、配置体检、新机器开箱、换容器、 大页没配、governor 不对、cgroup 限流、中断亲和配置、NUMA 配置检查、绑核没生效。 不用于:训练变慢/step 抖动/利用率低的根因归因(→ perf-cpu-perf-triage); 产出绑核方案(→ perf-cpu-bind-tune);运行期实际落核观测(→ perf-cpu-tracing)。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.2 KB |
| references/check-items.md | markdown | 6.5 KB |
| references/process-roles.md | markdown | 1.7 KB |
| references/profiles/ascend910.json | config | 1.6 KB |
| references/profiles/kunpeng920-910b.json | config | 507 B |
| references/rules-locality.md | markdown | 2.3 KB |
| resources/report_template.html | other | 11.5 KB |
| scripts/audit.py | script | 19.6 KB |
| scripts/baseline.py | script | 4.4 KB |
| scripts/checker.py | script | 39.6 KB |
| scripts/classify.py | script | 2.7 KB |
| scripts/discover.py | script | 6.6 KB |
| scripts/npu_query.py | script | 15.0 KB |
| scripts/preflight.py | script | 3.3 KB |
| scripts/procfs.py | script | 9.0 KB |
| scripts/report.py | script | 6.4 KB |
| scripts/rules_locality.py | script | 8.7 KB |
| scripts/static_collect.py | script | 13.8 KB |
| scripts/topology.py | script | 9.4 KB |
| scripts/workspace.py | script | 2.1 KB |
references/process-roles.md
View on GitHub# 进程/线程角色分类规则
> 与 bind-tune 的 process-roles.md 保持口径一致(同构副本,各自维护)。
> 权威锚点:`npu-smi info` 卡↔进程映射,优先于 comm 猜测。
## 角色分类表
| 类型 | 识别方式 | 诊断用途 |
| ---- | -------- | -------- |
| 训练主进程 | npu-smi 卡占用 + cmdline(torchrun/msrun/python) | 确定业务目标与 rank 集合 |
| 推理进程 | npu-smi 卡占用 + cmdline(vllm serve/mindie) | 确定业务目标与实例集合 |
| DataLoader worker | 主进程 fork 的子进程,不占卡,comm 常为 python | B 域冲突判定 |
| HCCL 通信线程 | 进程内线程 comm 含 hccl* | B 域冲突判定 |
| NPU runtime 线程 | 进程内线程,跟随卡 | B 域亲和现状采集(node 偏差判定归 bind-tune) |
| 监控/采集 | comm 白名单:npu-smi/node_exporter/fluentd/telescope/dcgm-exporter | 干扰判定 |
| 容器 runtime | comm 白名单:containerd-shim/runc/dockerd | 干扰判定(不可迁移) |
| 日志/agent | comm 白名单:fluentd/filebeat/rsyslogd | 干扰判定 |
| 编译/交互 | comm 白名单:gcc/g++/pip/jupyter | 告警项(建议移出) |
## 分类优先级
1. npu-smi 卡占用(最强证据);
2. PPID 进程树(同祖先 = 同作业实例);
3. comm/cmdline 模式匹配;
4. 白名单命中即终止(不重复匹配)。
## 输出格式
分类结果写入 targets 节(static-snapshot.json):
```json
{"pid": 12345, "comm": "python", "role": "train_main",
"npus": [0, 1], "affinity": "0-127", "source": "npu_occupancy"}
```
role 取值:train_main / infer_main / dataloader / monitor / container_runtime /
logger / compiler / other。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |