Monitors 会按计划评估 SQL API 查询。当查询结果符合检测条件时,Cloudflare 会发送通知。你可以在 Cloudflare 仪表板的 Alerts > Monitors 中创建监视器。
监视器可用的数据集取决于你的计划和权限。仪表板只会列出所选账户或 zone 可用的数据集。有关数据集范围和采样的信息,请参阅 SQL API 数据集。
- 在 Cloudflare 仪表板中前往 Alerts > Monitors。
- 选择 Create a Monitor。
- 选择检测方法:阈值、异常检测 或 SLO。
- 使用可视化构建器配置查询,或输入自定义 SQL。
- 设置检测参数(阈值、灵敏度或 SLO 目标)。
- 为监视器命名并添加说明。
- 添加一个或多个投递目标(电子邮件、Webhook 或 PagerDuty)。
- 选择 Create。
每个监视器都包含以下详情:
| 选项 | 必需 | 说明 |
|---|---|---|
| 名称 | 是 | 用于在通知和 Cloudflare 仪表板中标识监视器。 |
| 说明 | 否 | 记录有关监视器的其他上下文信息。 |
| 目标 | 是 | 将通知发送到至少一个电子邮件地址、Webhook 或 PagerDuty 服务。 |
最多可添加 20 个电子邮件收件人。所有套餐均可使用 Webhook。PagerDuty 需要 Business 或更高套餐的 zone。
使用查询构建器或输入自定义 SQL。查询构建器支持以下选项:
| 选项 | 说明 |
|---|---|
| 数据集范围 | 将数据集选择限制为账户级数据集或某个 zone 的数据集。 |
| 数据集 | 选择该数据集范围内可用的一个数据集。 |
| 指标 | 对数值字段应用 COUNT 或受支持的聚合函数。构建器将结果作为 value 返回。 |
| 时间范围 | 在 Manual 模式下,为每次评估设置相对的固定数据窗口,并添加时间戳边界。 |
| 筛选条件 | 按字段值限制行。可用运算符取决于字段数据类型。多个筛选条件使用 AND。 |
对于自适应采样数据集,构建器使用 APPROX_MIN 和 APPROX_MAX,而不是 MIN 和 MAX。SQL API 会自动将采样权重应用于 COUNT、SUM 和 AVG。
自定义 SQL 查询必须满足以下要求:
- 在名为
value的列中返回一个数值。 - 读取一个带 schema 限定的 SQL API 数据集。
- 包含账户或 zone 筛选条件。
- 在使用 Manual 时间范围模式时包含时间戳下界。
- 使用受支持的 SQL 语法。
- 省略末尾分号。
自定义 SQL 支持两种时间范围模式:
- 自动(推荐):省略时间戳筛选条件。监视器运行时,Cloudflare 会提供一个截至评估时间、覆盖整个执行间隔的时间范围。
- Manual:在 SQL 查询中添加固定时间范围。相对范围以评估时间为结束。
例如,以下查询返回过去五分钟内的服务器错误数量:
SELECT COUNT(*) AS value
FROM events.httpRequests
WHERE accountTag = '<ACCOUNT_TAG>'
AND timestamp >= NOW() - INTERVAL '5' MINUTE
AND edgeResponseStatus >= 500监视器会在保存前验证查询。查询错误会指出不受支持的语法、不可用的数据集或字段,以及无效的范围。有关 SQL API 查询限制,请参阅限制。
选择 Cloudflare 如何评估查询结果:
| 方法 | 说明 |
|---|---|
| 阈值 | 将查询结果与固定数值进行比较。 |
| 异常检测 | 将查询结果与历史基线进行比较,并检测峰值和/或下降。 |
| 服务级别目标 | 将成功事件占总事件的比率与服务级别目标 (SLO) 进行比较。 |
阈值监视器会将查询结果与固定值进行比较。它支持以下选项:
| 选项 | 说明 |
|---|---|
| 查询 | 生成要评估的数值。 |
| 评估窗口 | 设置每次评估的数据窗口。你可以选择预设值或输入自定义时长。 |
| 比较运算符 | 将结果与阈值进行比较。支持的运算符为 <、>、<=、>=、== 和 !=。 |
| 阈值 | 设置比较使用的数值。 |
异常检测会计算当前结果与其历史基线之间的标准差数量。它支持以下选项:
| 选项 | 说明 |
|---|---|
| 查询 | 生成要评估的数值。 |
| 评估窗口 | 设置当前数据窗口。你可以选择预设值或输入自定义时长。 |
| 基线窗口 | 设置历史比较窗口。该值必须至少为评估窗口的六倍,且不超过 24h。 |
| 触发警报的条件 | 检测突增、下降,或同时检测突增和下降。 |
| 灵敏度 | 设置 z-score 阈值。较低的值会检测更小的变化。你可以选择预设值或输入自定义值。 |
| 最小事件数 | 可选地抑制低流量评估窗口的告警。 |
新的异常检测监视器至少需要 30 分钟的历史数据才能触发。
SLO 监视器根据错误事件数和总事件数计算成功事件百分比。两个查询都必须返回一个名为 value 的数值列。它支持以下选项:
| 选项 | 说明 |
|---|---|
| 错误事件查询 | 统计不满足成功条件的事件。 |
| 总事件数查询 | 统计与不良事件查询相同总体中的所有事件。 |
| 短窗口 | 衡量短时间内的成功事件百分比,使监视器能够快速响应和恢复。 |
| 长窗口 | 衡量较长时间内的成功事件百分比,避免短暂故障触发监视器。 |
| SLO 目标 | 当两个窗口的 (1 - bad events / total events) × 100 都低于此值时触发。你可以选择预设值或自定义。 |
| 最小事件数 | 可选地抑制低流量评估窗口的告警。 |
在两个查询中使用等效的筛选条件。不良事件查询应表示总事件查询的子集。
Monitors 支持两种互相独立的频率设置:
| 选项 | 说明 |
|---|---|
| 执行间隔 | 控制 Cloudflare 运行查询的频率。将此选项保留为 Default,以使用该数据集支持的最快间隔。你可以选择预设值或输入至少一分钟的自定义时长。 |
| 重复通知间隔 | 控制监视器处于活动状态时 Cloudflare 再次发送通知的频率。你可以选择预设值,或输入 1 分钟至 168h 之间的自定义时长。默认值为 1h。 |
大多数 SQL API 数据集支持一分钟执行间隔。Log Explorer 数据集的最短执行间隔为 10 分钟。Cloudflare 会拒绝短于所选数据集支持间隔的值。
查询预览会在保存前验证查询,并绘制信号近似图表。你可以选择最长 7 天的预览范围,以检查监视器可能的行为。预览中显示的数据可能与监视器实际评估的数据(包括历史评估数据)不同。
阈值预览会显示配置的阈值。SLO 预览会显示计算出的百分比和目标值。如果查询未返回任何行,则不会产生信号,该次评估也无法触发监视器。