文档与示例
该监控什么,以及怎么监控。
Holter 有两种监控方式。 入站心跳 —— 你的任务在完成时 ping 我们,一旦某次 ping 没有到达,我们就会告警。 出站检测 —— 我们按计划从外部请求你的网址、证书、端口或 DNS。没有服务器智能体,也无法访问你的服务器。在 Business 套餐上,还有 依赖监控 —— 我们监控你所依赖的供应商的状态页,让你第一个听说它们的故障。
入站心跳
一个死人开关:成功时 ping 我们,一旦安静下来我们就会告警。非常适合 备份、队列工作进程、cron、数据管道与 Webhook。
1 · 创建你的入站心跳
Holter 如何监控
名称
超过多久没收到 ping 就告警
你的 ping 网址
Holter 会自动生成 —— 从仪表盘中复制它。
2 · 然后在你的任务中 curl 它
# success — at the end of the job
pg_dump … | gzip | aws s3 cp - s3://… \
&& curl -fsS "$HOLTER_URL"
# failure — alert right away
curl -fsS "$HOLTER_URL/fail"
一旦错过窗口期,Holter 就会开启一个事件并告警你的渠道。队列工作进程(每隔几分钟 ping 一次)和 cron(在命令末尾追加 curl)也是同样的模式。
更喜欢用邮件? 把心跳切换为一个专属地址(…@in.holter.sh),让你的应用按计划向它发送邮件。一旦你的邮件停止发送,Holter 会告诉你 —— 它监控的是整条发送链路,而不只是你的代码。
出站检测
我们按计划从公共互联网访问你的服务 —— 无需安装任何东西。非常适合 正常运行时间、API 健康状态、SSL、域名、DNS 和 TCP。
创建一个出站检测
Holter 如何监控
检测什么
接口地址
健康状态码
慢于多少就告警
它能捕捉到什么
- ● 宕机,或返回错误的状态码
- ● 虽然在线,但超出你设定的延迟预算(服务降级)
- ● 已恢复 —— 附带本次中断时长
切换 检测什么 为 SSL、域名、DNS 或重定向检测 —— 同一个界面,只需一个网址,无需额外字段。证书和域名检测会在到期前数天提前提醒你。
提示:在 Holter 内部,「该监控什么」功能可以一键为你完成以上任意一项设置。
监控你所依赖的一切 Business
有些故障不是你造成的。当 Stripe、AWS、你的身份认证提供方或数据库托管方 出现事件时,你的应用会受到影响 —— 而你的客户会怪罪于你。把这些供应商添加为 依赖项 ,Holter 就会监控它们的公开状态页,让你先从一条告警得知。
添加一个依赖项
供应商
状态页网址
或从我们已支持读取的 24 个热门供应商中选择。
哪些功能依赖它?
告警我
它能捕捉到什么
- ● 某个供应商 —— 或其某个组件 —— 报告服务降级
- ● 某个供应商报告完全中断 —— 已告警到你的渠道
- ● 已恢复 —— 上游事件已解除
Holter 读取的是每个供应商 自己发布的状态页 ,每隔几分钟一次 —— 它不会直接探测供应商的系统。适用于任何带有公开状态源的页面(绝大多数 SaaS 均支持),并内置对 AWS、Google Cloud 和 Azure 的支持。
你可以选择在自己的状态页上,把已添加的依赖项列为 「上游服务」。
状态徽章
每个公开状态页都提供可嵌入的 SVG 徽章 — 你的状态或在线率的实时快照,可放入 README、Wiki 或你自己的网站。无需 API 密钥,并会自动刷新。
获取代码片段
徽章 URL
Markdown
在线率变体
实时示例
- ✓ 自动更新 — 一分钟内反映你的真实状态
- ✓ 公开且自包含 — 任何能显示图片的地方都能显示
用你的编码智能体完成设置(MCP)
与其手动填写上面这些表单,不如让你的智能体先完成第一遍设置。Holter 提供一个 MCP 服务器 —— 使用一个团队范围的令牌连接 Claude Code、Cursor 或任何支持 MCP 的智能体,它会在 本地读取你的代码仓库,提出它发现的监控项建议(cron、队列、健康检测、域名),并为你写好可供审核的心跳代码。
1 · 添加 MCP 服务器
{
"mcpServers": {
"holter": {
"type": "http",
"url": "https://app.holter.sh/api/mcp",
"headers": { "Authorization": "Bearer ${HOLTER_TOKEN}" }
}
}
}
从 设置 → MCP 获取一个团队范围的令牌,并将其设置为 HOLTER_TOKEN。该令牌是智能体唯一需要的凭据 —— 它仅限于你的 Holter 团队,无法访问你的代码、服务器或云。
2 · 然后直接开口问它
"Set up Holter monitoring for this repo —
read holter.sh/use and follow it."
- ✓ 它在本地读取你的代码库 —— Holter 永远不会拿到你的源代码
- ✓ 它提出监控项和心跳代码建议;每一处改动都由你审核并应用
- ✓ 它通过令牌工作,绝不会拿到你的密钥 —— 它无法触及你的系统
生产环境监控检查清单
每一行都是一次 3 分钟就能完成的设置 —— 或者在应用内点一下「该监控什么」即可完成。
-
主页 / 主应用有响应
出站 HTTP 检测,预期返回 200
-
API 或健康检测接口有响应
对 /health 进行出站 HTTP 检测,可选匹配响应体字符串
-
响应时间在预算范围内
添加一个「慢于多少就告警」的延迟预算
-
HTTP 重定向到 HTTPS
出站重定向检测
-
TLS 证书未临近到期
出站 SSL 检测
-
域名未即将失效
出站域名检测(RDAP)
-
DNS 仍可正常解析
出站 DNS 检测
-
每夜备份已完成
来自备份脚本的入站心跳
-
队列工作进程存活并正常消费
来自计划性工作进程 ping 的入站心跳
-
计划任务 / cron 已运行
每个 cron 结束时的入站心跳
-
关键数据管道(ETL、账单运行)
成功时的入站心跳,失败时用 /fail
-
事务性邮件仍在发送
入站邮件监控 —— 你的应用按计划向一个专属地址发送邮件
-
数据库 / 缓存端口可达
出站 TCP 检测(公网 host:port)
-
第三方 Webhook 仍在触发
来自你的 Webhook 处理程序的入站心跳
-
状态页已发布
开启一个,让客户在事件期间可以自助查询
-
支付服务商状态
将 Stripe(或你的支付处理商)添加为依赖项
-
云 / 托管服务商状态
将 AWS、GCP、Azure、Vercel 等添加为依赖项
-
关键第三方 API
添加 OpenAI、Twilio、SendGrid 等 —— 任何核心流程依赖的服务