为信息中心上的图表选择指标

本文档介绍了如何在自定义信息中心上配置图表，以显示项目收集的时间序列数据。图表可以显示 仅数字时间序列数据。有关如何配置样式的信息 请参阅设置图表显示选项。

选择要显示的数据

如需配置要在图表上显示的时序，您可以 您可以通过从菜单中选择构建查询来构建查询，也可以编写查询。 编写查询时，您需要选择查询语言，然后使用查询编辑器或基于文本的界面：

• Monitoring Query Language (MQL) 查询指定时序和 这些时序的分组和对齐方式。 MQL 界面支持代码编辑器 提供建议和语法检查

  通常无法将 MQL 查询转换为其他接口可使用的形式。您未保存的查询 。

• Prometheus 查询语言 (PromQL) 查询用于指定时序以及这些时序的分组和对齐方式。PromQL 接口支持包含建议的编辑器。

  通常无法将 PromQL 查询转换为表单 可供其他接口使用您未保存的查询 。

• Monitoring 过滤器查询会指定时间序列，但不包含分组或对齐语句。

  您可以使用 Monitoring 过滤条件指定 Monitoring 可以绘制图表的任何时间序列。例如，要用图表表示 在虚拟机上运行的进程，您必须使用 指定函数的监控过滤条件。

  监控过滤条件并不总是可以转换为其他接口所需的形式。因此，如果您切换到其他界面，系统可能会舍弃您的查询。

查询通常会指定指标类型、资源类型和过滤条件：

• 指标类型用于标识要从资源收集的测量结果。指标类型包括对要测量的内容以及如何解释测量结果的说明。指标类型有时也称为指标。“CPU 利用率”就是一个指标示例。 如需了解概念性信息，请参阅指标类型。

• 资源类型用于指定指标数据的来源资源 已捕获。资源类型有时称为受监控资源类型或资源。示例 资源就是“Compute Engine 虚拟机 (VM) 实例”。 有关概念信息，请参阅 受监控的资源。

MQL 和 PromQL 查询都包含分组和对齐语句。但是，如果您编写一个 Monitoring 过滤器或使用 菜单来选择图表时序，然后配置分组并 调整对齐方式。

注意 ：Google Cloud 控制台仅显示数字数据。如需检索类型为 String 的指标，请使用 API 中的方法，例如 timeSeries.list。

使用菜单构建查询

使用菜单构建查询是默认配置。通常，如果您选择一个指标和一个过滤条件，然后切换到其他界面，系统会保留您的选择，并针对该界面重新设置格式。也就是说，通过菜单构建的查询可以转换为 MQL 查询。

您可以从其他界面返回到菜单驱动型界面，方法是 选择 Builder。不过，您的查询会被舍弃。 也就是说，MQL 查询无法转换为等效的 菜单驱动型表单

如需使用菜单构建查询，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 信息中心页面：

   前往信息中心

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

2. 执行下列其中一项操作：

   • 如需创建新的信息中心，请选择创建信息中心。
   • 如需更新现有信息中心，请在信息中心列表中找到该信息中心，然后选择其名称。

3. 在工具栏中，点击  添加微件。

4. 在添加微件对话框中，选择  Metric。

5. 在查询窗格的工具栏中，执行以下操作：

   1. 在指标元素中，展开选择指标菜单。

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

      • 要查找特定的指标类型，请使用 过滤栏。 例如，如果您输入 util，则将菜单限制为 显示包含 util 的条目。当条目通过不区分大小写的“包含”测试时，系统会显示相应条目。

      • 如需显示所有指标类型（包括没有数据的指标），请点击 有效。默认情况下，菜单中仅显示有数据的指标类型。

   2. 依次从资源菜单、指标类别菜单和指标菜单中进行选择，然后点击应用。

      例如，绘制 Compute Engine 的 CPU 利用率图表 您可以选择虚拟机实例、实例 CPU 利用率，然后点击应用。

      资源菜单列出了数据的收集来源。如果指标不是针对资源编写的 选择未指定。

   完成上一步后，图表会显示可用的 时序：

   

   上一个图表包含的数据过多，无法全部显示；图表 上限为 50 行可显示。 该图表会提示数据太多，无法全部显示。接收者 减少数据量，请使用 排序和limit 元素。如需了解详情，请参阅显示离群值。

   您还可以使用过滤和聚合选项来减少图表数据量。这些方法使图表对诊断和分析更有用，并且提高了界面本身的性能和响应速度。

