选择要用于绘制图表的数据

本页面介绍如何指定图表应显示哪些数据。如需了解如何配置图表样式，请参阅设置视图选项。

选择要显示的数据

要填充图表，您必须指定至少一对值：

• 一种指标类型，用于识别可从受监控资源收集的测量结果。指标类型包括对要测量的内容以及如何解释测量结果的说明。指标类型有时称为指标。如需了解概念性信息，请参阅指标类型。

• 受监控资源指定从中捕获指标数据的资源。受监控资源有时称为受监控资源类型或资源。如需了解概念性信息，请参阅受监控资源。

Monitoring 提供了许多预定义指标类型和受监控资源，您也可以创建自定义指标：

• 如需了解预定义指标类型，请参阅指标列表。指标按服务类型列出。例如，Google Cloud 指标页面包含一系列表格，每个表格对应一个 Google Cloud 服务。

• 如需了解可用的受监控资源类型，请参阅受监控资源列表。

• 如需了解如何定义您自己的指标，请参阅使用自定义指标。

指标规范字段

信息中心编辑器

当您将微件从微件库拖动到图表区域时，系统会显示一个图表，其中包含预先选定的资源类型和指标：

您可以通过不同的方法来指定图表中的数据：

• 要快速配置图表，请使用基本模式。此选项具有最小的配置选项。基本配置始终可在其他模式下显示。如需了解详情，请参阅使用基本或高级模式。

• 要访问所有图表配置字段，请使用 高级模式。使用此模式可访问大多数聚合字段。如需了解详情，请参阅使用基本或高级模式。

  注意：如果您使用高级模式配置图表，然后选择基本模式。当您在 高级模式中选择的配置无法使用基本模式的可用选项时显示。

• 如需用查询语言配置图表，请用 MQL 模式。在此模式下，您可以访问查询编辑器。如果使用 MQL，则其他模式无法表示该配置。如需了解 MQL，请参阅 MQL 简介。

  注意：MQL 查询不能由基本版或高级版 模式显示。如果您使用 MQL 配置图表，则要保留该配置，请勿访问基本或高级模式。您可以选择将查询复制到剪贴板。

使用基本或高级模式

资源类型菜单列出了包含指标数据的每个受监控资源。指标菜单由对资源类型的选择确定。

• 要在菜单中查找特定条目，请使用滚动条或在菜单的过滤条件 区域中输入文本。输入文本时，菜单项仅限于包括输入文本的内容。

  以下屏幕截图显示了指标字段的展开菜单。过滤条件栏包含文本 lat，因此此菜单只会列出包含该字符串的条目：

  

  请注意，上一屏幕截图中会突出显示指标 Late Boot Validation。将指针放置在条目上时，系统会打开一个窗格并显示该指标的详细信息。如图所示，此窗格列出了指标种类、值类型和说明字段等。

如果要访问尚无数据的资源类型或指标，则需要更改默认行为：

• 如需选择任何资源类型，请展开资源类型菜单，然后取消选中仅显示活跃资源类型。

• 如需查看所选资源类型的所有指标，包括没有数据的指标，请展开指标菜单，然后取消选中 Only show active。

• 如需能够选择任何指标，请点击资源类型菜单上的关闭 ，然后查找所需条目。点击资源类型上的关闭后，指标菜单将包含所有指标。

• 要查看或修改 Cloud Monitoring API 使用的资源类型、指标和过滤条件设置，请点击 资源类型菜单中的 Direct filter mode。

旧版信息中心编辑器

要选择指标，请使用查找资源类型和指标字段来选择一种受监控资源和一种指标类型。您可以按任意顺序指定它们。首先，点击该字段中的提示文本以显示包含一个或两个部分的列表，这取决于上一选择。这些部分包括标题、资源类型和指标，如以下屏幕截图所示：

要完成资源类型和指标的选择，请执行以下操作之一：

