跳转到内容

文档与示例

该监控什么,以及怎么监控。

Holter 有两种监控方式。 入站心跳 —— 你的任务在完成时 ping 我们,一旦某次 ping 没有到达,我们就会告警。 出站检测 —— 我们按计划从外部请求你的网址、证书、端口或 DNS。没有服务器智能体,也无法访问你的服务器。在 Business 套餐上,还有 依赖监控 —— 我们监控你所依赖的供应商的状态页,让你第一个听说它们的故障。

入站心跳

一个死人开关:成功时 ping 我们,一旦安静下来我们就会告警。非常适合 备份、队列工作进程、cron、数据管道与 Webhook。

1 · 创建你的入站心跳

New monitor preview

Holter 如何监控

向 Holter 发送一个事件 Holter 检测接口

名称

每夜数据库备份

超过多久没收到 ping 就告警

1 天

你的 ping 网址

https://holter.sh/e/abc…/nightly-db-backup-x7k2qa

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。

创建一个出站检测

New monitor preview

Holter 如何监控

向 Holter 发送一个事件 Holter 检测接口

检测什么

HTTP 接口(状态码 / 响应体 / 延迟)

接口地址

https://api.yourapp.com/health

健康状态码

200

慢于多少就告警

2000 毫秒

它能捕捉到什么

  • ● 宕机,或返回错误的状态码
  • ● 虽然在线,但超出你设定的延迟预算(服务降级)
  • ● 已恢复 —— 附带本次中断时长

切换 检测什么 为 SSL、域名、DNS 或重定向检测 —— 同一个界面,只需一个网址,无需额外字段。证书和域名检测会在到期前数天提前提醒你。

提示:在 Holter 内部,「该监控什么」功能可以一键为你完成以上任意一项设置。

监控你所依赖的一切 Business

有些故障不是你造成的。当 Stripe、AWS、你的身份认证提供方或数据库托管方 出现事件时,你的应用会受到影响 —— 而你的客户会怪罪于你。把这些供应商添加为 依赖项 ,Holter 就会监控它们的公开状态页,让你先从一条告警得知。

添加一个依赖项

New monitor preview

供应商

Stripe

状态页网址

https://status.stripe.com

或从我们已支持读取的 24 个热门供应商中选择。

哪些功能依赖它?

结账

告警我

任何服务降级 仅完全中断时

它能捕捉到什么

  • ● 某个供应商 —— 或其某个组件 —— 报告服务降级
  • ● 某个供应商报告完全中断 —— 已告警到你的渠道
  • ● 已恢复 —— 上游事件已解除

Holter 读取的是每个供应商 自己发布的状态页 ,每隔几分钟一次 —— 它不会直接探测供应商的系统。适用于任何带有公开状态源的页面(绝大多数 SaaS 均支持),并内置对 AWS、Google Cloud 和 Azure 的支持。

你可以选择在自己的状态页上,把已添加的依赖项列为 「上游服务」。

状态徽章

每个公开状态页都提供可嵌入的 SVG 徽章 — 你的状态或在线率的实时快照,可放入 README、Wiki 或你自己的网站。无需 API 密钥,并会自动刷新。

获取代码片段

New monitor preview

徽章 URL

https://app.holter.sh/status/your-page/badge

Markdown

[![Status](…/status/your-page/badge)](https://status.your-domain.com)

在线率变体

https://app.holter.sh/status/your-page/badge?metric=uptime

实时示例

Holter 实时状态徽章 Holter 实时在线率徽章
  • ✓ 自动更新 — 一分钟内反映你的真实状态
  • ✓ 公开且自包含 — 任何能显示图片的地方都能显示

用你的编码智能体完成设置(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 处理程序的入站心跳

  • 状态页已发布

    开启一个,让客户在事件期间可以自助查询

上游依赖 · Business
  • 支付服务商状态

    将 Stripe(或你的支付处理商)添加为依赖项

  • 云 / 托管服务商状态

    将 AWS、GCP、Azure、Vercel 等添加为依赖项

  • 关键第三方 API

    添加 OpenAI、Twilio、SendGrid 等 —— 任何核心流程依赖的服务

从一个检测开始。

5 个监控项免费,无需信用卡。随着使用逐步完成清单上的其余部分。

免费开始监控