6. 可选：添加过滤条件以限制显示的时序。下一个 部分介绍了过滤选项。

7. 可选：配置时序的分组和对齐方式。有关 信息，请参阅选择如何显示已绘制成图表的数据。

8. 要将更改应用到信息中心，请在工具栏中执行以下操作： 点击应用。如需舍弃更改，请点击取消。

过滤已绘制成图表的数据

过滤条件可确保仅将符合部分条件的时间序列绘制到图表中。应用过滤条件后，图表中的数据线数量可能会减少，从而改善图表的性能。提高图表响应速度的另一种方法是配置汇总选项，并对显示的时间序列进行排序和限制。如需了解详情，请参阅显示离群值。

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

• 等于，=
• 不等于、!=
• 正则表达式匹配，=~
• 正则表达式不匹配：!=~

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

如果您提供多个过滤条件，对应的图表就会显示 仅限符合所有条件（逻辑 AND）的时序。

如需在使用 Google Cloud 控制台的菜单驱动型界面时添加过滤条件，请执行以下操作：

1. 在过滤条件元素中，点击添加过滤条件，然后从菜单中进行选择。

2. 要更改比较方式，请从比较条件菜单中选择一个值。

3. 在值字段中，输入或选择一个值：

   • 对于直接比较（= 或 !=），请从 菜单或输入一个值，然后点击确定。您可以输入 us-central1-a 等值，也可以创建以 starts_with 或 ends_with 开头的过滤条件字符串。例如，如需显示任何 us-central1 可用区的数据，您可以输入过滤条件字符串 starts_with("us-central1")。请参阅 Monitoring 过滤条件 ，详细了解过滤条件字符串。

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

   • 对于正则表达式比较（=~ 或 !=~），请在值字段中输入 RE2 正则表达式，然后点击确定。例如，正则表达式 us-central1-.* 可与所有 us-central1 区域匹配：

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

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

     例如，如需仅查看来自某个 us-central1 可用区的时间序列，请应用 zone=~"us-central1.*" 过滤条件。

如果您添加多个过滤条件，请注意以下几点：

• 您可以多次使用同一标签 为一系列值指定过滤条件。

• 所有过滤条件都必须满足，它们构成逻辑 AND。

如需修改过滤条件的值或比较运算符，请在过滤条件元素上点击 Menu（菜单），进行更改，然后点击 Ok（确定）。

如需删除过滤条件，请点击 取消。

编写 MQL 查询

如需输入 MQL 或 PromQL 查询，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 信息中心页面：

   前往信息中心

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

2. 执行下列其中一项操作：

   • 如需创建新的信息中心，请选择创建信息中心。
   • 如需更新现有信息中心，请在所有信息中心的列表中找到该信息中心，然后选择其名称。

3. 在工具栏中，点击  添加微件。

4. 在添加微件对话框中，选择  Metric。

5. 在查询构建器窗格的工具栏中，选择名为  MQL 或  PromQL 的按钮。

6. 验证已在MQL切换开关中选择 MQL。语言切换开关位于同一工具栏中，用于设置查询的格式。

7. 可选：停用自动运行切换开关。

8. 在查询编辑器中输入查询。例如，如需绘制 Google Cloud 项目中虚拟机实例的 CPU 利用率图表，请使用以下查询：

   fetch gce_instance
   | metric 'compute.googleapis.com/instance/cpu/utilization'
   | group_by 1m, [value_utilization_mean: mean(value.utilization)]
   | every 1m
   

   如需详细了解 MQL，请参阅以下文档：

   • MQL 简介
   • 使用 MQL 的代码编辑器

9. 点击运行查询。

   启用自动运行切换开关后， 未显示运行查询按钮。

编写 PromQL 查询

如需输入 MQL 或 PromQL 查询，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 信息中心页面：

   前往信息中心

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

