offline-NPU-fault-diagnosis

Diagnose NPU hardware, PCIe link, and driver failures from server logs.

3|2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/openeuler-mirror/witty-diagnosis-agent --skill offline-npu-fault-diagnosis-openeuler-mirror
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: offline-NPU-fault-diagnosis
Source: https://github.com/openeuler-mirror/witty-diagnosis-agent/tree/main/skills/offline-NPU-fault-diagnosis
Command: npx skills add https://github.com/openeuler-mirror/witty-diagnosis-agent --skill offline-npu-fault-diagnosis-openeuler-mirror

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the difficulty of diagnosing complex NPU hardware and software failures by automating the analysis of fragmented, multi-source server logs.

Core Features & Use Cases

  • Multi-Source Correlation: Automatically aligns iBMC, OS Messages, and InfoCollect logs to reconstruct the exact fault propagation chain.
  • Physical Precision: Pinpoints failures to specific NPU IDs, PCIe slots, or HBM memory modules rather than providing generic error messages.
  • Use Case: When a cluster node reports an NPU offline status, this Skill analyzes the iBMC SEL and dmesg logs to determine if the root cause is a physical PCIe link training failure or a driver-level firmware mismatch.

Quick Start

Use the offline-NPU-fault-diagnosis skill to analyze the logs located in the /tmp/server_logs directory.

Frequently Asked Questions about offline-NPU-fault-diagnosis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose NPU hardware failures from offline server logs?

Diagnose NPU hardware failures by analyzing offline server logs including iBMC, OS Messages, and InfoCollect to pinpoint physical component issues like HBM memory errors and PCIe link failures.

What is the best way to correlate iBMC and OS Messages to find an Ascend NPU offline root cause?

Correlate iBMC and OS Messages to reconstruct the fault propagation chain, determining if an Ascend NPU offline status stems from a physical PCIe link training failure or a driver-level firmware mismatch.

Why does my Ascend NPU report thermal throttling and driver-firmware incompatibilities?

Identify thermal throttling and driver-firmware incompatibilities in Ascend NPU environments by correlating hardware events with kernel-level logs to expose complex fault scenarios affecting physical components.

Can I pinpoint specific HBM memory modules and PCIe slots causing NPU errors?

Yes, pinpoint failures to specific NPU IDs, PCIe slots, or HBM memory modules by implementing a multi-step diagnostic workflow that correlates hardware events with kernel-level logs.

How do I start analyzing fragmented multi-source logs for NPU diagnostics?

Start NPU diagnostics by analyzing logs located in the /tmp/server_logs directory, automatically aligning iBMC, OS Messages, and InfoCollect data to identify physical component failures.

Does offline NPU fault diagnosis work without real-time cluster monitoring?

Yes, offline NPU fault diagnosis works without real-time monitoring by analyzing server-side offline logs to reconstruct the exact fault propagation chain and identify physical PCIe or driver failures.