Uptime Kuma 监控运维专家

Uptime Kuma CLI 封装工具，支持监控增删改查、心跳历史查看及批量维护操作，适合自托管监控场景。

基本信息

• 技能名称?Uptime Kuma
• 中文名称?Uptime Kuma 监控运维专家
• 作者?msarheed
• 分类?专业技能
• 版本?1.0.0
• 标签?monitoring, uptime, sre, cli-tool, self-hosted, socket-io, health-check, python

使用方法

使用说明
核心用法
本 Skill 为 Uptime Kuma 监控服务器的 Python CLI 封装，基于 uptime-kuma-api 库通过 Socket.IO 与服务器交互。支持完整的监控生命周期管理：查看整体状态、列出/获取/添加/删除监控项、暂停/恢复检查、查看心跳历史及通知渠道管理。
典型工作流：
快速诊断： kuma.py status 查看整体健康度， kuma.py list 定位故障（ 标记）
灵活添加：支持 HTTP/HTTPS、ICMP Ping、TCP 端口、DNS、数据库（MySQL/PostgreSQL/MongoDB/Redis）、Docker 容器、MQTT、被动 Push 等 10+ 监控类型
维护操作：支持单个或批量暂停/恢复（配合 shell 循环实现全站维护模式）
历史追溯： kuma.py heartbeats 查看指定时间窗口内的检测记录
显著优点
协议覆盖全面 ：从基础网络层（Ping、Port）到应用层（HTTP Keyword、数据库、Docker）全栈支持
被动监控支持 ：Push 类型允许内网服务主动上报，解决不可达场景
批量运维友好 ：JSON 输出配合 jq 可实现脚本化批量操作
自托管可控 ：对接开源 Uptime Kuma 项目，数据私有化
潜在缺点与局限性
依赖 Socket.IO 连接 ：网络不稳定时 API 调用可能失败
无内置高可用 ：Uptime Kuma 本身为单节点架构，Skill 无法规避该限制
权限粒度粗 ：仅支持用户名/密码认证，无 RBAC 或 API Token 机制
告警配置受限 ：仅能查看通知渠道，无法通过 CLI 创建或修改告警规则
无 SSL 证书过期专项监控 ：HTTP 类型不单独暴露证书有效期指标
适合人群
运维工程师/SRE：需要快速批量操作监控的日常值班场景
自托管用户：已部署 Uptime Kuma 且偏好命令行工作流的开发者
自动化集成：需将监控操作嵌入 CI/CD 或运维脚本的团队
常规风险
凭证泄露 ： UPTIME_KUMA_USERNAME/PASSWORD 环境变量需妥善保管，避免写入版本控制
误删风险 ： delete 操作无二次确认，脚本调用时需额外校验
维护误操作 ：批量 pause/resume 可能影响核心服务监控覆盖
API 兼容性 ：Uptime Kuma 版本升级可能破坏 Socket.IO 接口契约，需锁定版本测试