使用 Metrics Explorer 创建图表

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

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

以下屏幕截图显示了 Metrics Explorer 页面上绘制的单个指标类型(虚拟机实例的 CPU 利用率):

使用 Metrics Explorer 绘制的指标图表。

上图显示了多条线,每条线显示特定区域中所有虚拟机的平均 CPU 利用率。

绘制单个指标类型的图表

如需将图表配置为显示单个指标,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Metrics Explorer 页面:

    进入 Metrics Explorer

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

  2. 指定要在图表上显示的数据。您可以使用 监控查询语言 (MQL)、PromQL,或者您可以输入 监控过滤条件:

    1. 选择要查看的时间序列数据:

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

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

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

        • 要显示所有指标类型(包括没有数据的指标类型),请点击 有效。默认情况下,菜单 仅显示带有数据的指标类型

        例如,您可以做出以下选择:

        1. 活跃资源菜单中,选择虚拟机实例
        2. 活跃指标类别菜单中,选择 uptime_check
        3. 活跃指标菜单中,选择请求延迟时间
        4. 点击应用
      2. 可选:如需指定要显示的数据子集,请在过滤条件元素中,选择添加过滤条件,然后完成对话框。例如,您可以按 应用过滤器。您可以添加多个过滤条件。如需了解详情,请参阅过滤已绘制成图表的数据

      如需了解详情,请参阅 选择要绘制成图表的数据

    2. 合并和校准时序:

      • 如需显示每个时序,请在 Aggregation 元素中添加 将第一个菜单设置为未汇总,将第二个菜单设置为

      • 如需组合时间序列,请在聚合元素中执行以下操作:

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

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

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

          系统会刷新该图表,并为每个唯一身份用户显示一个时序 标签值的组合。例如,如需按可用区显示时序,请将第二个菜单设置为可用区

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

      • 可选:如需配置数据点之间的间距,请点击 Add query element(添加查询元素),选择 Min Interval(最小间隔),然后输入值。

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

    3. 可选:仅显示最高或最低的时序 值,请使用排序和限制元素。

    MQL

    1. 在查询构建器窗格的工具栏中,选择名为  MQL PromQL 的按钮。
    2. 验证已在MQL切换开关中选择 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,请参阅以下文档:

    PromQL

    1. 在查询构建器窗格的工具栏中,选择名为  MQL PromQL 的按钮。
    2. 验证已在语言 (Language) 切换开关中选择 PromQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
    3. 在查询编辑器中输入查询。例如,要将平均值 Google Cloud 项目中虚拟机实例的 CPU 利用率,请使用 以下查询:

      avg(compute_googleapis_com:instance_cpu_utilization)
      

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

    监控过滤条件

    1. Metric 元素中,点击 Help,然后 选择直接过滤模式

      系统会删除 MetricFilter 元素,并创建一个可让您输入文本的 Filters 元素。

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

    2. Filters 元素。
    3. 合并和校准时序:

      • 如需显示每个时序,请在 Aggregation 元素中添加 将第一个菜单设置为未汇总,将第二个菜单设置为

      • 如需组合时间序列,请在聚合元素中执行以下操作:

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

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

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

          系统会刷新该图表,并为每个唯一身份用户显示一个时序 标签值的组合。例如,如需按可用区显示时序,请将第二个菜单设置为可用区

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

      • 可选:如需配置数据点之间的间距,请点击 Add query element(添加查询元素),选择 Min Interval(最小间隔),然后输入值。

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

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

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

      • 在工具栏中,将时间控制设置为至少一周。配额指标通常每天报告一个样本。
      • 显示窗格中,展开微件类型 菜单,然后选择堆叠条形图
    • 对于值类型为 Distribution 的指标类型,请确保微件类型菜单设置为热图。如需了解详情,请参阅分布值指标简介

    • 对于其他指标类型,请使用微件类型菜单来显示 数据。微件类型菜单列出了所有可用的微件类型;不过,某些微件可能未启用。假设某个图表显示了多个时序,并假设 每个测量值都是一个双精度值:

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

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

绘制多个指标类型的图表

在某些情况下,您可能希望显示 指标类型。例如,将读取和写入 在虚拟机上加载,配置一个图表以显示字节数 读取的字节数和写入的字节数。

要为多个指标绘制图表,您必须使用菜单驱动型界面。其他接口不支持绘制多个指标的图表。

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

  1. 在 Google Cloud 控制台中,转到 Metrics Explorer 页面:

    进入 Metrics Explorer

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

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

    1. 指标元素中,然后选择要查看其数据的第一种指标类型。有关这些步骤的信息,请参阅 绘制单个指标类型的图表

      针对此选项的查询具有 A 标识符。

    2. 对于每个附加的指标类型,请执行以下操作:

      1. 选择添加查询。系统会添加新查询。例如,包含 可以添加标签 B

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

      以下屏幕截图展示了 Metrics Explorer 的显示情况 有两种指标类型时:

      包含两种指标类型的 Metrics Explorer 示例。

    3. 可选:在显示窗格中,展开 Y 轴菜单,然后配置要为每种指标类型使用的 Y 轴。

    MQL

    不受支持。

    PromQL

    不受支持。

    监控过滤器

    不受支持。

绘制指标比率的图表

监控报告的错误数量可能很有用;不过,您更有可能需要监控错误率。也就是说,您希望知道相对于响应总数,发生了多少错误。为满足此要求,您可以将图表配置为显示两个指标的比率。参考示例 绘制指标比率图表时 可能会出现的异常值 请参阅指标比率

如需在图表中显示指标的比率,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Metrics Explorer 页面:

    进入 Metrics Explorer

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

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

    1. 配置分子:

      1. 指标元素中,使用菜单选择 资源类型和指标类型。如需了解这些步骤,请参阅绘制单个指标类型的图表
      2. 更新聚合字段。默认情况下,计算所有时序的平均值。
      3. 可选:更新要合并的时间序列中数据点的固定时长。要修改此字段,请按以下步骤操作: 点击 添加查询元素, 选择 Min Interval,然后完成对话框。
    2. 选择添加查询,然后配置分母:

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

        选择指标类型,其指标种类与分子相同。 例如,如果分子指标是 GAUGE 指标,则为分母选择 GAUGE 指标。

      2. 更新汇总字段。

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

        您无需为这两种指标类型使用同一组标签;不过,您只能选择这两种指标类型共有的标签。

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

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

      创建比率后,系统会显示三个查询:

      • A/B Ratio 标识了比率查询。
      • A 标识分子的查询。
      • B 标识对分母的查询。

      以下示例展示了将 每个可用区写入磁盘的字节数(以字节总数表示) 写入磁盘:

      指标比率的示例。

    4. 可选:如需切换分子和分母指标,请执行以下操作: 在 Ratio 元素中,展开菜单,然后进行选择。

    MQL

    1. 在查询构建器窗格的工具栏中,选择名为  MQL PromQL 的按钮。
    2. 验证已在MQL切换开关中选择 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,请参阅以下文档:

    PromQL

    1. 在查询构建器窗格的工具栏中,选择名为  MQL PromQL 的按钮。
    2. 验证已在语言 (Language) 切换开关中选择 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 编辑器

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

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

    如需获取图表的网址,请点击图表工具栏中的 Link(链接)。

保存图表配置

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

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

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

保存图表显示的数据

要将图表显示的数据保存到您的本地系统,请点击 下载 CSV 文件

后续步骤