将图表和表格添加到自定义信息中心

本文档介绍如何使用 Google Cloud 控制台将图表、表格、刻度盘和统计信息摘要添加到自定义信息中心。您可以通过添加折线图、堆叠面积图、条形图或热图图来显示某个时间间隔内的指标数据。如果您只对最近的测量结果感兴趣，可以添加表格、饼图、刻度盘图或统计信息摘要。量表和统计信息摘要会根据最新值与警告和危险阈值的比较结果而改变颜色。

您可以添加到信息中心的可视化图表统称为“微件”。如需了解不同 widget 类型的一般信息，请参阅信息中心概览。

自定义信息中心内的图表、表、计量表和统计信息摘要图表可以显示具有数字值或分布值的任何指标类型，包括用户定义的指标和基于日志的指标。图表无法绘制字符串类型的数据图表。

本文档介绍了如何向显示时间序列数据的自定义信息中心添加图表、表格、刻度盘和统计信息摘要。如需了解如何将其他类型的微件添加到信息中心，请参阅以下文档：

如需了解 Cloud Monitoring API，请参阅使用 API 管理信息中心。

准备工作

  • 如需获取使用 Google Cloud 控制台创建和修改自定义信息中心所需的权限，请让管理员向您授予项目的 Monitoring Editor (roles/monitoring.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理访问权限。

    您也可以通过自定义角色或其他预定义角色来获取所需的权限。

    如需详细了解角色，请参阅使用 Identity and Access Management 控制访问权限。

  • 信息中心最多可容纳 40 个微件。

  • 如需向信息中心添加微件，您可以选择可视化图表，然后配置该微件，也可以先选择数据类型，然后再配置可视化图表。

    例如，如需向信息中心添加显示虚拟机实例 CPU 利用率的表，您可以执行以下任一操作：

    • 选择表微件，然后配置该微件以显示虚拟机实例的 CPU 利用率。
    • 选择指标数据类型，配置该微件以显示虚拟机实例的 CPU 利用率，然后将该微件类型更改为表。

    本页面中的说明假定您首先选择数据类型，然后配置数据的显示方式。

将图表和表格添加到信息中心

本部分介绍如何使用 Google Cloud 控制台配置图表和表格：

如需将图表或表添加到信息中心，请执行以下操作：

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

    前往信息中心

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    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，请参阅以下文档：

    PromQL

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

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

      avg(compute_googleapis_com:instance_cpu_utilization)

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

    监控过滤条件

    1. 在指标元素中，点击 帮助，然后选择直接过滤模式。

      系统会删除 Metric 和 Filter 元素，并创建用于输入文本的 Filters 元素。

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

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

    3. 合并和校准时序：

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

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

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

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

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

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

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

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

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

  6. 可选：将图表配置为显示多种指标类型。

    1. 选择添加查询。系统会添加新查询。例如，可能会添加具有标签 BB 的查询。

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

    以下屏幕截图展示了在绘制两种指标类型时 Metrics Explorer 的显示情况：

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

    MQL

    不支持。

    PromQL

    不支持。

    监控过滤条件

    不支持。

  7. 可选：将图表配置为显示指标类型的比率。

    1. 将图表配置为显示两个具有相同指标种类的指标类型。例如，两者均为 GAUGE 指标。
    2. 确保两种指标类型的最小间隔字段的值相同。如需访问此字段，请点击 添加查询元素，然后选择最小间隔。

    3. 更新聚合字段。

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

      您无需对这两种指标类型使用同一组标签；但是，您只能选择两种指标类型通用的标签。

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

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

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

      以下示例说明了将每个地区写入磁盘的字节数之和与写入磁盘的总字节数之和的比率：

      指标比率的示例。

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

    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，请参阅以下文档：

    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。

    监控过滤条件

    不支持。

  8. 可选：如需更改可视化图表，请在 Display 窗格中点击 Widget type，然后进行选择。

    微件类型菜单列出了可以显示相同类型数据的所有微件类型；不过，某些微件可能未启用。例如，假设信息中心上有一个图表配置为显示一种指标类型。折线图显示了多个时序，并且每个测量值都是一个双精度值：

    • 表格、饼图、折线图、堆叠条形图和堆叠面积图微件被列为 Compatible。您可以选择这些类型中的任意一种。

    • 统计信息摘要和采样平均值微件被列为与调整兼容，因为这些微件只能显示单个时序。如需启用这些类型的微件，请修改分组配置。

    • Heatmap widget 已停用，因为这些 widget 只能显示分布值数据。

    • 日志面板未列出，因为日志面板无法显示时间序列数据。

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

  10. 如需将更改应用到信息中心，请在工具栏中点击 Apply。如需舍弃更改，请点击取消。

  11. 要保存修改后的信息中心，请点击工具栏中的保存。

仅显示最新数据

Monitoring 为您提供了几种仅直观呈现最近的测量结果（而不是查看测量记录）的方法：

  • 如需以图形方式显示每个时序的最新值（其中每个值都显示为所有值总和的比例），请添加饼图。您可以配置这些图表以显示总值。

  • 如需以表格形式显示每个时序的最新值，请添加一个表格。您可以限制表中的行数，还可以将表的行配置为显示某个值与一系列值的对比情况。

  • 如需以绿色、琥珀色或红色表示最新值与一组阈值的对比情况，请向信息中心添加刻度盘图或统计信息摘要。

使用饼图绘制最新数据

要查看占总数的最近数据，请添加饼图。 与表格一样，饼图可以显示具有数值的任何指标类型，并且可以显示分布值指标的百分位。每个时序都会向这个饼图分配一个切片。

以下屏幕截图展示了一个信息中心，该信息中心使用饼图微件的两种不同配置来显示虚拟机实例的 CPU 利用率：

**PieChart** 微件示例。

如需了解如何将饼图添加到信息中心，请参阅以下文档：

  • Google Cloud 控制台：请参阅本文档中标题为添加图表和表格的部分。

    • 选择要添加到图表的数据后，在显示窗格中，将微件类型字段设置为饼图。
    • 要显示总计值，请将图表类型字段设置为圆环。

  • Cloud Monitoring API：请参阅包含 PieChart 微件的信息中心。

以表格形式显示最新数据

如需以表格形式查看最新数据，请添加一个表格。 这些表可以显示具有数值的任何指标类型，还可以显示分布值指标的百分位。表格仅显示最新值，与刻度盘和统计信息摘要的行为类似。但是，与测量仪表和统计信息摘要不同，表针对每个受监控的时序包含一行。

表格有两种样式。Top List widget 已预先配置为具有两列，用于限制行数。Top List widget 中的一列显示类似 instance_id 的标签，另一列同时显示值及其与可能值范围的比较结果的视觉指示符。Table widget 已预先配置为为每个标签显示一个列，其中每个标签具有多个唯一值、每个时序占一行，以及类似于“25%”的数值。

这两个 widget 都由相同的数据结构表示。因此，将其中一个微件添加到信息中心后，您可以限制显示的行数、更改表显示的列以及更改值的表示方式。

以下屏幕截图展示了一个信息中心，该信息中心使用顶部列表 widget 和表 widget 显示虚拟机实例的 CPU 利用率：

**Top List** 和 **Table** 微件示例。

如需了解如何将表添加到信息中心，请参阅以下文档：

对表格进行排序和过滤

您可以更改表显示行的顺序，并且可以过滤表内容，以便仅显示特定行。这些设置不是永久性的。当您离开信息中心页面或重新加载信息中心时，系统会舍弃您应用的排序和过滤选项。

具有以下排序和过滤选项：

  • 如需按某个列对表格进行排序，请点击列标题。

  • 如需更改表格列，请点击 查看列，进行修改，然后点击确定。

  • 如需仅列出特定行，请添加一个或多个过滤条件。您可以添加多个过滤条件。如果您未在两个过滤条件之间指定 OR 运算符，则逻辑 AND 会联接那些过滤条件。

    如需添加过滤条件，请点击 Enter property name or value，从菜单中选择一个属性，然后输入值或从值菜单中选择。 例如，如果您过滤属性 Name 并输入值 demo，则表仅列出 Name 字段包括值 demo 的行。

显示最新数据，并指明警告或错误

如需查看与一组颜色编码阈值相比的最近测量结果，请添加仪表盘或统计信息摘要图表。仪表盘仅显示最近的测量结果，而统计信息摘要还会显示最近测量结果的历史记录。这些微件的背景颜色也是用颜色编码的。当最新值在预期范围内时，微件颜色为白色。当该值在警告范围内时，微件会变为琥珀色。同样，当值处于危险范围内时，微件会变为红色。

两个微件都显示单个时序。以下屏幕截图显示了最近测量结果小于警告和危险阈值的刻度盘示例：

刻度盘示例。

本部分中的其余信息适用于 Google Cloud 控制台。如需了解如何使用 Cloud Monitoring API，请参阅包含基本 Scorecard 的信息中心。

如需向信息中心添加刻度盘或统计信息摘要图表，请执行以下操作：

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

    前往信息中心

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    2. 使用 Aggregation 字段合并时序：

      • 展开第一个菜单，然后选择用于组合时序的函数。
      • 展开第二个菜单并确保未选择任何标签。

    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
| group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]

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

    PromQL

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

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

      avg(compute_googleapis_com:instance_cpu_utilization)

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

    监控过滤条件

    1. 在指标元素中，点击 帮助，然后选择直接过滤模式。

      系统会删除 Metric 和 Filter 元素，并创建用于输入文本的 Filters 元素。

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

    2. 输入 Monitoring 过滤条件。

    3. 使用 Aggregation 字段合并时序：

      • 展开第一个菜单，然后选择用于组合时序的函数。
      • 展开第二个菜单并确保未选择任何标签。

  6. 在显示窗格中，配置刻度盘或统计信息摘要：

    1. 点击 Widget type，然后选择 Gauge 或 Scorecard。

    2. 对于刻度盘微件，请点击 刻度盘范围，然后设置最小值和最大值。当刻度盘显示百分比时，请将这两个值分别设置为 0 和 1。

    3. 点击 采样平均值阈值，然后设置警告和危险阈值。系统不会使用空白的阈值字段。

      对于之前显示的量表，设置了两个阈值。高于 0.9 的值处于危险范围内。高于 0.7 但不在危险范围内的值位于警告范围内。

    4. 对于统计信息摘要，请点击 Spark 图表视图，然后展开选项菜单，然后选择显示样式。

  7. 如需将更改应用到信息中心，请在工具栏中点击 Apply。如需舍弃更改，请点击取消。

  8. 要保存修改后的信息中心，请点击工具栏中的保存。

后续步骤

您还可以将以下微件添加到您的自定义信息中心：

如需了解如何探索已绘制成图表的数据和过滤信息中心，请参阅以下文档：