docker-fault-analysis

Automate end-to-end Docker fault diagnosis across kernel, storage, network, and security surfaces.

1|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/linfordWu/owls --skill docker-fault-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docker-fault-analysis
Source: https://github.com/linfordWu/owls/tree/main/skills/docker-fault-analysis
Command: npx skills add https://github.com/linfordWu/owls --skill docker-fault-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, openssl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

提供专业的 Docker 容器运维故障分析能力,覆盖内核/系统调用、资源限制(OOM/CPU)、文件系统/存储、网络、权限/安全以及日志/监控等六大故障类别。 当用户提到任何与 Docker 相关的异常时务必使用此 skill,例如:容器启动失败(Exited/CrashLoopBackOff)、容器频繁重启、服务连不上/网络不通、I/O 卡顿、权限被拒绝(Permission denied)、资源耗尽(OOM)、磁盘写满或挂载失败、端口冲突、Docker daemon 挂死或无响应等。 即使没有明确提及 "Docker" 而是说到 "容器挂了"、"Pod 异常"、"应用起不来" 且怀疑是底层环境问题时,也应当积极触发本技能进行环境诊断。

Core Features & Use Cases

  • 具备跨层级的故障分析能力:从宿主机内核到 Docker 引擎、再到容器运行时与应用层进行分层排查。
  • 支持对常见故障的快速定位与报告生成,包括内核参数、cgroup、存储驱动、网络、权限/安全、日志与监控等方面。
  • 典型应用场景包括:容器启动失败、频繁重启、网络不可达、磁盘写入异常、权限拒绝、OOM 导致的容器被杀、以及 Daemon 守护进程无响应等。

Quick Start

描述 Docker 问题并运行全量诊断工作流以生成结构化诊断报告。

Frequently Asked Questions about docker-fault-analysis

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

FAQPage Schema
How do I troubleshoot Docker container start failures and crashes?

Automate Docker fault diagnosis across kernel, storage, network, and security surfaces to troubleshoot container start failures and crashes. The Skill performs multi-source data collection and scripted checks to reconstruct timelines and generate a structured diagnostic report.

Why does my Docker container get killed with an OOM error?

Docker containers get killed with an OOM error due to resource exhaustion. This Skill diagnoses the issue by performing layered analysis across cgroups, kernel parameters, and system calls to locate the resource limit causing the Out-Of-Memory event.

What is the best way to diagnose Docker daemon hangs and I/O stalls?

The best way to diagnose Docker daemon hangs and I/O stalls is using automated layered analysis. This Skill collects multi-source data from the host kernel, storage driver, and runtime to reconstruct the event timeline and identify the blocking condition.

How do I resolve Docker permission denied errors and network outages?

Resolve Docker permission denied errors and network outages by running scripted checks across security and network surfaces. This Skill automates fault diagnosis to detect misconfigurations, providing a structured report for troubleshooting connectivity and access issues.

Do I need python3 and openssl to run Docker kernel fault analysis?

Yes, you need python3 and openssl installed in your environment to run Docker kernel fault analysis. These dependencies are required to execute the automated scripted checks and multi-source data collection across the kernel and security surfaces.

Can I use this for storage and disk fullness diagnosis in Docker?

Yes, you can use this Skill for storage and disk fullness diagnosis in Docker. It automates fault detection across storage drivers and file systems, applying layered analysis to identify I/O stalls, mount failures, and disk capacity issues.