• 输入值或选择列表中的值。

  系统会根据您输入的任何文本过滤列表。例如，如果您输入 CPU Usage，则列表的每个成员都包含 CPU 和 usage。

  由于资源类型比指标少，因此请先选择资源类型。如果您的资源类型未显示在短列表中，请点击查看全部。选择资源类型后，系统会自动过滤指标列表以仅显示相关的指标。

• 按照以下步骤输入指标过滤条件：

  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.

如需查看菜单项的详细信息，请将指针放在该菜单项上方。如需了解指标类型或受监控的资源的描述符，请参阅指标列表或受监控的资源列表。

以下屏幕截图显示了仅根据选定的指标和资源（不含其他配置）生成的结果图表：

该图表包含的数据过多，无法全部显示；图表可显示的数据线限制是 300 条。 要减少数据量，您可以应用过滤条件、应用聚合或使用离群值模式。

注意：您不能从控制台中选择值类型为字段串的指标类型。字符串值数据无法显示在图表中，也不能用于提醒政策。要检索这些指标类型的数据，您必须使用 API 中的方法，例如 timeSeries.list。

过滤数据

您可以通过指定过滤条件、应用聚合或使用离群值模式来减少用来绘制图表的数据量。过滤条件可确保仅使用符合部分条件的时间序列。如果应用过滤条件，图表上的行数会更少，从而改善图表的性能。

如果您提供多个过滤条件，则相应图表仅显示符合所有条件（即逻辑 AND）的时间序列。

信息中心编辑器

本部分介绍在选择基本或高级模式时如何配置过滤条件。如果选择 MQL 模式，请使用查询编辑器。

通常，您可以按资源组、名称、资源标签、可用区和指标标签进行过滤。

如需添加过滤条件，请点击添加过滤条件，然后指定过滤条件标签、比较以及值或值范围：

1. 点击标签，然后从菜单中选择一个条目。

   如需查找特定标签，您可以使用滚动条，或在过滤条件 文本区域中输入文本。输入文本时，仅显示包含输入文本的菜单条目。

   以下屏幕截图显示了特定指标的已知过滤条件标签：

   

2. 点击比较，然后从菜单中选择一个条目，或保留默认值。您可以选择四个运算符：等于、=、不等于、!=、正则表达式匹配、=~ 和正则表达式不匹配：!=~

   

3. 点击值，然后执行以下任一操作：

   • 如果您选择了直接比较运算符 = 或 !=，请从菜单中进行选择，或者点击修改 并输入值。输入的值可以是简单值（如 us-central1-a），或者您可以创建以 starts_with 或 ends_with 开头的过滤条件字符串。例如，如需显示任何 us-central1 可用区的数据，您可以输入过滤条件字符串 starts_with("us-central1")。如需详细了解过滤条件字符串，请参阅 Monitoring 过滤条件。

     由于菜单条目来自收到的时间序列，因此，如果受监控的资源没有为所选指标生成数据，则您必须为标签输入一个值。

     以下屏幕截图显示了选择 zone 资源标签时显示的特定项目的值菜单：

     

   • 如果您选择了正则表达式比较运算符 =~ 或 !=~，请在值中输入 RE2 正则表达式。例如，正则表达式 us-central1-.* 可与所有 us-central1 区域匹配：

     要匹配以“a”结尾的任何美国地区，您可以使用正则表达式 ^us.*.a$。

     注意：您不能使用正则表达式来过滤 project_id 资源标签。

     例如，如果您只想查看来自某个 us-central1 可用区的时间序列，则应用 zone="starts_with("us-central1")" 或 zone=~"us-central1.*" 过滤条件：

     

注意：您可以修改过滤条件。要修改过滤条件，请双击过滤组件，使其处于修改模式。更改完成后，按 Enter 键。保存过滤条件时，过滤器的样式会短暂发生变化。

