Agent Skills
返回列表
🔒

Kubernetes Pod 捕获诊断工具

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/kubernetes-pod-crash-diagnostician 到你的 AI 助手中。

技能介绍

什么时候需要它:Pod 崩溃循环排查成本高

Kubernetes 里 Pod 反复重启、状态卡在 CrashLoopBackOff 是最常见的棘手问题之一。这类问题往往不是单点故障:可能是内存配额不足触发 OOMKilled、configMap 缺失导致启动失败、探针配置错误导致反复重启,也可能是运行时依赖超时。传统排查需要手动执行 kubectl get events、kubectl logs、kubectl describe,再对比 resource quota 配置和监控数据,步骤分散且容易遗漏关键线索。

它怎么工作:三条线索交叉定位根因

这个技能直接对接 Kubernetes API 和 kubectl debug 能力,用自动化流程完成交叉验证:

  1. 拉取运行时线索:通过 API 获取 Pod 关联的 Events、容器 Logs 和命名空间的 ResourceQuota,先排除明显的配置缺失或资源超限。
  2. 深入容器排查:借助 kubectl debug 在运行失败的容器里注入诊断工具,检查文件缺失、依赖连接失败这类日志里看不到的内部异常。
  3. 关联内存指标:如果日志出现 OOMKill 信号,自动匹配 Prometheus 的容器内存查询结果,确认是突发流量导致的内存超限,还是内存长期占用过高的配置问题。

适用边界:先看前置条件

它的能力聚焦在崩溃循环场景,无法处理集群节点故障、网络策略阻断这类跨层问题。使用前需要确保环境有可用的 Docker 环境,且 kubectl 拥有目标命名空间的查看和 debug 权限。如果集群未配置 Prometheus,内存关联分析这部分会跳过,仅保留事件和日志的基础诊断。

使用场景

  • 排查集群内 Pod 持续 `CrashLoopBackOff` 状态,需快速定位事件、日志与资源配置中的异常项
  • 容器日志显示 OOMKilled,但不确定是配额不足还是内存持续泄漏,需要结合 Prometheus 数据判断
  • 启动阶段多次失败,需用 `kubectl debug` 进入容器内部检查缺失配置或运行时依赖
  • 需要按事件、日志、配额三类线索快速排查多组 Pod 的反复重启原因并输出统一诊断结论

适合人员

  • 负责 K8s 集群稳定性的 SRE 工程师,需要快速定位 Pod 崩溃根因并减少排障时间
  • 管理微服务集群的后端工程师,要在服务发布异常时用日志、事件和内存指标交叉验证原因
  • 编写自动化诊断脚本的平台工程师,需要将 kubectl 调试流程与 Prometheus 数据查询封装为可复用能力
  • 进行 Kubernetes 故障演练的测试工程师,希望按统一方法验证 Pod 崩溃场景的排查路径