使用 Metrics Explorer 创建图表

本文档介绍如何使用 Metrics Explorer 构建临时图表来探索指标数据。例如,如需查看虚拟机的 (VM) CPU 利用率,您可以使用 Metrics Explorer 构建显示最新数据的图表。

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

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

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

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

绘制单个指标类型的图表

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

  1. 在 Google Cloud 控制台中,选择 Monitoring 或点击以下按钮:
    转到 Monitoring

  2. 在导航窗格中,选择 Metrics Explorer

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

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

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

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

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

        在您做出选择后,窗格的标题将会发生变化。例如,如果您按照之前的建议操作,窗格标题便会变为 Request latency(请求延迟)。

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

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

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

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

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

    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. 选择指标窗格的工具栏中,点击指标菜单中的 帮助,然后选择直接过滤模式

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

    2. 输入 Monitoring 过滤条件。

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

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

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

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

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

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

  5. 可选:更改图表显示所选数据的方式。您可以执行以下操作:

绘制多个指标类型的图表

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

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

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

  1. 在 Google Cloud 控制台中,选择 Monitoring 或点击以下按钮:
    转到 Monitoring
  2. 在导航窗格中,选择 Metrics Explorer
  3. 使用选择指标窗格中的选项选择要查看其数据的第一个指标类型。 如需了解这些步骤,请参阅绘制单个指标类型图表

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

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

    1. 选择添加查询

      新的 Select a metric 窗格会隐藏之前配置的查询。

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

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

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

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

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

绘制指标比率的图表

监控报告的错误数量可能很有用,但您需要监控错误率。也就是说,您想要了解根据测试总数得出的发生的错误数。为了满足此要求,您可以配置图表以显示两个指标的比率。如需查看示例参考,以及在绘制指标比率时可能会出现的异常情况,请参阅指标比率

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

  1. 在 Google Cloud 控制台中,选择 Monitoring 或点击以下按钮:
    转到 Monitoring
  2. 在导航窗格中,选择 Metrics Explorer
  3. 指定图表将要显示的数据:

    1. 配置分子:

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

      1. 选择添加查询

        新的 Select a metric 窗格会隐藏之前配置的查询。

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

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

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

      4. 更新分组字段。

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

        您无需为这两种指标类型使用相同的分组;不过,您只能按两种指标类型共用的标签进行分组。

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

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

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

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

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

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

      示例:指标的比率。

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

      1. 针对查询以 A/B 开头的查询,点击工具栏上的 展开
      2. 展开分子和分母菜单并做出选择。

    MQL

    1. 选择指标窗格的工具栏中,选择代码编辑器
    2. 在查询编辑器中输入查询。利用 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. 语言切换开关中选择 MQL。语言切换开关位于同一工具栏中,可让您设置查询的格式。
    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 创建和管理信息中心

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

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

保存图表配置

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

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

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

保存图表显示的数据

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

后续步骤