使用 Metrics Explorer 创建图表

本文档介绍了如何通过使用 Metrics Explorer 构建临时图表来探索指标数据。例如，如需查看虚拟机 (VM) 的 CPU 利用率，您可以使用 Metrics Explorer 来构建显示最新数据的图表。如果您需要永久性图表，可以使用 Metrics Explorer 创建图表并将其保存到自定义信息中心。另一种方法是创建自定义信息中心，以显示图表、日志、突发事件和其他内容，然后使用信息中心界面将图表添加到该信息中心。如需了解自定义信息中心，请参阅创建和管理自定义信息中心。

您可以创建图表（例如为单一指标类型绘制图表）和复杂图表（例如为多种指标类型绘制图表）。使用 Metrics Explorer 创建图表后，您可以舍弃该图表、将其保存到自定义信息中心、保存其配置或共享该图表。

以下屏幕截图显示了 Metrics Explorer 页面上图表中显示的一种指标类型，即虚拟机实例的 CPU 利用率：

前面的屏幕截图显示了多行内容，每行都显示特定可用区中所有虚拟机的平均 CPU 利用率。

注意 ：如果您正在查看信息中心上的图表，并希望查看图表配置或将图表复制到其他信息中心，请查看图表选项是否允许您查看图表 Metrics Explorer。选择此选项后，Metrics Explorer 会打开并显示您正在查看的数据。然后，您可以查看或修改配置，或将图表保存到自定义信息中心。

绘制单个指标类型图表

若要将图表配置为显示单个指标，请执行以下操作：

1. 在 Google Cloud 控制台的导航面板中，选择 Monitoring，然后选择  Metrics Explorer：

   进入 Metrics Explorer

2. 指定要在图表上显示的数据。您可以使用菜单驱动型界面、Monitoring Query Language (MQL)、PromQL，或输入 Monitoring 过滤条件：

   菜单驱动的界面

   1. 选择要查看的时序数据：

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

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

         • 如需查找特定的指标类型，请使用 过滤栏。例如，如果您输入 util，则会限制菜单显示包含 util 的条目。条目在通过不区分大小写的“包含”测试后即会显示。

         • 如需显示所有指标类型，包括没有数据的指标类型，请点击 活跃。默认情况下，这些菜单仅显示包含数据的指标类型。

         例如，您可能会做出以下选择：

         1. 在活跃资源菜单中，选择虚拟机实例。
         2. 在活跃指标类别菜单中，选择 uptime_check。
         3. 在活跃指标菜单中，选择请求延迟时间。
         4. 点击应用。

      2. 可选：如需指定要显示的数据子集，请在 Filter 元素中选择添加过滤条件，然后完成对话框。例如，您可以通过应用过滤条件来查看某个区域的数据。您可以添加多个过滤条件。如需了解详情，请参阅过滤已绘制成图表的数据。

      如需了解详情，请参阅选择要用于绘制图表的数据。

   2. 组合和对齐时序：

      • 如需显示每个时序，请在 Aggregation 元素中将第一个菜单设置为 Unaggregated，将第二个菜单设置为 None。

      • 如需组合时序，请在 Aggregation 元素中执行以下操作：

        1. 展开第一个菜单并选择一个函数。

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

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

           系统会刷新图表，并针对标签值的每个唯一组合显示一个时序。例如，如需按时区显示时序，请将第二个菜单设置为 zone。

           当第二个菜单设置为 None 时，图表会显示一个时序。

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

      如需详细了解分组和校准，请参阅选择如何显示已绘制成图表的数据。

   3. 可选：如需仅显示具有最高或最低值的时序，请使用排序和限制元素。

   MQL

   1. 在查询构建器窗格的工具栏中，选择名为  MQL 或  PromQL 的按钮。
   2. 验证已在语言切换开关中选择 MQL。语言切换开关位于同一工具栏中，用于设置查询的格式。

   3. 在查询编辑器中输入查询。例如，如需绘制 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 的代码编辑器

   PromQL

   1. 在查询构建器窗格的工具栏中，选择名为  MQL 或  PromQL 的按钮。
   2. 验证已在语言切换开关中选择 PromQL。语言切换开关位于同一工具栏中，用于设置查询的格式。

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

      avg(compute_googleapis_com:instance_cpu_utilization)
      

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

   监控过滤条件

   1. 在 Metric 元素中，点击 Help，然后选择 Direct Filter Mode。

      删除了 Metric 和 Filter 元素，并创建用于输入文字的 Filters 元素。

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

   2. 在 Filters 元素的字段中输入 Monitoring 过滤条件。

   3. 组合和对齐时序：

      • 如需显示每个时序，请在 Aggregation 元素中将第一个菜单设置为 Unaggregated，将第二个菜单设置为 None。

      • 如需组合时序，请在 Aggregation 元素中执行以下操作：

        1. 展开第一个菜单并选择一个函数。

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

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

           系统会刷新图表，并针对标签值的每个唯一组合显示一个时序。例如，如需按时区显示时序，请将第二个菜单设置为 zone。

           当第二个菜单设置为 None 时，图表会显示一个时序。

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

      如需详细了解分组和校准，请参阅选择如何显示已绘制成图表的数据。