您可以指定多个过滤条件，并且可以多次使用相同的标签。这允许您指定一个可获得一系列值的过滤条件。 所有过滤条件都必须满足，它们共同构成逻辑 AND。例如，以下配置可用于同时使用 starts_with 和 ends_with 过滤条件字符串以仅显示美国的“a”可用区：

旧版信息中心编辑器

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

以下屏幕截图显示了特定指标的已知过滤条件标签：

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

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

注意：如果受监控的资源没有为所选指标生成数据，则过滤器的值菜单将不包含该受监控资源的信息。例如，假设您的项目包含一个已停止的虚拟机实例。假设您为虚拟机实例的 CPU 使用率创建了一个图表。接下来，添加过滤器并选择 instance_id。在这种情况下，列出所有可用实例的值菜单为空。不过，您可以手动输入该值，然后选择应用。

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

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

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

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

  

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

• 如果您选择 =~ 或 !=~，请输入 RE2 正则表达式作为值。例如，正则表达式 us-central1-.* 可与任何 us-central1 地区匹配：

  

  注意：您不能使用正则表达式来过滤 project_id 资源标签。

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

  

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

如果使用 zone="starts_with("asia-east1")" 或 zone=~"asia-east1.*" 过滤条件，则系统会只显示来自 asia-east1 地区之一的数据的时间序列：

选择如何显示数据

选择时间序列数据后，下一步是确定该数据的显示方式。例如，您想要显示每个时间序列，还是想将时间序列组合在一起？

您可以通过配置聚合选项来指定数据的显示方式。聚合包括校准时间序列数据，然后将不同的时间序列组合在一起。合并时间序列是可选操作。

如需详细了解聚合，请参阅过滤和聚合：处理时间序列。

校准数据

校准是将 Monitoring 接收到的时间序列数据转换为在固定时间间隔内具有数据点的新时间序列的过程。校准过程包括收集在固定时间段内收到的所有数据点、应用函数以组合这些数据点，以及为结果分配时间戳。该函数可能会计算所有样本的平均值，或者提取所有样本的最大值。

校准时间段（信息中心编辑器）或时间段字段（旧版信息中心编辑器）指定校准时间序列数据时要使用的最短时间间隔。当选定显示时段内图表数量太多时，会自动增加校准时间段，以便显示每个数据点。此字段的默认设置为 1 分钟。

例如，假设某个指标的采样周期为一分钟。如果图表配置为显示 1 小时的数据，则图表可以显示全部 60 个数据点。如果校准时间段设置为 10 minutes，则图表会显示 6 个数据点。但是，如果您将图表配置为显示一周数据，则图表中显示的点过多，因此系统会自动修改时间段。在此示例中，修改后的校准时间段为一小时。

校准函数 (Alignment function) 字段（信息中心编辑器）或校准器字段（旧版信息中心编辑器）指定用于组合校准时间段内的所有数据点的函数。大多数校准器会执行常见的数学函数。例如，如果您选择最小值，则校准数据点是校准时间段中所有数据点的最小值。部分校准器会执行更复杂的操作：

• next older：要仅保留校准时间段中的最新样本，请使用 next older 校准器。此校准器通常用于正常运行时间检查，当您仅关心最新值时，这是一个不错的选择。

  此校准器仅适用于采样平均值指标。

• 百分位：要在折线图、堆叠面积图或堆叠条形图上显示分布指标，您必须选择要显示分布中的哪个百分位。指定此百分位的一种方法是选择一个百分位校准器。您可以选择第 5、第 50、第 95 和第 99 百分位。使用校准时间段内的所有数据点来计算指定的百分位，从而确定校准数据点。

  此校准器仅适用于具有分布数据类型的采样平均值指标和增量指标。

• 增量：如需将累积指标或增量指标转换为每个校准时间段一个样本的增量指标，请使用此校准器。此校准器可能会导致数据插值。如需查看示例，请参阅种类、类型和转换。

  此校准器仅适用于累积指标和增量指标。

