使用 Metrics Explorer 创建图表

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

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

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

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

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

绘制单个指标类型的图表

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

  1. 在 Google Cloud 控制台中,选择 Monitoring,然后选择  Metrics Explorer,或点击以下按钮:

    转到 Metrics Explorer

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

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

      1. 选择指标窗格中,展开指标菜单,然后使用这些菜单选择资源类型和指标类型。例如,您可能会做出以下选择:

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

        如需限制菜单中的选项数量,请在过滤栏中输入指标或资源名称。例如,如需绘制虚拟机实例的请求延迟时间图表,您可以输入“latency”。

        您做出选择后,窗格标题会发生变化。例如,如果您提出了上述建议,则窗格标题将变为 RequestLatency

      2. 可选:如需指定要显示的数据子集,请选择添加过滤条件并完成对话框。例如,您可以通过应用过滤器来查看一个可用区的数据。您可以添加多个过滤条件。如需了解详情,请参阅过滤已绘制成图表的数据

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

    2. 对时序进行分组和对齐:

      • 如需显示每个时序,请在分组依据条目上,点击 删除分组
      • 如需组合具有相同标签值的时序,请展开标签菜单,然后选择标签值。您还可以更改分组函数的值。例如,图表可以显示时序的平均值,其中平均值按地区计算。
      • 可选:如需配置数据点之间的间距,请点击 更多选项,然后使用数据点对齐字段。

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

    3. 可选:如需仅显示具有最高或最低值的时序,请点击 添加排序和限制,然后填写表单。

    MQL

    1. 选择指标窗格的工具栏中,选择名称以代码开头的按钮。
    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,请参阅以下文档:

    PromQL

    1. 选择指标窗格的工具栏中,选择名称以代码开头的按钮。
    2. 语言切换菜单中选择 PromQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
    3. 在查询编辑器中输入查询。例如,如需绘制 Google Cloud 项目中虚拟机实例的平均 CPU 利用率图表,请使用以下查询:

      avg(compute_googleapis_com:instance_cpu_utilization)
      

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

    监控过滤条件

    1. Select a metric 窗格的工具栏中,点击 Metric 菜单中的 Help,然后选择 Direct Filter Mode

      系统随即会显示一个标有输入 Monitoring 过滤条件的文本框。如果您在切换到直接过滤器模式模式之前选择了资源类型、指标或过滤条件,这些设置将显示在文本框中。

    2. 输入 Monitoring 过滤条件。

    3. 对时序进行分组和对齐:

      • 如需显示每个时序,请在分组依据条目上,点击 删除分组
      • 如需组合具有相同标签值的时序,请展开标签菜单,然后选择标签值。您还可以更改分组函数的值。例如,图表可以显示时序的平均值,其中平均值按地区计算。
      • 可选:如需配置数据点之间的间距,请点击 更多选项,然后使用数据点对齐字段。

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

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

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

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

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

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

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

绘制多种指标类型的图表

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

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

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

  1. 在 Google Cloud 控制台中,选择 Monitoring,然后选择  Metrics Explorer,或点击以下按钮:

    转到 Metrics Explorer

  2. 使用选择指标窗格中的选项,选择要查看其数据的第一个指标类型。如需了解这些步骤,请参阅绘制单个指标类型图表

    选择指标窗格的标题会更改为您选择的指标。

  3. 对于其他每种指标类型,请执行以下操作:

    1. 选择添加查询

      新的选择指标窗格会隐藏之前配置的查询。

    2. 选择指标窗格中,使用菜单选择资源类型和指标类型。您还可以使用菜单添加过滤条件、对时序进行分组并设置对齐字段。

    如需查看已配置的所有指标类型,请前往您正在查看的窗格的工具栏,然后选择 收起

    以下屏幕截图展示了绘制了两种指标类型时的 Metrics Explorer 显示内容:

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

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

绘制指标比率图表

监控报告的错误数可能很有用;不过,您更可能需要监控错误率。也就是说,您想要了解根据响应总数来衡量发生了多少次错误。为了满足此要求,您可以将图表配置为显示两个指标的比率。如需查看示例参考以及使用绘制指标比率图表时可能发生的异常,请参阅指标比率

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

  1. 在 Google Cloud 控制台中,选择 Monitoring,然后选择  Metrics Explorer,或点击以下按钮:

    转到 Metrics Explorer

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

    1. 配置分子:

      1. 选择指标窗格中,使用菜单选择资源类型和指标类型。如需了解这些步骤,请参阅绘制单个指标类型图表
      2. 更新分组字段和对齐方式参数。默认情况下,Metrics Explorer 会添加一个分组,用于计算所有时序的平均值。
      3. 可选:更新对齐方式参数。如需查看对齐参数,请点击 更多选项
    2. 配置分母:

      1. 选择添加查询

        新的选择指标窗格会隐藏之前配置的查询。

      2. 选择指标窗格中,使用菜单选择资源类型和指标类型。

        分子和分母指标类型必须具有相同的指标种类。例如,如果分子指标是 GAUGE 指标,则您为分母选择的指标必须是 GAUGE 指标。

      3. 确保两个指标的最短校准时间段字段的值相同。如需查看对齐参数,请点击 更多选项

      4. 更新分组字段。

        我们建议分母指标类型的分组字段与为分子指标类型设置的值一致。例如,您可以按 zone 标签对这两种指标类型进行分组。

        您无需对这两种指标类型使用相同的分组方式;但是,您只能按这两种指标类型共有的标签进行分组。

      5. 如需查看已配置的所有指标类型,请前往您正在查看的窗格的工具栏,然后选择 收起

        系统会显示您的分子和分母查询。

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

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

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

      以下示例说明了一个比率,该比率会将每个可用区写入磁盘的字节数总和与写入磁盘的总字节数进行比较:

      指标比率示例。

    4. 可选:如需切换分子和分母指标,请执行以下操作:

      1. 针对名称以 A/B 开头的查询,点击工具栏上的 展开
      2. 展开分子和分母菜单,然后进行选择。

    MQL

    1. 选择指标窗格的工具栏中,选择名称以代码开头的按钮。
    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,请参阅以下文档:

    PromQL

    1. 选择指标窗格的工具栏中,选择名称以代码开头的按钮。
    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

后续步骤