如何监控SaltStack的运行状态

监控 SaltStack 运行状态的实用方案

一 基础健康检查

• 服务与端口：在 Master 上确认服务存活并监听正确端口，默认监听 4505/publish 与 4506/ret，同时确认 Minion 进程处于运行状态。
  示例：
  • systemctl status salt-master（应返回 active (running)）
  • salt-key -L（查看已接受的 Minion 密钥）
  • salt ‘*’ test.ping（批量探活，返回 True 表示在线）
  • 网络连通性：在 Master 执行 salt ‘*’ cmd.run ‘ss -lntp | grep -E “4505|4506”’ 或在 Minion 执行 netstat -an | grep Es 检查长连接与端口监听。
    以上可快速判断控制面（Master/Minion）与传输层是否正常。

二 作业与任务监控

• 实时与历史：使用 Salt 的 Job 管理查看正在运行与历史任务，便于定位卡死、超时与异常返回。
  示例：
  • 查看所有 Minion 当前任务：salt ‘*’ saltutil.running
  • 按 jid 查询任务：salt-run jobs.lookup_jid
  • 列出 Master 缓存中的任务：salt-run jobs.list_jobs
  • 终止任务：salt ‘*’ saltutil.term_job / saltutil.kill_job
• 结果留存：Master 默认将结果缓存在 /var/cache/salt/master/jobs，缓存时间由 keepjobs 控制（默认 24 小时），必要时延长以做审计与回溯。

三 事件与自动化响应

• 事件总线：通过 event 系统订阅 Salt 事件流（作业返回、密钥变更、启动/停止等），用于构建实时告警与联动。
• 自动化响应：使用 Reactor 在事件触发时执行预定义动作（如失败重试、通知、自动修复），实现“发现即处置”的闭环。
• 事件查询：salt-run state.event pretty=True 可实时查看事件，便于调试与验证规则。

四 外部系统对接与可视化

• 结果持久化：利用 Returner 将执行结果发送到外部系统（如数据库、消息队列、日志平台），便于统一监控与报表。
• API 集成：通过 Salt API 以编程方式获取 Minion 状态、执行命令、管理作业与监听事件，适合对接 CMDB、告警平台与自研门户。
• 可视化界面：早期常用的 Halite 已停止维护，可作为历史参考；也可基于 Salt API 自研或选用企业级控制台。

五 建议的监控指标与巡检命令清单

以上清单可作为日常巡检与告警规则的基线，结合企业监控平台（如 Prometheus、Zabbix）通过 API/Returner 上报关键指标，实现可视化与阈值告警。