2. 执行下列其中一项操作：

   • 如需创建新的信息中心，请选择创建信息中心。
   • 如需更新现有信息中心，请在所有信息中心的列表中找到该信息中心，然后选择其名称。

3. 在工具栏中，点击  添加微件。

4. 在添加微件对话框中，选择  Metric。

5. 在查询构建器窗格的工具栏中，选择名为  MQL 或  PromQL 的按钮。

6. 验证已在语言 (Language) 切换开关中选择 PromQL。语言切换开关位于同一工具栏中，用于设置查询的格式。

7. 可选：停用自动运行切换开关。

8. 在查询编辑器中输入查询。例如，要将平均值 Google Cloud 项目中虚拟机实例的 CPU 利用率，请使用 以下查询：

   avg(compute_googleapis_com:instance_cpu_utilization)
   

   如需详细了解如何使用 PromQL，请参阅 Cloud Monitoring 中的 PromQL。

9. 点击运行查询。

   启用自动运行切换开关后，系统不会显示运行查询按钮。

编写 Monitoring 过滤条件查询

当您想执行以下任一操作时，都必须使用“直接过滤模式”， 让您可以输入一个 监控过滤条件：

• 显示服务等级目标 (SLO)。
• 显示虚拟机上运行的进程数。
• 显示您尚未掌握数据的自定义指标。
• 根据尚无数据的标签过滤时间序列。

Monitoring 过滤条件，或等效的 指标过滤条件是监控 用于标识要绘制成图表的时序。 例如，以下表达式结果 （显示名称包含 nginx 的进程数量的图表）：

select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
resource.type="gce_instance"

您还可以使用 Monitoring 过滤条件来识别时序 按资源和指标类型分类以下表达式将生成 显示所有 Google Cloud 虚拟私有云的日志条目计数的图表 us-east1-b 可用区中的虚拟机实例：

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

要输入 Monitoring 过滤条件，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 信息中心页面：

   前往信息中心

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

2. 执行下列其中一项操作：

   • 如需创建新的信息中心，请选择创建信息中心。
   • 如需更新现有信息中心，请在信息中心列表中找到该信息中心，然后选择其名称。

3. 在工具栏中，点击  添加微件。

4. 在 Add widget 对话框中，选择  Metric。

5. 点击指标元素上的 Help，然后选择 Direct Filter Mode。

   系统会删除 Metric 和 Filter 元素，并创建一个 Filters 元素，以便您输入文本。

   如果您在切换到直接过滤模式之前选择了资源类型、指标或过滤条件，则这些设置会显示在过滤条件元素中。

6. 在过滤条件元素的文本区域中，输入 Monitoring 过滤条件表达式。 如需了解语法，请参阅以下文档：

   • 监控过滤器
   • 进程运行状况过滤器
   • 检索 SLO 数据

   如果您使用直接过滤模式，但没有符合过滤条件的可用数据，系统会显示错误消息。常见的错误消息包括 Chart definition invalid 和 No data is available for the selected timeframe.

7. 可选：配置时间序列的分组和对齐方式。有关 信息，请参阅选择如何显示已绘制成图表的数据。

要返回菜单驱动的界面 点击 退出直接过滤模式。

注意 ：如果您输入 Monitoring 过滤条件，然后切换到 另一个界面，系统会舍弃 Monitoring 过滤条件。

选择如何显示已绘制成图表的数据

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

本部分介绍了如何设置汇总字段。聚合包括校准时间序列中的数据点，以及将不同的时间序列组合在一起。如需详细了解聚合，请参阅过滤和聚合：处理时间序列。

• 如需了解视图选项，请参阅设置图表显示选项。
• 如需详细了解如何与图表交互，请参阅 探索已绘制成图表的数据。

如果您使用 MQL 或 PromQL 选择了要绘制图表的数据，则本部分的内容不适用。

合并时间序列

您可以通过组合不同的时间序列来减少为指标返回的数据量。如需组合多个时序，您通常需要 指定一个或多个标签和一个函数。包含 所有指定标签的相同值进行分组，然后将函数 会将这些时序合并为新的时序。

Aggregation 元素中的设置可以更改图表显示的时间序列数量。此元素的默认设置 取决于您选择的指标类型 如需修改显示内容，请执行以下任一操作：

