PulseMon 脉冲监控器

PulseMon 技能 通过 PulseMon 监控您的 cron 作业和后台任务。 设置 用户需要一个 PulseMon API 密钥。他们可以在 https://pulsemon.dev/dashboard/settings 下的“API 密钥”中生成一个。将其存储为环境变量 PULSEMON_API_KEY。 基础 URL 所有 API 请求都发送到：https://pulsemon.dev/api/v1 认证 每个请求必须包含头部：Authorization: Bearer {PULSEMON_API_KEY} 可用操作 列出所有监控器 GET /api/v1/monitors 返回一个包含名称、slug、状态（up/down/waiting/paused）、最后一次 ping 时间和预期间隔的监控器数组。 获取特定监控器 GET /api/v1/monitors/{id} 返回完整的监控器详细信息，包括最近的 ping 和事件。 创建监控器 POST /api/v1/monitors Content-Type: application/json Body：{ "name": "Nightly Backup", "slug": "nightly-backup", "expectedInterval": 86400, "gracePeriod": 300, "tags": ["production"] } name：人类可读的名称（必需，1-100 个字符） slug：URL 安全标识符，仅允许使用小写字母、数字和连字符（必需，3-60 个字符） expectedInterval：预期 ping 之间的秒数（必需，至少 10，最大 2592000） gracePeriod：在警报之前的额外秒数（可选，0-86400，缺省值基于间隔） tags：用于组织的字符串标签数组（可选） maxDuration：允许的最大运行时间（毫秒）（可选，null 表示禁用）。如果 ping 报告的持续时间超过此阈值，则触发警报。 更新监控器 PATCH /api/v1/monitors/{id} Content-Type: application/json Body：任何这些字段（至少需要一个）： name：字符串（1-100 个字符） expectedInterval：数字（10-2592000） gracePeriod：数字（0-86400） isPaused：布尔值 tags：字符串数组 maxDuration：数字或 null（毫秒） 删除监控器 DELETE /api/v1/monitors/{id} 暂停监控器 POST /api/v1/monitors/{id}/pause 恢复监控器 POST /api/v1/monitors/{id}/resume 列出监控器的 ping GET /api/v1/monitors/{id}/pings?limit=20&offset=0 列出监控器的事件 GET /api/v1/monitors/{id}/incidents?limit=20&offset=0 ping 监控器 ping 发送到 ping 端点（无需 API 密钥）： GET https://pulsemon.dev/api/ping/{slug} 可选查询参数： status： "success"（默认）、"fail" 或 "start" duration：作业持续时间（毫秒） POST https://pulsemon.dev/api/ping/{slug} JSON 正文：{ "status": "success", "duration": 1234, "body": "处理了 500 条记录" } status=start：表示作业已开始。启用重叠检测。不会重置截止日期。 status=success：表示作业已完成。重置截止日期。 status=fail：记录失败。不会重置截止日期。 body：作业输出（最多 10 KB）。包含在警报通知中。 duration：作业运行时间（毫秒）。检查是否超过 maxDuration 阈值（如果设置）。 响应格式 所有响应都是 JSON 格式：{ "data": { ... }, "error": null } 错误时：{ "data": null, "error": { "code": "NOT_FOUND", "message": "监控器未找到" } } 常见间隔 当用户说“每小时”或“每天”时，将其转换为秒： 每分钟：60 每 5 分钟：300 每 15 分钟：900 每 30 分钟：1800 每小时：3600 每 6 小时：21600 每 12 小时：43200 每天：86400 每周：604800 指南 列出监控器时，显示名称、状态和最后一次 ping 时间的可读格式。 当监控器“down”时，提及它已经 down 多久。 创建监控器时，如果用户没有指定 gracePeriod，建议一个合理的 gracePeriod（例如，间隔的 10%，至少 30 秒）。 创建监控器后，向用户显示 ping URL：https://pulsemon.dev/api/ping/{slug} 在删除监控器之前，始终确认。 当用户说“检查我的监控器”或类似时，使用 list 端点并总结结果。 以人类可读的形式格式化持续时间（例如“2 小时前”而不是原始时间戳）。