• 速率：如需将累积指标或增量指标转换为采样平均值指标，请使用此校准器。如果选择此校准器，您可以将时间序列想象为通过增量校准器进行转换，然后除以校准时间段。例如，如果原始时间序列的单位为 MiB 且校准时间段的单位为秒，则此校准器会生成一个单位为 MiB/秒的图表。如需了解详情，请参阅种类、类型和转换。

  此校准器仅适用于累积指标和增量指标。

如需详细了解可用的校准器，请参阅 API 参考文档中的 Aligner。

要访问校准字段，请执行以下操作：

信息中心编辑器

• 基本模式：所有校准字段均已预先配置。

• 高级模式：在您选择资源类型和指标后，可访问所有校准选项。这些字段有默认值；但可修改选择。

• MQL 模式：可使用所有校准选项。

旧版信息中心编辑器

选择资源类型和指标后，校准面板中将显示校准时间段：

如需查看对齐函数，请点击显示高级选项：

以下屏幕截图说明了特定 Google Cloud 项目中 Compute Engine 虚拟机实例的 CPU 利用率。在此图片中，校准字段采用默认值：校准函数设置为 mean，校准时间段设置为 1 minute：

为便于比较，下面的屏幕截图说明了将时间段从 1 minute 更改为 5 minutes 的效果：

通过增加此时间段，生成的图表的点数会减少，每个时间序列的 60 点数将减少到每个时间序列 10 个点。图表上的每个点通过计算校准时间段的时间序列平均值来计算。扩大校准时间段后，点中的平均值也会增加，会让已绘制的数据更流畅。

合并时间序列

您可以通过组合不同的时间序列来减少为指标返回的数据量。要组合多个时间序列，您通常需要指定一个分组和一个函数。分组是通过标签值完成的。该函数定义了如何将群组中的所有时间序列合并成一个新的时间序列。

信息中心编辑器

如需对时间序列进行分组和组合，请执行以下操作之一：

• 基本模式

  1. 确定如何对时间序列进行分组：

     • 要显示每个时间序列，请取消选中分组。
     • 如需按标签值对时间序列进行分组，请选中分组，然后使用分组依据菜单选择用于分组的标签。选择后，点击确定。

  2. 确定如何组合数据点：

     • 如果单选按钮仅列出百分位，则表示您选择的指标具有分布值。使用单选按钮从分布中选择要查看的分布的百分位。

     • 如果单选按钮列出了 mean、min 和 max，则表示您选择了具有数值的指标。使用这些按钮可指定数据点作为图表过程的一部分。为了理解这些组合器的工作原理，我们假设图表可显示 60 个数据点，并假设数据速率为每分钟 1 点。如果显示一小时的数据，则图表可以显示所有点。但是，如果要显示 3 小时的数据，则必须将 180 个数据点减少为 60，这是图表可以显示的点数量。减少数据的一种方法是，取三个相邻样本的平均值，另一方法是采用最小值。

• 高级模式：

  • 要将所有时间序列合并到一个时间序列中，请确保分组依据为空，并使用按函数分组菜单选择时间序列的组合方式。

    注意：如果您要在热图图表上显示时间序列，则必须使用此选项。如需了解详情，请参阅绘制分布指标图表。

  • 如需显示所有时间序列，请执行以下操作之一：

    • 确保分组依据为空，并为按函数分组选择 none。
    • 点击分组依据菜单，选择添加全部，然后选择按函数分组。对于存储数值的指标，按函数分组可能不会生成明显不同的图表。

  • 要按特定标签值对时间序列进行分组，请点击分组依据，然后选择要分组的标签。要指定时间序列的组合方式，请使用按函数分组菜单选择一个函数。

• MQL 模式：

  如需了解如何监控查询语言，请参阅使用查询编辑器。

