ansible的callback插件是生成自定义报表最直接灵活的入口，通过监听任务完成、主机统计、play结束等事件实时捕获结构化数据，格式化输出为html、excel、json或markdown报表。
Ansible 的 Callback 插件是生成自定义报表最直接、最灵活的入口。它不依赖外部工具或中间层，而是通过监听 Playbook 执行过程中的关键事件（如任务完成、主机统计、Play 结束），实时捕获结构化数据，再按需格式化输出为 HTML、Excel、JSON 或 Markdown 报表。
报表核心数据从哪来？
Callback 插件能拿到三类关键信息：
-
单任务粒度结果：每个 task 在每台 host 上的返回值（
_result）、耗时、状态（ok/failed/unreachable） - 主机级聚合：各 host 的成功/失败/跳过任务数、最后执行时间、facts 变量快照（若启用 gather_facts）
-
全局统计：总耗时、处理主机数、各状态任务总数、角色执行摘要（通过
v2_playbook_on_stats或v2_playbook_on_stats获取）
常见报表类型与实现要点
不同报表目标对应不同 Callback 方法和数据组织逻辑：
-
HTML 可视化报告：在
v2_playbook_on_stats中汇总全部数据，用 jinja2 渲染模板；建议把每台 host 的 task 列表存入字典，避免重复解析 -
Excel 自动报表：用 openpyxl 或 pandas 构建多 sheet 表格（如“Summary”、“Host Details”、“Failed Tasks”）；注意在
v2_runner_on_ok/v2_runner_on_failed中缓存明细，避免内存爆炸 -
JUnit 兼容测试报告：直接启用内置
junit插件（ansible_callback_plugins=junit），或继承其逻辑，确保输出符合 JUnit XML Schema -
Markdown 汇总通知：适合钉钉/企业微信推送，在
v2_playbook_on_stats中构造带表格和 emoji 的消息体，重点突出失败项和总耗时
避免踩坑的关键细节
实际开发中，几个易忽略但影响报表质量的点：
-
异步任务需单独处理：
v2_runner_on_async_ok和v2_runner_on_async_failed不会触发常规on_ok，漏掉会导致报表缺失 -
变量作用域要清晰：所有缓存数据（如
self.results）应在__init__初始化，不要在方法内反复声明空列表 -
中文与编码兼容性：写文件时显式指定
encoding='utf-8'；用to_text()或to_native()处理 Ansible 内部字符串，防止乱码 -
日志路径权限问题：若写入
/var/log/ansible/，确保运行用户有写权限；推荐使用os.path.expanduser('~/.ansible/reports')作为默认落盘目录
快速验证与集成方式
不需要改配置也能试跑报表逻辑：
- 命令行临时启用：
ansible-playbook site.yml -e 'ansible_callback_plugins=./callbacks' -e 'stdout_callback=html_report' - 配置文件指定：
[defaults]下设callback_plugins = ./callbacks和stdout_callback = excel_report - CI/CD 场景中，可将报表文件自动上传至对象存储或发邮件附件，只需在
v2_playbook_on_stats末尾加几行requests.put()或smtplib调用
