云哨兵服务说明 - API监控 | 心跳监控 | SSL证书监控 | 端口监控

一、监控类型与技术原理

1. API 监控

通过 HTTP/HTTPS 请求目标 URL，记录状态码、响应时间，支持自定义期望状态码。

适用场景：Web 服务、RESTful API、微服务健康检查。

免费用户最小间隔：5 分钟
付费用户最小间隔：1 分钟

2. 端口监控

尝试 TCP 连接指定 IP/域名及端口，检测端口是否开放。

适用场景：服务器、数据库、中间件等基础设施。

免费用户最小间隔：5 分钟
付费用户最小间隔：1 分钟

3. SSL 证书监控

检测域名的 SSL 证书剩余有效期，当剩余天数低于设定阈值（默认 30 天）时发出告警。

监控间隔：最小间隔为 1 天（所有用户统一）。

💡 建议：证书到期前 30 天、15 天、7 天分别设置告警，确保有充足时间更新。

4. 网站内容监控

通过 HTTP 获取目标网页的静态 HTML 源代码，检测是否包含（或不包含）特定关键词。

⚠️ 重要限制：本服务不执行页面中的 JavaScript 代码，无法检测通过 AJAX、Vue/React 等动态渲染的内容。

✅ 适用场景	❌ 不适用场景
纯静态页面、新闻公告、政府公开信息、XML/RSS 源、错误页面检测	单页应用（SPA）、需登录/验证码的页面、内容通过用户交互加载的页面、强反爬网站（如百度、淘宝、京东）

💡 建议：对于重要业务，优先使用 API 监控、端口监控 或 SSL 证书监控，它们更稳定可靠。

所有用户最小间隔均为 1 小时（3600 秒）。

5. 业务流程监控

定义多步骤业务链路，自动检测每个环节健康状态。任何一步异常即触发告警。

📌 会员专属功能。

6. 心跳打卡（被动监控）

平台提供一个专属 URL，您的服务定期访问该地址。如果超过规定时间未收到心跳信号，平台立即发送告警通知。

配置方法：登录控制台 → 点击昵称 → 在基础资料弹窗点击"管理心跳监控"按钮 → 进入心跳管理页面配置间隔时间/启用心跳监控 → 保存配置 → 复制专属Url

适用场景：无法被主动探测、但能主动上网的服务——内网服务器、定时任务、守护进程、IoT 设备等。

与 URL 监控的区别：
URL 监控：云哨兵 → 你的服务（主动探测）
心跳打卡：你的服务 → 云哨兵（被动接收）

# Linux cron 示例：每 1 小时发送一次心跳
*/5 * * * * curl -X POST "https://api.yunshaobing.com/heartbeat/你的任务ID"

二、桌面客户端（v1.2 · 会员试用）

如果需要秒级高频监控或监控依赖浏览器渲染的动态网页，可使用云哨兵桌面客户端。

适用场景：秒级高频监控、JavaScript 动态网页监控
版本说明：v1.2，目前仅对高级会员开放试用
运行方式：启动后最小化至系统托盘，后台持续执行；关闭窗口不会退出，需在托盘右键菜单中点击"退出"
系统要求：Windows 10 及以上（64位），内存建议 4GB 以上

⚠️ 提醒：不建议对第三方外部服务使用高频监控，容易触发对方 IP 限流、封禁规则，相关风险需自行承担。

三、通知方式建议

✅ 推荐：企业微信、钉钉、飞书——平台直接推送，稳定及时，无延迟风险
📧 邮箱通知：作为备选。免费邮箱存在每日发送上限和投递延迟，重要告警建议同时配置即时通讯通道
📌 告警机制：每个任务每次异常仅发送一次告警，恢复正常后再次异常才触发下一次，避免重复打扰

四、免费配额与付费方案

	免费用户	付费用户（9.9元/30天）
监控任务数	1 个（永久）	1 + 50 个
API/端口最小间隔	5 分钟	1 分钟
SSL 监控最小间隔	1 天	1 天
网站内容监控间隔	1 小时	1 小时
日志保留	7 天	90 天（会员）
会员专属功能	—	业务流程监控、SLA图表、监控大屏、任务卡批量操作

可多次购买，每次购买会延长有效期
付费到期后额外配额清零，超出基础配额的任务自动禁用，续费后可手动启用

五、长期不活跃账户处理

免费用户超过 90 天未登录，或付费用户超过有效期且 90 天未登录，系统将自动禁用其所有监控任务。重新登录后可手动启用。

六、免责声明

禁止滥用：不得用于高频、恶意请求或侵犯他人合法权益，一经发现将暂停或终止服务
网站监控局限性：受目标网站反爬策略、网络波动影响，可能产生误报或漏报
SSL 监控风险：依赖网络连通性，检测失败不影响实际证书有效期
服务稳定性：尽力保证稳定，但不对监控成功率做 100% 承诺

七、联系我们

📧 邮箱：cloudsentinel@qq.com

云哨兵 · 服务说明