SuperAPI AI 工具集

healthchecks-io

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:借助 healthchecks.io 的 REST API(基地址 https://healthchecks.io/api/v3)创建、管理、审计并验证健康检查监控,适用于为新增 cron 任务或服务接入监控、排查现有检查、以及在脚本中上报运行状态。

凭证:使用环境变量 $HC_API_KEY(读写,可创建/更新/删除)、$HC_API_KEY_READONLY(只读,仅列表/查看)、$HC_PING_KEY(用于 https://hc-ping.com/$HC_PING_KEY/<slug> 的 ping 密钥)。

主要能力:创建检查(POST /checks/,关键字段含 name、tags、desc、grace 告警前缓冲秒数、schedule cron 表达式、timeout 简单心跳间隔、tz 时区;返回 ping_url),列出与按名称子串或标签筛选现有检查,查看单个检查详情与最近 ping 日志,更新检查,删除检查,暂停与恢复检查。

状态值:new、up、grace、down、paused。ping 类型:start、success、fail。

使用方式:在脚本中向 PING_URL 发送请求,如 /start 标记开始、根路径标记成功、/fail 标记失败、/$EXIT_CODE 按退出码判定(0 成功,非零失败);可用 --data-raw 附加最多 10KB 日志正文。查询单检查详情可获得 status、n_pings、last_ping、next_ping。删除检查会返回被删对象。命名建议采用 <service>: <job-name> 或 <host>/<service>,标签使用主机加类别。

限制:命令示例中依赖 curl、jq 与环境变量;附加日志正文上限 10KB;grace 用于告警前缓冲,schedule 与 timeout 二选一用于设定截止时间;暂停检查可防止服务有意停止时误报。其它细节资料未提供。