Ansible Playbook诊断运行器

排查 Playbook 失败时的诊断痛点

当你的 Ansible Playbook 执行失败，仅仅盯着红色的报错信息往往不足以定位根因。你真正需要的是故障发生那一刻的系统上下文：当时负载有多高？相关服务是否处于假死状态？最近的日志里到底有没有隐藏的异常？

Ansible Playbook Diagnostics Runner 就是为了解决这个问题而生。

核心能力与运行机制

该技能深度结合 ansible-runner 和 Ansible Collections 生态（依赖 ansible.builtin 与 community.general），将诊断流程封装为可复用的 Playbook。

• 收集系统健康度：在目标节点上快速采集 CPU、内存和磁盘 I/O 等核心指标。
• 确认服务状态：检查关键业务服务的运行状态，排查假死或重启循环。
• 执行日志分析：提取并分析系统日志，快速筛选出报错时间段内的关键异常。

运行器会自动在所有库存主机（Inventory）上并行执行上述诊断任务，并将收集到的健康快照统一汇总。

适用边界与注意事项

• 该工具最适合用于临时任务执行、网络自动化以及多节点编排过程中的状态采集。
• 虽然 Ansible 允许使用 Python 以外的任何动态语言开发模块，但本诊断运行器的内置功能主要依赖 Python 环境。
• 若你希望使用包含最新特性的 devel 分支，请确保你具备足够的底层排错经验，这属于高级用户的进阶玩法。