告警
告警邮件、触发阈值,以及每封邮件的内容。
每个密钥可配置一个告警邮箱。当该密钥跨过 PV 或 UV 阈值时,网关向该地址发送邮件。 未填写邮箱即不告警,清空该字段即关闭告警。
告警属于 Basic 及以上套餐:FREE 档的密钥没有这个字段。套餐到期后已配置的地址仍会保留, 你随时可以把它清空(关闭告警在任何套餐下都允许)。
什么情况会发邮件
| 告警 | 触发时机 | 调用方会收到 |
|---|---|---|
| 配额用至 75% | 密钥用掉当日 PV 配额的 75% | 此时尚未拦截任何请求 |
| 配额用尽 | 密钥用掉当日全部配额 | 403 pv quota fused |
| 触达访客上限 | 密钥用掉当日不同访客的额度 | 新访客收到 429 uv quota exceeded |
有几点决定了邮件会有多吵,值得先知道:
- 75% 预警与配额用尽是两封独立的邮件。一天内用尽配额的密钥会依次收到两封。
- 触达访客上限的邮件每个密钥每天只发一封。拦截本身不是一次性的:当天此后每个新 访客都会被拦截,但这些拦截不会再产生邮件。
- 单个访客触到自己那条每访客上限,不会通知任何人——那是一个调用方在循环,不是泄露。
邮件内容
邮件是纯文本,不打开控制台也能照着行动:密钥名、当日用量与配额、调用方现在会遇到 什么、以及该做什么。以下是配额用尽时收到的正文(目前邮件只发英文):
code
"landing-demo" — All 1000 daily requests used, forwarding stopped.
The gateway is refusing this key's calls with HTTP 403 and your provider is no
longer being called, so nothing is being billed upstream. The counter resets at
00:00 UTC.
Today so far (UTC 2026-09-13)
Requests served 1000 / 1000
Distinct visitors 41 / 100
What to do: Raise the request quota to resume now, or wait for the reset.
Console: https://sluiceline.com/dashboard/manage
主题会带上密钥名与触发的事件——
[Sluiceline] landing-demo stopped forwarding: daily request quota reached ——
因此可以用邮箱规则在不打开邮件的情况下归档它们。
投递
| 属性 | 取值 |
|---|---|
| 发件人 | alerts@sluiceline.com |
| 收件人 | 密钥上填写的地址,不会发往其它地方 |
| 重试 | 不重试,投递即发即忘 |
| 对调用方的影响 | 无。投递失败不会改变客户端收到的响应 |
| 计数口径 | 当日用量,UTC。产品内所有配额均在 00:00 UTC 重置 |