使用说明
HTTP 服务监控：状态码、响应文本与 JSON 字段手机提醒
用 My Monitor 每小时检查公开 HTTP 接口，核对状态码、响应文本或 JSON 字段；异常时通知手机，每项服务保留同一会话的检测记录。
更新于
如何在手机监控 HTTP 接口是否正常？
#My Monitor 每小时检查公开 HTTP 或 HTTPS 接口，把结果发到手机。可以核对成功状态、指定响应文本或 JSON 字段值，每项服务保留独立会话。默认仅失败推送时，异常会提醒，正常和恢复结果静默记录。
- 打开“发现 → 我的监控 → 添加监控”。
- 填写公开 HTTP 或 HTTPS 地址和名称；文本或 JSON 规则先获取响应预览，再填写预期。
- 测试规则，再启用监控。设置后进行首次观察，之后每小时检查。
通过 CLI 或 MCP 管理我的监控
#CLI 0.2.0 可以管理手机里同一份 My Monitor。先在 App 打开一次我的监控，再为已配对的 Source 发起授权。主手机必须明确批准本次监控读写范围，默认有效 24 小时，--expires 支持 5 分钟至 24 小时。到期、主动撤销、断开 Source 或更换手机与根身份后权限失效。手机及根私钥始终留在手机；仅本次授权问题与答案明确披露给服务核验，普通 Agent 问答保留现有加密方式。
ntfyx monitor authorize
ntfyx monitor add --name "我的服务" --url https://example.com/health --dry-run
ntfyx monitor add --name "我的服务" --url https://example.com/health
ntfyx monitor list
ntfyx monitor show MONITOR_ID
ntfyx monitor update MONITOR_ID --json-field ok --equals true
ntfyx monitor test MONITOR_ID
ntfyx monitor pause MONITOR_ID
ntfyx monitor resume MONITOR_ID
ntfyx monitor revoke三类实际可用的监控规则
#公开网站或健康检查接口可以核对状态码；需要明确就绪标记时核对指定文本；HTTP 返回成功但应用可能异常时，可以核对 JSON 字段。先在 App 预览响应，再选择预期值。
| 需求 | 规则 | 示例 |
|---|---|---|
| 网站正常响应 | HTTP 2xx | https://example.com/ |
| 服务已就绪 | 响应包含指定文本 | ready |
| API 报告健康 | JSON 字段等于指定基础值 | status = "ok" |
什么才算符合预期
#服务器能连上，不一定代表服务正常。所有规则都要求最终 HTTP 状态为 200–299；内容规则在此基础上再检查响应。
| 规则 | 正常条件 | 例子 |
|---|---|---|
| 正常访问 | 最终 HTTP 状态为 2xx。 | 网站正常返回。 |
| 响应包含文本 | 有界响应中包含大小写完全一致的文本。 | 返回值包含 ok。 |
| JSON 字段等于 | 简单点分隔对象路径的值等于指定基础值。 | status 字段等于字符串 ok。 |
每轮留记录，选择何时提醒
#每次最终检查结果都进入系统 My Monitor Topic 中该监控的固定 Session。默认勾选“仅检查失败时推送”：正常与恢复结果静默留在会话，已确认失败才推送；关闭后每次检查都推送。首次每小时检查失败后，60 秒后复查确认，两个请求属于同一轮，不发两条消息。持续失败在下一小时继续记录并提醒。监控基础设施错误不构成你的服务已宕机的证明。
七天记录与每周总结
#监控消息统一使用英文：正常与恢复均使用 🎉，失败使用 ❌，并由文字区分检查成功和恢复。服务端逐次检测记录最多保留七天，现有 App 详情继续显示最近二十条。有检测活动的每周生成一条 📊 周报，在独立 Session 汇总上一个 UTC 周一至周日，计划每周一 00:00 UTC（北京时间 08:00）发送。指标包括监控项数、检测请求次数、成功与失败次数、已完成检查的成功率和平均响应时间；探测器未完成的检查单列，不计成功率分母，确认复查也计作检测请求。成功率不等于在线率。首份报告注明实际统计起点。即使开启仅失败时推送，周报也会正常提醒，仍遵守 Topic 静音、免打扰、系统通知权限及投递额度。无需更新 App，不做语言识别或翻译，用户名称、规则和消息保持原样。
监控额度与暂停
#免费版包含 1 个监控项，Plus 包含 10 个，Unlimited 包含 100 个，均按每小时检查。监控额度与自定义 Topic、通知订阅额度独立。暂停的监控仍占名额，删除后才释放。降级时超出新额度的项会暂停；升级不会静默重启已经暂停的项。删除停止该项的后续检查和提醒，已进入收件箱的历史仍保留；周报仍可汇总删除前已执行的检查。监控使用独立告警与密文存储额度，最长保留 7 天，不挤占 HTTPS 或 Agent 普通消息容量。
| 套餐 | 监控项 | 每 UTC 日结果 | 密文存储 |
|---|---|---|---|
| 免费 | 1 | 100 条 | 1 MiB |
| Plus / Ten | 10 | 480 条 | 8 MiB |
| Unlimited | 100 | 4,800 条 | 64 MiB |
公开地址与有界检查
#使用端口 80 或 443 的公开 HTTP 或 HTTPS URL。私网、本机、元数据地址和嵌入凭据会被阻止；重定向、DNS 目的地址、请求耗时与响应大小均受限制。首版不带入你的 Cookie、自定义鉴权请求头或登录凭据。不要在 URL 或预期文本中放密钥。它不是浏览器登录会话、私网探针或完整可用性 SLA。
监控服务会处理什么
#服务会读取 URL、规则和响应以判断是否符合预期，保存配置、调度信息和有界结果历史；结果历史不包含响应正文。配置时主动获取的预览最多显示 4,096 UTF-8 字节的纯文本并标记截断，仅临时留在编辑表单，不保存到历史。托管服务生成提醒后，再为已授权接收端加密投递。CLI 与 Agent 消息仍在发送设备端到端加密。
按使用场景开始
#从 Agent 等你回答，到每周订阅和网站异常，选一个场景开始。看手机会收到什么，再按步骤接好。
AI Agent 可以管理同一组监控吗？
#可以。已配对 CLI 或本地 MCP 在手机明确批准后，可以添加、修改、测试和暂停 App 中的同一组 My Monitor。授权最长 24 小时、可撤销，与 Webhook 管理权限独立；可以在手机查看已授予的范围。