01简要说明
要使用 SMSMeteor 发送运维警报,请让您的监控或事件工具通过通用 webhook 操作调用 POST /v1/messages;使用事务型标记,使警报可在任何时段发出;设置较短有效期,使过时警报被丢弃;并根据警报 ID 构建幂等键,避免反复触发时重复呼叫。对于面向客户的中断通知,请向受影响的名单批量发送;如果回复由支持团队处理,请控制发送速率。
- 流量类型
- 事务型
- 集成
- 通过通用 webhook 操作调用 REST API
- 去重
- 根据警报 ID 生成
Idempotency-Key - 有效期
- 15 到 60 分钟
- 扇出
/v1/messages/batch,每次 API 请求最多 1,000 条消息- 无需依赖
- 移动数据、应用或推送令牌
推荐设置
02使用流程
从零开始,只需 4 步即可送达。
-
01添加 webhook 操作
大多数监控和事件工具都能使用请求头向 URL 发送 JSON POST 请求。请使用您的 API 密钥,将一项此类操作指向短信端点。
-
02去重
使用警报或事件 ID 作为幂等键。这样,当检查状态反复波动时,每个事件只会发送一条短信,而不是每次评估都发送一条。
-
03丢弃过时警报
请将有效期设为警报仍有用的时间窗口。晚三小时送达的呼叫只会制造干扰。
-
04按名单升级
先呼叫主要值班人员;如果您的工具没有看到确认,再通过第二次调用呼叫后备人员。
03关键事项
为何使用短信发送警报
推送通知需要正常运行的应用、有效令牌、移动数据和正确的手机通知设置。电子邮件需要有人正在查看。短信只需要有信号的 SIM 卡。对于必须唤醒某人的呼叫,或必须送达给因互联网本身中断而离线的客户的通知,短信是依赖项最少的渠道。
警报短信应简短且结构清晰:系统、严重程度、发生了什么、到哪里查看。锁定屏幕上显示的是前四十个字符。
04实际操作
面向客户的事件通知
中断影响客户时,向受影响名单发送一条简短短信可以防止支持工单蜂拥而至。请批量发送,为每个事件使用一个群发任务标签;如果支持热线人手不多,请控制发送速率;问题解决后还要跟进通知。这些属于服务短信:不要加入优惠,除状态页面外也不要加入其他链接。
06有效的消息示例
查看它在手机上的显示效果,以及请求中的写法。
系统、严重程度、事实以及查看位置。
curl https://api.smsmeteor.com/v1/messages \
-H "Authorization: Bearer $SMSMETEOR_KEY" \
-H "Idempotency-Key: incident-2291-page-primary" \
-H "Content-Type: application/json" \
-d '{
"to": "+4915112345678",
"from": "OPSALERT",
"text": "PROD db-eu-2 严重:复制延迟 340s。运行手册:ops.acme.com/r/db-lag",
"validity": 30,
"window": { "quiet_hours": "bypass" },
"campaign": "oncall"
}'07常见问题
我们常见的三个错误,以及避免方法。
每次检查评估都发送一条短信
状态反复波动的警报会发送数十条短信。应根据事件而非评估生成键。
事件发生时余额为空
请设置低余额 webhook 阈值,确保警报渠道绝不会停滞。
冗长的警报正文
堆栈跟踪不应放进短信。请链接到运行手册或事件。
09常见问题解答
运维警报和事件通知:常见问题。
我的监控工具可以通过 API 发送短信吗?
任何能够使用自定义请求头发送 JSON POST 请求的工具都可以:使用 Bearer API 密钥将 webhook 操作指向 /v1/messages。无需插件或 SDK。
静默时段会在夜间暂缓警报吗?
如果将 window.quiet_hours 设为 bypass 并标记为事务型,就不会暂缓。警报在任何时段都会立即发出。
检查状态反复波动时,如何避免重复呼叫?
根据事件 ID 构建 Idempotency-Key。24 小时内使用同一个键重复请求时,系统会返回原始响应,不会再次发送。
手机关机时会怎样?
运营商会不断重试,直至有效期结束。请为警报设置较短有效期,使过时呼叫被丢弃,而不是数小时后才送达。
可以向客户发送中断通知吗?
可以,请向受影响的名单批量发送,并在需要时控制发送速率。通知应保持服务性质:说明哪些方面受到影响,以及可以到哪里关注更新。
如何确保余额永远不会用尽?
请设置低余额阈值:余额低于该值时会触发 balance.low webhook;您的监控系统也可以轮询余额端点。
