配置目标指标

本页介绍如何使用指标选择工具来指定提醒政策的目标指标。Target 区域旁的图表可向您直观地反馈相应目标所采集到的数据。

Target 区域使用的指标选择器与 Metrics Explorer 中用于创建图表的选择器相同。如果您已熟悉该指标选择器,可以跳过本页。

选择指标

要选择指标,请使用 Find resource type and metric 字段选择一种资源类型和一种指标类型。您可以按任意顺序指定它们。首先,点击该字段。系统将根据以前的选择显示出一个或两个列表。列表包括标题、Resource typesMetrics,如以下屏幕截图所示:

用于选择指标和资源的搜索列表

您可以通过两种方式选择条目:

  • 从列表中选择条目。

  • 输入指标过滤器。要输入指标过滤条件,请执行以下操作:

    1. 点击查找资源类型和指标 (Find resource type and metric) 旁边的帮助
    2. 点击帮助窗格中的 Direct filter mode

      启用直接过滤模式 (Direct filter mode) 后,查找资源类型和指标 (Find resource type and metric) 选项将被替换为标有资源类型、指标和过滤器 (Resource type, metric, and filter) 的可编辑文本框:

      显示直接过滤模式。

      如果您在选择直接过滤模式之前选择了资源类型、指标或过滤器,则这些设置将用于预先填充资源类型、指标和过滤器文本框。

    3. 资源类型、指标和过滤器文本框中输入指标过滤器。过滤条件必须包含指标类型和资源类型。 您还可以添加标签过滤条件。如需了解过滤器语法,请参阅 Monitoring 过滤器

      例如,要显示 us-east1-b 地区中所有 Google Cloud 虚拟机实例的日志条目,请输入以下内容:

      metric.type="logging.googleapis.com/log_entry_count" resource.type="gce_instance" resource.label."zone"="us-east1-b"
      

      如果您使用直接过滤模式来配置图表或提醒政策,但没有可用的数据,则图表会显示错误消息。具体的错误消息取决于输入的过滤条件。例如,典型的消息是 Chart definition invalid。您可能还会看到消息 No data is available for the selected time frame.

将鼠标悬停在任一个列表中的某个条目上,系统即会显示一个提示,上面显示该条目的描述符中的信息。如需了解指标类型或受监控的资源的描述符,请参阅指标列表受监控的资源列表

选择了至少一对资源类型和指标后,图表将显示所有可用的时间序列,其他条目将在 Metric 标签的指定指标下方显示。以下屏幕截图显示了指定指标后的指标 标签:

显示其他选择选项。

过滤

您可以通过指定过滤条件来减少为指标返回的数据量,以便只使用符合某些条件的时间序列。 如果应用过滤条件,图表上的行数会更少,从而改善图表的性能。

您可以应用多个过滤条件。相应图表仅显示符合所有条件(即 AND 逻辑运算)的时间序列。

在 Google Cloud Console 中,要添加过滤条件,请点击过滤条件字段。这将打开一个面板,其中包含可作为过滤条件的条件列表。例如,您可以按资源组、名称、资源标签、区域和指标标签过滤。

以下屏幕截图显示了某项目的已知过滤条件标签:

预填充的过滤条件标签列表

您可以从列表中选择,或在字段中手动输入文本来查找匹配项。另外,您可以为尚未出现的数据创建过滤条件;此类过滤条件不会出现在选项列表中,但您可以手动指定您认为将来会有效的过滤条件。

选择过滤条件标签后,您必须指定过滤的其余部分:值或值的范围,以及比较方式。

例如,以下屏幕截图显示了一个对 zone 资源标签应用的过滤器。过滤器字段支持一对相等性比较运算符(==~)和一对不等性比较运算符(!=!=~)。每对运算符中的第二项采用正则表达式作为值。默认值为简单的相等性运算符 =

过滤条件比较运算符

比较运算符列表下方是可用值列表。以下屏幕截图显示了项目中地区的名称:

一些预先填充的过滤条件值

对于 Value 字段,您可以从下拉列表中选择一项内容,也可以输入与多项内容匹配的表达式:

  • 如果您使用直接比较运算符 =!=,则可以创建一个类似 starts_with 的过滤器字符串。例如,过滤器字符串 starts_with("us-central") 可与任何 us-central 地区匹配:

    使用过滤条件字符串

    如需详细了解过滤字符串,请参阅 Monitoring 过滤条件

  • 如果您选择 =~!=~,则可以在值中使用 RE2 正则表达式。例如,正则表达式 us-central1-.* 可与任何 us-central1 地区匹配:

    使用正则表达式进行过滤

    正则表达式 ^us.*.a$ 可与任何以“a”结尾的美国地区匹配:

    使用更多正则表达式进行过滤

您可以指定多个过滤条件,并且可以多次使用相同的标签。这允许您指定一个可获得一系列值的过滤条件。要添加其他过滤条件,请点击过滤条件字段底部附近的 Add a filter。 目前,所有过滤器都必须满足,它们共同构成逻辑 AND。例如,您可以同时使用 starts_withends_with 过滤器字符串以仅显示在美国的“a”地区:

使用多个过滤条件

聚合

选择时间序列后,下一步是指定聚合选项。聚合包括对单个时间序列进行校准,然后对校准后的时间序列进行合并。如需详细了解聚合,请参阅过滤和聚合:处理时间序列

