创建指标阈值提醒政策

本文档介绍了如何使用 Google Cloud 控制台创建基于指标的提醒政策，以便在指标的值大于或小于特定重新测试期的阈值时发送通知。例如，当 CPU 利用率高于 80% 并持续至少五分钟时，可能满足提醒政策的条件。

此内容不适用于基于日志的提醒政策。如需了解基于日志的提醒政策（此类政策会在日志中出现特定消息时通知您），请参阅监控日志。

本文档并未介绍以下内容：

准备工作

  1. 如需获取使用 Google Cloud 控制台创建和修改提醒政策所需的权限，请让管理员向您授予项目的 Monitoring Editor (roles/monitoring.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理访问权限。

    您也可以通过自定义角色或其他预定义角色来获取所需的权限。

    如需详细了解 Cloud Monitoring 角色，请参阅使用 Identity and Access Management 控制访问权限。

  2. 确保您熟悉提醒政策的一般概念。 如需了解这些主题，请参阅提醒概览。

  3. 配置要用于接收任何通知的通知渠道。为实现冗余，我们建议您创建多种类型的通知渠道。如需了解详情，请参阅创建和管理通知渠道。

创建提醒政策

如需创建一项提醒政策，以将该指标的值与静态阈值进行比较，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 提醒页面：

    进入提醒

    如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

  2. 选择创建政策。

  3. 选择要监控的时序：

    1. 点击选择指标，浏览菜单以选择资源类型和指标类型，然后点击应用。

      选择指标菜单包含可帮助您查找可用指标类型的功能：

      • 如需查找特定的指标类型，请使用 过滤条件栏。例如，如果您输入 util，则可以将菜单限制为仅显示包含 util 的条目。如果条目通过了不区分大小写的“包含”测试，系统就会显示条目。
      • 如需显示所有指标类型（包括没有数据的指标类型），请点击 活跃。默认情况下，菜单仅显示带有数据的指标类型。如需了解详情，请参阅菜单中未列出的指标。

      您可以监控任何内置指标或任何用户定义的指标。

    2. 可选：如需监控与您在上一步中选择的指标和资源类型匹配的时序的子集，请点击添加过滤条件。在过滤条件对话框中，选择过滤条件的标签、比较运算符和过滤条件值。例如，过滤条件 zone =~ ^us.*.a$ 使用正则表达式来匹配可用区名称以 us 开头、以 a 结尾的所有时间序列数据。如需了解详情，请参阅过滤所选时序。

    3. 可选：如需更改时序中点的对齐方式，请在转换数据部分中设置滚动窗口和滚动窗口函数字段。

      这些字段指定如何组合窗口中记录的点。例如，假设窗口为 15 分钟，窗口函数为 max。校准点是最近 15 分钟内所有点的最大值。如需了解详情，请参阅校准：系列内正则化。

      您还可以使用滚动窗口函数字段来监控指标值的变化率，以监控百分比变化。有关详情，请参阅监控变化率。

    4. 可选：如果您想要减少政策监控的时序数量，或者您想要仅监控时序的集合，则可以组合时序。例如，您可能想要计算一个地区中所有虚拟机的 CPU 利用率的平均值，然后监控该平均值，而不是监控每个虚拟机实例的 CPU 利用率。默认情况下，系统不会合并时序。如需了解一般信息，请参阅归约：合并时序。

      如需组合所有时序，请执行以下操作：

      1. 在跨时序部分中，点击 展开。
      2. 将时间序列聚合字段设置为 none 以外的值。例如，如需显示时序的平均值，请选择 mean。
      3. 确保时间序列分组依据字段为空。

      如需按标签值对时序进行组合或分组，请执行以下操作：

      1. 在跨时序部分中，点击 展开。
      2. 将时间序列聚合字段设置为 none 以外的值。
      3. 在时间序列分组依据字段中，选择分组依据的标签。

      例如，如果您按 zone 标签进行分组，然后将聚合字段的值设置为 mean，则图表会针对有数据的每个区域显示一个时序。特定区域显示的时序是该区域所有时序的平均值。

    5. 点击下一步。

  4. 配置条件触发器：

    1. 将 Condition type 字段保留为 Threshold 的默认值。

    2. 为提醒触发器菜单选择一个值。通过此菜单，您可以指定必须超出阈值才能满足条件的时序的子集。

    3. 使用阈值位置和阈值字段，在指标值违反阈值时进行输入。例如，如果您将这些值设为高于阈值和 0.3，则任何高于 0.3 的测量值都会违反阈值。

    4. 可选：如需选择测量结果必须达到阈值多长时间后 Monitoring 才会发送通知，请展开高级选项，然后使用重新测试窗口菜单。

      默认值为 No retest。使用此设置时，单次测量可能会导致通知。如需了解详情并查看示例，请参阅校准时间段和时长设置。

    5. 可选：如需指定 Monitoring 在数据不再到达时如何评估条件，请展开高级选项，然后使用评估缺少数据菜单。

      当 Retest window 的值为 No retest 时，Evaluation missing data 菜单处于停用状态。

      Google Cloud 控制台
      “评估缺失数据”字段      		 摘要 详情
      缺少数据为空 未结突发事件保持未结状态。
      新的突发事件不会被创建。

      如果满足的条件，当数据不再到达时，条件将继续满足。如果突发事件针对此条件未结，则突发事件会保持未解决状态。如果突发事件未解决，但未收到任何数据，则自动关闭计时器会在延迟至少 15 分钟后启动。如果计时器过期，则事件已关闭。

      对于不满足的条件，当数据不再到达时，不再满足条件。
      缺失的数据点会被视为违反政策条件的值 未结突发事件保持未结状态。
      可以创建新突发事件。

      如果满足的条件，当数据不再到达时，条件将继续满足。如果突发事件针对此条件未结，则突发事件会保持未解决状态。如果突发事件在自动关闭时长加 24 小时内未到达，则突发事件会被关闭。

      对于不符合的条件，此设置会导致指标阈值条件的行为类似于 metric-absence condition。如果数据未在重新测试窗口指定的时间内到达，则条件评估为满足。对于包含一个条件的提醒政策，满足该条件会导致创建突发事件。
      缺失数据点被视为未违反政策条件的值 未结突发事件已关闭。
      新的突发事件不会被创建。

      对于满足的条件，当数据不再到达时，不再满足条件。如果某个突发事件符合此条件，则该突发事件会被关闭。

      对于不满足的条件，当数据不再到达时，不再满足条件。

    6. 点击下一步。

  5. 可选：创建包含多个条件的提醒政策。

    大多数政策会监控单个指标类型，例如，政策可能会监控写入虚拟机实例的字节数。如果要监控多种指标类型，请创建包含多个条件的政策。每个条件会监控一种指标类型。创建条件后，您可以指定条件的组合方式。如需了解详情，请参阅包含多个条件的政策。

    如需创建具有多个条件的提醒政策，请执行以下操作：

    1. 对于每个额外的条件，请点击添加提醒条件，然后配置该条件。
    2. 点击下一步，然后配置条件的组合方式。
    3. 点击下一步进入通知和文档设置。

  6. 配置通知：

    1. 展开通知和名称菜单，然后选择您的通知渠道。为实现冗余，我们建议您在提醒政策中添加多种类型的通知渠道。如需了解详情，请参阅管理通知渠道。

    2. 可选：如需在突发事件关闭时收到通知，请选择突发事件关闭时通知。默认情况下，当您使用 Google Cloud 控制台创建提醒政策时，只有在创建突发事件时才会发送通知。

    3. 可选：如需更改在数据停止到达后，监控在关闭突发事件之前等待的时间，请从突发事件自动关闭时长菜单中选择一个选项。默认情况下，当数据不再到达时，Monitoring 会等待七天再关闭未结突发事件。

    4. 从政策严重级别菜单中选择一个选项。突发事件和通知会显示严重级别。

    5. 可选：如需为提醒政策添加自定义标签，请在政策用户标签部分中执行以下操作：

      1. 点击添加标签，然后在键字段中输入标签的名称。标签名称必须以小写字母开头，可以包含小写字母、数字、下划线和短划线。例如，输入 severity。
      2. 点击值，然后输入标签的值。标签值可以包含小写字母、数字、下划线和短划线。例如，输入 critical。

      如需了解如何使用政策标签来帮助管理通知，请参阅使用标签为突发事件添加注解。

  7. 可选：在 Documentation 部分中，输入您希望通知包含的任何内容。

    如需设置文档格式，您可以使用纯文本、Markdown 和变量。您还可以添加可帮助用户调试突发事件的链接，例如指向内部 playbook、Google Cloud 信息中心和外部页面的链接。例如，以下文档模板描述了 gce_instance 资源的 CPU 利用率突发事件，并包含了几个变量来引用提醒政策和条件 REST 资源。然后，该文档模板会将读者定向到外部页面以帮助进行调试。

    创建通知后，Monitoring 会将文档变量替换为它们的值。 这些值仅替换通知中的变量。预览窗格和 Google Cloud 控制台中的其他位置仅显示 Markdown 格式。

    预览

    ## CPU utilization exceeded

### Summary

The ${metric.display_name} of the ${resource.type}
${resource.label.instance_id} in the project ${resource.project} has
exceeded 90% for over 15 minutes.

### Additional resource information

Condition resource name: ${condition.name}  
Alerting policy resource name: ${policy.name}  

### Troubleshooting and Debug References

Repository with debug scripts: example.com  
Internal troubleshooting guide: example.com  
${resource.type} dashboard: example.com

    通知中的格式

    文档如何在通知中呈现的示例。

    如需了解详情，请参阅使用用户定义的文档为通知添加注释和使用渠道控件。

  8. 点击提醒名称，然后输入提醒政策的名称。

  9. 点击创建政策。

过滤所选时序

过滤条件可确保仅监控符合某些条件的时序。应用过滤条件时，您可以减少图表上的线条数量，从而提升图表的性能。您还可以通过应用汇总来减少监控的数据量。 过滤条件可确保仅使用符合部分条件的时序。应用过滤条件时，需要评估的时序较少，因此可以提高提醒的性能。

过滤器由标签、比较运算符和值组成。例如，如需匹配 zone 标签以 "us-central1" 开头的所有时序，您可以使用过滤条件 zone=~"us-central1.*"，该过滤条件使用正则表达式执行比较。

按项目 ID 或资源容器进行过滤时，您必须使用等号运算符 (=)。按其他标签过滤时，您可以使用任何受支持的比较运算符。通常，您可以按资源组过滤指标和资源标签。

如果您提供多个过滤条件，则系统只会监控满足所有条件的时序。

如需添加过滤条件，请点击添加过滤条件，完成对话框，然后点击完成。在对话框中，您可以使用过滤条件字段来选择要过滤的条件，选择比较运算符，然后选择值。 下表中的每一行都列出了一个比较运算符及其含义和示例：

运算符含义示例
= 相等 resource.labels.zone = "us-central1-a"
!= 不相等 resource.labels.zone != "us-central1-a"
=~ 正则表达式 2 等式 monitoring.regex.full_match("^us.*")
!=~ 正则表达式 2 不等式 monitoring.regex.full_match("^us.*")
starts_with 值开头为 resource.labels.zone = starts_with("us")
ends_with 值结尾为 resource.labels.zone = ends_with("b")
has_substring 值包含 resource.labels.zone = has_substring("east")
one_of 以下之一 resource.labels.zone = one_of("asia-east1-b", "europe-north1-a")
!starts_with 值开头不是 resource.labels.zone != starts_with("us")
!ends_with 值结尾不是 resource.labels.zone != ends_with("b")
!has_substring 值不包含 resource.labels.zone != has_substring("east")
!one_of 值不是以下项之一 resource.labels.zone != one_of("asia-east1-b", "europe-north1-a")

问题排查

本部分包含问题排查提示。

可用指标菜单中未列出指标

如需监控选择指标菜单中未列出的指标，请执行以下操作之一：

  • 如需创建用于监控 Google Cloud 指标的提醒政策，请展开 Select a metric 菜单，然后点击 Active。停用后，该菜单会列出 Google Cloud 服务的所有指标以及包含数据的所有指标。

  • 如需在自定义指标类型生成数据之前为自定义指标类型配置条件，您必须使用 Monitoring 过滤条件指定指标类型：

    1. 选择 ?（在选择指标部分的标题中），然后选择提示中的直接过滤模式。

    2. 输入监控过滤条件或时序选择器。 如需了解语法，请参阅以下文档：

监控变化率

如需监控指标值的变化率，请将滚动窗口函数字段设置为百分比变化。评估条件时，Monitoring 会以百分比形式计算指标的变化率，然后将该百分比与条件的阈值进行比较。此比较过程分为两个步骤：

  1. 如果时序具有 DELTA 或 CUMULATIVE 指标种类，则该时序将转换为具有 GAUGE 指标种类的时序。如需了解转换，请参阅种类、类型和转换。
  2. Monitoring 通过将最近 10 分钟滑动窗口的平均值与校准期开始前 10 分钟滑动窗口的平均值进行比较来计算变化百分比。

您无法更改变化率提醒政策中用于比较的 10 分钟滑动窗口。不过，您可以在创建条件时指定校准时间段。

后续步骤