• 如需显示每个时序，请确保在汇总元素中，将第一个菜单设置为不汇总，并将第二个菜单设置为无。

• 如需合并时序，请在汇总元素中执行以下操作： 执行以下操作：

  1. 展开第一个菜单，然后选择一个函数。

     系统会刷新图表并显示单个时序。例如，如果您选择平均值，则显示的时间序列是所有时间序列的平均值。

  2. 如需合并具有相同标签值的时间序列，请展开第二个菜单，然后选择一个或多个标签。

     图表会刷新，并显示每个标签值的每个唯一组合的一个时间序列。例如，要在时序上显示 则将第二个菜单设置为 zone。

• 要配置数据点之间的间距，请点击 添加查询元素，选择最小间隔， 然后输入一个值

例如，如果您将函数设置为“求和”，并选择标签 user_labels.version，则每个值都有一个时间序列标签 user_labels.version。每个时序中的数据点是通过所有值的总和计算得出的 针对特定版本的各个时序：

选择多个标签时，具有相同 所选标签的值会合并。 生成的图表显示每个标签组合的一个时间序列。为标签指定的顺序并不重要。下面的屏幕截图显示了一个图表，其中，时序已按 user_labels.version 和 system_labels.machine_image 标签：

如图所示，图表会针对每对标签值显示一个时间序列。对于每个标签组合，您都会获得一个时序，这意味着 这种方法产生的数据可能比你简单地放到 单个图表

显示所有时序

如需显示所有时序，请在 Aggregation 元素中添加 将第一个菜单设置为未汇总，将第二个菜单设置为无。

校准数据

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

设置校准间隔

要为数据点指定固定的时间长度，请执行以下操作： 点击查询窗格中的 添加查询元素， 选择 Min Interval，然后完成对话框。

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

以下屏幕截图说明了特定 Google Cloud 项目中 Compute Engine 虚拟机实例的 CPU 利用率。在此图片中，Min Interval 字段设置为 1 minute：

为了便于比较，下面的屏幕截图展示了将 从 1 minute 到 5 minutes 的时间间隔：

通过增加此时间段，生成的图表的点数会减少，每个时间序列的 60 点数将减少到每个时间序列 10 个点。通过将 最小间隔字段中，可合并更多的点，具有平滑处理功能 对绘制的数据的影响。

设置对齐函数

当您选择用于聚合的函数时，Cloud Monitoring 会 对齐函数。Cloud Monitoring 会根据您选择的指标类型和聚合函数来确定最佳对齐函数。不过，您可以指定校准函数并覆盖 Cloud Monitoring 做出的选择。

如需指定对齐函数，请执行以下操作：

1. 在汇总元素中，展开第一个菜单，然后选择配置对齐器。对齐函数和 添加了 Grouping 元素。
2. 展开对齐函数元素，然后进行选择。

虽然大多数支持的对齐函数 有些函数会执行更复杂的操作：

• next 较旧：只保留某个比对范围内的最新样本 请选择下一个。此函数通常用于 如果您只关心最新 值。

  此函数仅适用于采样平均值指标。

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

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

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

  此函数仅适用于累积指标和增量指标。

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

  此函数仅适用于累积指标和增量指标。

如需详细了解可用的对齐函数， 请参阅Aligner 。

二次聚合

如果您有多个已经表示聚合的时间序列，则可以通过选择二次聚合器将图表上的所有时间序列减少为单个时间序列。例如，如果按可用区对数据进行分组，则图表会针对每个可用区显示一个时间序列。如需创建包含单个时间序列的图表，请使用二次聚合字段。

对于某些指标类型，您可以选择转换数据。如果 选项可用，如果您将 Transform 字段设置为其他值， 而不是 None，所有其他字段都是二次聚合设置。

当次级汇总字段可配置时，如需访问这些字段，请执行以下操作：

1. 点击 Add query element（添加查询元素），然后选择 Secondary aggregation（次级汇总）。
2. 配置二次聚合元素。

后续步骤

• 研究已绘制成图表的数据
• 用户定义的指标概览
• 配置图例列的名称
• 设置图表显示选项