3. 根据您选择的指标类型更新图表设置：

   • 对于配额指标类型，请使用以下设置：

     • 在工具栏中，将时间控件设置为至少一周。配额指标通常每天报告一个样本。
     • 在显示窗格中，展开微件类型菜单，然后选择堆叠条形图。

   • 对于具有 Distribution 值类型的指标类型，请确保将微件类型菜单设置为热图图表。如需了解详情，请参阅分布值指标简介。

   • 对于其他指标类型，请使用微件类型菜单来显示数据的显示方式。Widget type 菜单列出了所有可用的 widget 类型；但是，某些 widget 可能未启用。假设有一个显示多个时序的图表，并假设每个测量值都是双精度值：

     • 折线图、堆叠条形图和堆叠面积图 widget 被列为兼容。您可以选择以下任意类型。
     • 热图 widget 已停用，因为这些 widget 只能显示分布值数据。

4. 可选：如需更改图表显示所选数据的方式，请使用 Display 窗格中的选项：

   • 如需将图表配置为以 X 射线模式显示或显示统计信息，请点击 分析模式。
   • 如需比较当前数据与过往数据，请点击 与过往数据比较。
   • 如需添加参考阈值，请点击 阈值线。
   • 如需配置图例列的名称，请点击 图例别名。
   • 如需配置 Y 轴分配、标签或刻度，请使用 Y 轴分配、Y 轴标签和 Y 轴刻度菜单。

绘制多种指标类型图表

在某些情况下，您可能希望在同一图表上显示不同指标类型的时序。例如，如需比较虚拟机上的读写负载，可以将图表配置为显示读取的字节数和写入的字节数。

如需绘制多个指标的图表，您必须使用菜单驱动的界面。其他界面不支持绘制多个指标的图表。

如需在图表上显示多个指标，请执行以下操作：

1. 在 Google Cloud 控制台的导航面板中，选择 Monitoring，然后选择  Metrics Explorer：

   进入 Metrics Explorer

2. 指定要在图表上显示的数据。

   菜单驱动的界面

   1. 在指标元素中，然后选择要查看其数据的第一个指标类型。如需了解这些步骤，请参阅绘制单个指标类型图表。

      针对此所选内容的查询具有 A 标识符。

   2. 对于其他每个指标类型，请执行以下操作：

      1. 选择添加查询。系统会添加一个新查询。例如，可能会添加带有标签 B 的查询。B

      2. 对于新查询，请在指标元素中选择资源类型和指标类型。您还可以添加过滤条件、合并时序，并对显示的时序数进行排序和限制。

      以下屏幕截图展示了 Metrics Explorer 中有两个指标类型绘制成图表的情况：

      

   3. 可选：在显示窗格中，展开 Y 轴菜单，然后配置用于每种指标类型的 Y 轴。

   MQL

   不受支持。

   PromQL

   不受支持。

   监控过滤条件

   不受支持。

绘制指标比率图表

监控报告的错误数可能很有用，但您需要监控错误率的可能性更大。也就是说，您想知道根据响应总数衡量出现了多少次错误。为了满足此要求，您可以将图表配置为显示两个指标的比率。如需查看示例，以及使用绘制指标比率图表时可能出现的异常情况，请参阅指标比率。

如需在图表上显示指标比率，请执行以下操作：

1. 在 Google Cloud 控制台的导航面板中，选择 Monitoring，然后选择  Metrics Explorer：

   进入 Metrics Explorer

