跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

监控器

最后更新 查看 MarkdownAgent 设置

Monitors 会按计划评估 SQL API 查询。当查询结果符合检测条件时,Cloudflare 会发送通知。你可以在 Cloudflare 仪表板的 Alerts > Monitors 中创建监视器。

监视器创建页面,显示检测方法选项:阈值、异常检测或 SLO。

监视器可用的数据集取决于你的计划和权限。仪表板只会列出所选账户或 zone 可用的数据集。有关数据集范围和采样的信息,请参阅 SQL API 数据集。

创建监视器

  1. 在 Cloudflare 仪表板中前往 Alerts > Monitors。
  2. 选择 Create a Monitor。
  3. 选择检测方法:阈值、异常检测 或 SLO。
  4. 使用可视化构建器配置查询,或输入自定义 SQL。
  5. 设置检测参数(阈值、灵敏度或 SLO 目标)。
  6. 为监视器命名并添加说明。
  7. 添加一个或多个投递目标(电子邮件、Webhook 或 PagerDuty)。
  8. 选择 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

自定义 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 都低于此值时触发。你可以选择预设值或自定义。
最小事件数 可选地抑制低流量评估窗口的告警。

在两个查询中使用等效的筛选条件。不良事件查询应表示总事件查询的子集。

SLO 监视器显示错误事件查询、总事件数查询和 SLO 目标百分比。

评估和通知频率

Monitors 支持两种互相独立的频率设置:

选项 说明
执行间隔 控制 Cloudflare 运行查询的频率。将此选项保留为 Default,以使用该数据集支持的最快间隔。你可以选择预设值或输入至少一分钟的自定义时长。
重复通知间隔 控制监视器处于活动状态时 Cloudflare 再次发送通知的频率。你可以选择预设值,或输入 1 分钟至 168h 之间的自定义时长。默认值为 1h。

大多数 SQL API 数据集支持一分钟执行间隔。Log Explorer 数据集的最短执行间隔为 10 分钟。Cloudflare 会拒绝短于所选数据集支持间隔的值。

查询预览

查询预览会在保存前验证查询,并绘制信号近似图表。你可以选择最长 7 天的预览范围,以检查监视器可能的行为。预览中显示的数据可能与监视器实际评估的数据(包括历史评估数据)不同。

阈值预览会显示配置的阈值。SLO 预览会显示计算出的百分比和目标值。如果查询未返回任何行,则不会产生信号,该次评估也无法触发监视器。

这篇文档对您有帮助吗?