校准数据

校准是将 Monitoring 收到的时间序列数据转换为数据点按固定时长间隔的新时间序列的过程。校准过程包括收集固定长度间隔内收到的所有数据点、应用函数来合并这些数据点,以及为结果分配时间戳。组合函数可能会计算所有样本的平均值,或者提取所有样本的最大值。如需简要了解对准,请参阅对准:系列内正则化

为提醒政策创建条件时,您必须指定校准参数。如果您使用的是 Google Cloud Console,在提醒发出条件中选择资源类型和指标后,系统会显示多个其他字段和一个标题为显示高级选项的按钮:

显示时间段字段。

时间段:时间段是从特定时间点算起的回溯间隔。例如,如果时间段为五分钟,则在下午 1:00,将校准在中午 12:55 和下午 1:00 之间收到的样本。在下午 1:01,将校准在中午 12:56 到下午 1:01 之间收到的样本。在提醒政策中,可以将校准时间段视为看起来像过去的滑动窗口。如需详细了解此字段,请参阅校准时间段和时长

要查看其余聚合选项,请点击显示高级选项

显示高级选项。

校准器:校准器字段指定函数以用于合并校准时间段内的所有数据点。如需详细了解可用的校准器,请参阅 API 参考文档中的 Aligner。 某些校准函数会校准数据,并将数据从一种指标种类或类型转换为另一种。如需详细说明,请参阅种类、类型和转换

合并时间序列

您可以通过组合不同的时间序列来减少为指标返回的数据量。要组合多个时间序列,您通常需要指定一个分组和一个函数。分组是基于标签完成的。 Google Cloud Console 中名为 Aggregator 的函数用于将组中的时间序列组合为单个时间序列。典型聚合器包括平均值、最大值、最小值、标准差和分类百分位值。

要添加分组,请点击分组依据文本框中的添加标签,然后从菜单中选择。该菜单动态构建并显示可用标签。这些标签与您可用于过滤的标签相同。添加第一个分组选项时,会出现以下情况:

  • 选择一个聚合器。所选函数取决于显示的数据类型;但您可更改此函数。
  • 聚合器会将标签值相同的所有时间序列合并为一个时间序列。
  • 图表为分组依据标签的每个值显示一个时间序列。

以下屏幕截图显示了 user_labels.version 的分组,其中聚合器设置为 sum 的默认值:

分组设置示例。

此选择会为 user_labels.version 的每个值生成一个时间序列。每个时间序列中的数据点都是根据特定版本的各个时间序列的所有值之和计算得出的:

显示按 user_labels.version 分组的时间序列

您可以按多个标签分组。如果您有多个分组选项,则按每个标签值组合对时间序列进行分组,并将聚合器应用于每个分组。生成的图表显示每个标签组合的一个时间序列。为标签指定的顺序并不重要。

例如,以下屏幕截图展示了按 user_labels.versionsystem_labels.machine_image 分组:

按版本和机器映像显示时间序列。

如图所示,如果您按这两个标签进行分组,则会得到针对两对值的一个时间序列。实际上,每个标签组合都有一个时间序列,这意味着这种方法可以轻松创建更多数据,而不是您在单个图表中有用的数据。

如果您未指定分组选项且指定了聚合器,则聚合器将应用于所有选定的时间序列,并产生单个时间序列。以下屏幕截图展示了此行为:

显示总和(而非分组)的聚合时间序列

指定分组或选择“聚合器”时,生成的时间序列仅包含强制性标签,例如项目标识符和分组指定的标签。

要移除分组条件,您必须执行以下操作:

  1. 删除分组条件标签。
  2. 将聚合器设置为 none

二次聚合

如果您有多个已经表示聚合的时间序列(例如说明 Group By 选项的示例),则可以通过选择 Secondary Aggregator 来聚合这些时间序列:

二次聚合字段

二次聚合操作会将图表上的所有时间序列归纳为单个时间序列。

图例模板

在 Cloud Console 中,如果您通过点击显示高级选项展开聚合选项,那么除了显示校准器、校准时间段和辅助聚合器的字段外,还会显示图例模板字段。

显示图例模板字段的位置。

通过 Legend Template 字段,您可以为图表上的时间序列自定义说明。这些说明显示在图表的悬停卡片上以及名称列中的图表图例上。

默认情况下,系统会根据时间序列中不同标签的值创建图例中的说明。由于这些标签由系统选择,生成的结果可能对您来说没有什么用处。您可以使用该字段为说明构建模板。

Legend Template 字段接受以下内容:

  • 引用时间序列中的标签的过滤器。要查看适用于您的时间序列的所有过滤器,请点击添加过滤器。选择过滤器后,系统会将该过滤器添加到文本框中,并以 ${resource.labels.zone} 等表达式表示。评估表达式时,系统会从时间序列的标签中拉取值并插入到图例中。

  • 纯文本。如果仅提供文本,则图表中的时间序列的说明将相同。不过,您可以结合使用文本和过滤器。

例如,以下屏幕截图显示了由纯文本字符串和过滤器表达式 ${resource.labels.zone} 组成的模板:

用于简单说明的模板

在图表图例中,通过模板生成的值显示在标题为名称的列以及悬停卡片中:

通过模板生成的说明

您可以创建使用多个字符串和过滤器的模板,但悬停卡片上的可用显示空间会受到限制。