2. 指定图表将要显示的数据：

   菜单驱动的界面

   1. 配置分子：

      1. 在 Metric 元素中，使用菜单选择资源类型和指标类型。如需了解这些步骤，请参阅绘制单个指标类型图表。
      2. 更新聚合字段。默认情况下，计算所有时序的平均值。
      3. 可选：更新要组合的时序中点的固定时长。如需修改此字段，请点击 添加查询元素，选择最小间隔，然后完成对话框。

   2. 选择添加查询，然后配置分母：

      1. 对于新查询，请在指标元素中选择资源类型和指标类型。

         选择一个指标种类与分子相同的指标类型。例如，如果分子指标是 GAUGE 指标，请选择一个 GAUGE 指标作为分母。

      2. 更新聚合字段。

         我们建议分母指标类型的标签与为分子指标类型设置的值一致。例如，您可以为分子和分母选择 zone 标签。

         您无需为这两种指标类型使用相同的标签集；但是，您只能选择这两种指标类型共有的标签。

      3. 点击 添加查询元素，选择最小间隔，并确保将此字段设置为分子使用的值。

   3. 在查询窗格的工具栏中，选择创建比率，然后完成对话框。

      创建比率后，系统会显示三个查询：

      • A/B 比率用于标识比率查询。
      • A 标识针对分子的查询。
      • B 标识针对分母的查询。

      以下示例说明了一个比率，该比率用于比较每个可用区写入磁盘的字节数总和与写入磁盘的字节总数：

      

   4. 可选：如需切换分子和分母指标，请在比率元素中展开菜单，然后进行选择。

   MQL

   1. 在查询构建器窗格的工具栏中，选择名为  MQL 或  PromQL 的按钮。
   2. 验证已在语言切换开关中选择 MQL。语言切换开关位于同一工具栏中，用于设置查询的格式。

   3. 在查询编辑器中输入查询。MQL 允许您计算两个不同指标的比率，它允许您按标签过滤单个指标，然后计算比率。以下查询计算值为 500 的响应与响应总数的比率：

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
      | {
          filter response_code_class = 500
        ;
          ident
        }
      | group_by [matched_url_path_rule]
      | outer_join 0
      | div
      

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

      • MQL 简介
      • 使用代码编辑器
      • 计算比率

   PromQL

   1. 在查询构建器窗格的工具栏中，选择名为  MQL 或  PromQL 的按钮。
   2. 验证已在语言切换开关中选择 PromQL。语言切换开关位于同一工具栏中，用于设置查询的格式。

   3. 在查询编辑器中输入查询。例如，如需绘制 my_summary_latency_seconds 指标的平均延迟时间比率图表，请使用以下查询：

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
      sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
      

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

   监控过滤条件

   不受支持。

保存图表以供日后参考

借助 Metrics Explorer，您可以创建可用于探索指标的图表。但是，此工具创建的图表不是永久性的。当您离开 Metrics Explorer 页面时，图表将被舍弃。

如需保存使用 Metrics Explorer 配置的图表以供日后参考，请将图表添加到自定义信息中心或保存图表的网址：

• 如需将图表添加到自定义信息中心，请执行以下操作之一：

  • 如果您使用 Google Cloud 控制台管理自定义信息中心，请在 Metrics Explorer 工具栏中选择保存图表，然后完成对话框。您可以将图表保存到现有的自定义信息中心，也可以创建信息中心。

  • 如果您使用 Cloud Monitoring API 来管理自定义信息中心，请更新定义信息中心及其内容的 JSON 文件。如需访问 JSON 表示法，请点击图表工具栏中的  JSON Editor。

    如需详细了解如何使用 API 管理自定义信息中心，请参阅通过 API 创建和管理信息中心。

• 如需保留对图表配置的引用，请保存图表网址。由于图表网址会对图表配置进行编码，因此当您将该网址粘贴到浏览器中时，系统会显示您配置的图表。

  如需获取图表的网址，请点击图表工具栏中的 链接。

保存图表的配置

使用 Cloud Monitoring API 管理自定义信息中心时，您可以使用 Metrics Explorer 来帮助您构建向 API 提供的数据：

• 如需为计划添加到信息中心的图表生成 JSON 表示法，请使用 Metrics Explorer 配置图表。然后，您可以使用 Metrics Explorer 中的选项来查看和复制图表的 JSON 表示法。

• 如需确定用于 Cloud Monitoring API 的 Monitoring 过滤器的语法，请使用 Metrics Explorer 的菜单驱动界面来配置图表。选择指标和过滤条件后，切换到直接过滤模式以查看等效的 Monitoring 过滤条件。

保存图表中显示的数据

如需将图表显示的数据保存到本地系统，请点击 下载 CSV 文件。

后续步骤

• 研究已绘制成图表的数据
• 使用 Metrics Explorer 选择指标
• 查看指标使用情况和诊断信息
• 设置图表显示选项