配置目标指标

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

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

选择指标

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

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

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

  • 从列表中选择条目。

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

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

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

      显示直接过滤模式。

      如果您在选择 Direct filter mode 之前选择了资源类型、指标或过滤条件,则这些设置将用于预先填充 Resource type, metric, and filter 文本框。

    3. Resource type, metric, and filter 文本框中输入指标过滤条件。过滤条件必须包含指标类型和资源类型。您还可以添加标签过滤条件。如需了解过滤条件语法,请参阅 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 逻辑运算)的时间序列。

点击过滤条件字段时将显示一个面板,其中包含您可以用于过滤的条件。概括地说,您可以按资源组、名称、资源标签和指标标签过滤。

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

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

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

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

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

过滤条件比较运算符

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

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

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

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

    使用过滤条件字符串

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

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

    使用正则表达式进行过滤

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

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

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

使用多个过滤条件

分组

您可以通过组合相似时间序列中的数据来减少为指标返回的数据量。

与过滤一样,分组也是一种减少操作数据量的方式。过滤的工作原理是排除一些时间序列,而分组的工作原理则是识别所有符合某些条件的时间序列集合,然后将这些集合的成员组合(聚合)在一起。

分组是基于标签完成的。点击分组依据字段时,您会获得可用于过滤的相同标签。

通过分组依据选项,您可以按资源标签和指标标签对时间序列进行分组,然后组合这些组中的数据。这样会为每个分组依据值的组合创建单个新的时间序列,该新时间序列表示该组中的所有成员。

例如,假设您只想检查区域级别的日志记录负载,也就是说,您不关心具体服务器的条目数。您可以按地区对时间序列进行分组,然后针对每个地区的总数、平均值或其他测量结果生成图表。

分组依据选项会根据要分组的数据类型选择默认聚合函数,但您可以更改此选择。如需了解其他选项,请参阅聚合

以下屏幕截图显示了按地区分组。聚合器 (Aggregator) 下的 sum 选项是默认选项。

对时间序列分组

这样会为每个地区创建一个新的时间序列,其值是通过对该地区各个时间序列的所有值求和得出的。

您也可以按多个标签进行分组。按多个标签分组时,这些标签所形成的每个组合都会产生一个时间序列。指定标签的顺序并不重要。

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

  1. 删除分组条件标签。
  2. 将聚合方法重新设置为 none

聚合

通过聚合器 (Aggregator) 选项,您可以使用常用函数组合时间序列。这会减少显示指标的图表中的数据线数量,从而改善图表的性能。

点击聚合器 (Aggregator) 字段可以查看可用聚合选项的列表。这些是可用于组合时间序列的函数(即归纳函数)。

可用的归纳函数取决于指标捕获的值的类型,但通常包括平均值、最大值或最小值、标准差、分类百分位数值等选项。如需详细了解这些依赖项,请参阅指标、时间序列和资源

如果没有与分组搭配使用,则系统会将归纳函数应用于所有选定时间序列,然后将这些时间序列组合成单个时间序列,其中包含针对所有时间序列计算得出的平均值、总和或其他测量值。如果与分组搭配使用,则该函数将应用于每个组中的时间序列。

如需详细了解聚合,请参阅 API 参考中的 Aggregation

分组依据选项自动应用聚合在每个组内进行统计计算。分组依据图表中的线表示聚合后的结果。分组依据选项会根据要分组的数据类型选择默认聚合函数,但您可以更改此选择。

您还可以将聚合应用于已过滤的时间序列集合。 除非您也使用分组,否则与未过滤的时间序列一样,已过滤的时间序列的聚合会将所有数据线归纳为一条反映所选聚合函数的数据线。

还有其他选项可用来选择指标。这些选项具有默认值,但您可以公开这些选项并替换默认值。要查看其他选项,请点击 Show advanced options

校准

时间序列是按时间顺序排列的一组数据点。校准时间序列是将数据点划分到常规的时间段,即校准时段。多个时间序列必须经过校准才能合并。

校准是跨时间序列聚合的前提条件,分别应用于每个时间序列。由于校准是生成数据图表的前提条件,因此 Monitoring 会使用默认值自动执行该操作。您可以使用校准选项校准器校准时间段替换这些默认值:

校准选项字段

校准时间段:校准时间段决定了细分时间序列的时长。例如,您可以将时间序列分为多个区块,每个区块的时长均为一分钟或一小时。系统会对每个时间段的数据进行汇总,以便用单个值表示该时间段。默认校准时间段为一分钟。

虽然您可以为数据设置校准间隔,但是当您更改图表上显示的时间间隔或更改缩放级别时,时间序列可能会重新校准。

校准器:校准器是一个用来确定如何汇总每个校准时间段的数据的函数。校准函数包括求和函数、求平均值函数等等。 有效的校准器选项取决于时间序列所存储的指标数据的种类和类型。也就是说,校准函数选项取决于时间序列的 MetricKindValueType

某些校准函数会校准数据,并将数据从一种指标种类或类型转换为另一种。如需详细了解可用的校准器,请参阅 API 参考中的 Aligner

二次聚合

如果您有多个已经代表聚合的时间序列(例如说明分组凭据选项的示例),则可以通过选择一个 Secondary Aggregator 跨这些时间序列进行聚合:

二次聚合字段

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

图例模板

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

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

Legend Template 字段接受以下内容:

  • 纯文本。
  • 表示时间序列中的标签的变量。可用的标签取决于您正在为其生成图表的时间序列,但变量语法通常类似于 ${resource.labels.project_id}${} 表示法会让系统评估您的说明中变量的值。

如果仅提供文本,则图表中的时间序列的说明将相同。通过使用变量,您可以将时间序列标签中的值拉取到说明中。

如果您知道变量名称,可以手动将其输入模板字段。您还可以通过在该字段中使用 + 添加过滤条件微件为可用标签选择变量。此方法可以确保变量语法正确无误。

以下屏幕截图显示了一个由字符串和单个变量组成的模板:

用于简单说明的模板

在图表图例中,通过模板生成的值显示在标题为名称的列中。这些值也会显示在悬停卡片上。

以下屏幕截图显示了通过模板生成的名称值和悬停卡片:

通过模板生成的说明

您可以创建使用多个字符串和变量的模板,但悬停卡片上的可用显示空间有限。