以下屏幕截图显示了按 user_labels.version 分组，其中按函数分组设置为默认值 sum 的分组。此选择会为 user_labels.version 的每个值生成一个时间序列。每个时间序列中的数据点都是根据特定版本的各个时间序列的所有值之和计算得出的：

旧版信息中心编辑器

要添加分组，请点击分组依据文本框中的文本，然后从菜单中选择。菜单是根据您选择的资源和指标的时间序列数据动态构建的。分组和过滤使用相同的标签集。

添加第一个标签时，将出现以下情况：

• 选择一个聚合器。所选函数取决于显示的数据类型；但您可更改此函数。
• 聚合器确定如何将具有相同标签值的时间序列合并为单个时间序列。
• 图表为分组依据文本框中列出的每个标签值显示一个时间序列。

如果按多个标签分组，则聚合器将合并指定标签具有相同值的时间序列。

如果您未指定分组选项且指定了聚合器，则聚合器将应用于所有选定的时间序列，并产生单个时间序列。

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

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

您可以按多个标签分组。如果您有多个分组选项，则时间序列会按每个标签值组合进行分组，按函数分组（信息中心编辑器）或聚合器（旧版信息中心编辑器）会应用于每个组。生成的图表显示每个标签组合的一个时间序列。为标签指定的顺序并不重要。

例如，以下屏幕截图展示了按 user_labels.version 和 system_labels.machine_image 分组：

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

如果您指定分组，或者选择按函数分组（信息中心编辑器）或聚合器（旧版信息中心编辑器），则绘成图表的时间序列仅包含必需的标签（例如项目标识符）以及按分组指定的标签。

移除分组条件

信息中心编辑器

要移除所有分组依据条件，请执行以下操作之一：

• 基本模式：取消选中分组。

• 高级模式：执行以下操作：

  1. 在分组依据菜单中，点击全部删除，然后点击确定。
  2. 在按函数分组菜单中，选择 none。
  注意：使用高级模式时，如果您只删除分组依据标签，图表显示一条线，表示在应用按函数分组后的所有数据。要取消分组，您必须移除分组依据标签并将按函数分组重置为 none。

• MQL 模式：删除分组命令。

  如需了解如何监控查询语言，请参阅使用查询编辑器。

旧版信息中心编辑器

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

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

注意：如果您仅删除分组依据标签，则图表仅显示一条数据线，表示应用聚合后的所有数据。要取消分组，您必须移除分组依据标签并将聚合重置为 none。

二次聚合

信息中心编辑器

• 基本和高级模式：信息中心编辑器会确定如何将聚合选项映射到 Cloud Monitoring API 通过以下信息指定的主要和次要聚合字段：

  • 微件类型
  • 指标种类
  • 指标值类型
  • 使用哪个模式配置微件

  如需为自定义信息中心的图表确定此映射，您可以使用 gcloud 命令行工具检索信息中心配置。如需了解详情，请参阅列出信息中心。

• MQL 模式：这些字段可访问。

旧版信息中心编辑器

如果您有多个已经代表聚合的时间序列（例如说明 Group By 选项的示例），则可以通过选择一个 Secondary Aggregator 跨这些时间序列进行聚合：

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

以下屏幕截图显示了对过滤的数据集进行分组所形成的几个时间序列。进行分组时需要执行聚合操作；同时，每组数据线都会聚合成一条数据线。以下屏幕截图显示了按地区分组的时间序列：

以下屏幕截图显示了使用二次聚合查找分组时间序列中的平均值的结果：

后续步骤

• 如需了解受监控的资源，请参阅受监控的资源。

• 如需查看预定义指标的列表，请参阅指标。

• 如需了解如何定义您自己的指标，请参阅使用自定义指标。

• 如需了解如何使用图例模板，请参阅配置图例模板。

• 如需详细了解视图选项（包括 Outlier 模式），请参阅设置视图选项。

• 如需详细了解与图表本身的交互，请参阅研究已绘制成图表的数据。