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

本文档介绍了如何添加图表、表格、刻度盘和统计信息摘要 自定义信息中心您可以 特定时间段的指标数据 堆叠面积图、条形图或热图图。如果您 最近评测的结果，则可以添加一个表格、一个饼图， 或记分卡量表和统计信息摘要根据以下因素更改颜色： 最新值与警告和危险阈值的对比情况。

您可以添加到信息中心的可视化图表 统称为 widget。 有关不同 widget 类型的一般信息， 请参阅信息中心概览。

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

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

• 提醒政策和突发事件
• 日志和错误
• 描述性文字
• 一组服务的服务等级目标 (SLO)
• 显示 Log Analytics 查询结果的图表

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

准备工作

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

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

  有关角色的详细信息，请参阅 使用 Identity and Access Management 控制访问权限。

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

• 要向信息中心添加微件，您可以执行以下任一操作 先选择可视化图表，然后配置微件，也可以选择 数据类型，然后配置可视化图表。

  例如，要添加一个显示 虚拟机实例迁移到信息中心，您可以执行以下任一操作：

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

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

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

本部分介绍如何使用 Google Cloud 控制台：

• 图表可以显示一段时间内的数据，并且有四种样式可供选择： 折线图、堆积面积图、堆积条形图和热图。 配置好图表后，您可以 更改其微件类型。 有关选择特定样式的原因，请参见 显示随时间变化的数据的图表。

  如需了解如何使用 Cloud Monitoring API 配置图表，请参阅 包含 XyChart widget 的信息中心。

• 表中的每个受监控时序都各占一行，并且仅显示 最新的值。表格有两种样式。表格 微件会显示一个数值，如“25%”。Top List 微件随即会显示。 该值以及该值与 可能的值。您可以在这些微件类型之间切换。有关 信息和示例，请参阅 在信息中心以表格形式显示数据。

  如需了解如何使用 Cloud Monitoring API 配置表，请参阅 包含 TimeSeriesTable widget 的信息中心。

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

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

   前往信息中心

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

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

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

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

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

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

   菜单驱动的界面

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

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

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

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

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

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

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

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

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

   2. 合并和校准时序：

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

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

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

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

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

           系统会刷新该图表，并为每个唯一身份 Cookie 显示一个时序 标签值的组合。例如，要在时序上显示 则将第二个菜单设置为 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，然后 选择直接过滤模式。

      删除了 Metric 和 Filter 元素，并有一个 Filters 元素 可让您输入文字的功能。

      如果您选择了资源类型、指标 或过滤器，然后再切换到直接过滤模式模式， 这些设置会显示在 Filters 元素的字段中。

   2. 在 Filters 元素。

   3. 合并和校准时序：

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

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

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

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

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

           系统会刷新该图表，并为每个唯一身份 Cookie 显示一个时序 标签值的组合。例如，要在时序上显示 则将第二个菜单设置为 zone。

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

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

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

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

   菜单驱动的界面

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

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

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

   

   MQL

   不受支持。

   PromQL

   不受支持。

   监控过滤条件

   不受支持。

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

   菜单驱动的界面

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

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

      • 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. 可选：要更改可视化图表，请在显示窗格中执行以下操作： 点击 Widget type，然后进行选择。

   Widget type 菜单列出了可显示 相同类型的数据；不过，部分微件可能未启用。 例如，假设数字面板上的一个图表配置为 指标类型。折线图显示了多个时序，并且每个时序 测量值为双精度：

   • 表格、饼图、折线图、堆叠条形图和 堆叠面积图 widget 被列为 Compatible。您可以选择 任意类型。

     注意 ：如需以表格形式显示数据，请将 将微件类型设为表格。如果您选择表格， Chart Table Two，则显示内容会发生更改，但此设置不会 保存。

   • 统计信息摘要和采样平均值微件列为 与调整项兼容，因为这些微件可以 仅显示一个时序。要启用这些类型的微件 修改分组配置。

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

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

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

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

10. 要将更改应用到信息中心，请在工具栏中执行以下操作： 点击应用。如需舍弃更改，请点击取消。

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

仅显示最新数据

Monitoring 只为您提供多种可视化方式 最近的测量，而不是查看测量历史记录：

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

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

• 获得所比较的最新值的绿色、琥珀色或红色指示 一组阈值 向信息中心添加刻度盘图或统计信息摘要。

使用饼图绘制最新数据

要查看占总数的最近数据，请添加饼图。 与表格一样，饼图可显示 指标类型 ，并且也可以显示 分布值指标。每个时序 将一片披萨放到这个派上

以下屏幕截图展示了 虚拟机实例的 CPU 利用率 饼图微件的配置：

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

• Google Cloud 控制台：请参阅 在本文档中添加图表和表格。

  • 选择要绘制成图表的数据后，在显示窗格中，设置 Widget type 字段更改为 Piechart。
  • 要显示总计值，请将图表类型字段设置为圆环。

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

以表格形式显示最新数据

如需以表格形式查看最新数据，请添加一个表格。 表格可以显示任何指标类型 ，并且也可以显示 分布值指标。 表格仅显示最新值，与刻度盘的行为类似 和统计信息摘要不过，与刻度盘图和统计信息摘要图表不同的是，表格只有一行 监控的时序。

表格有两种样式。Top List 微件已预先配置为 两列，并限制行数。 Top List widget 中的一列 显示 instance_id 等标签，其他则显示 该值以及该值与 可能的值。Table widget 已预先配置为显示 具有多个唯一值的每个标签对应一列， 每行一个时序，和一个数值，如“25%”。

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

以下屏幕截图展示了 使用热门列表微件了解虚拟机实例的 CPU 利用率 和一个 Table 微件：

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

• Google Cloud 控制台：请参阅 在本文档中添加图表和表格。

  选择要绘制成图表的数据后，在显示窗格中，设置 Widget type 字段更改为 Table 或 Top List。

• Cloud Monitoring API：请参阅 包含 TimeSeriesTable widget 的信息中心。

对表格进行排序和过滤

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

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

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

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

• 如需仅列出特定行，请添加一个或多个过滤条件。您可以添加多个过滤条件。如果您未在两个过滤条件之间指定 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. 指定要在图表上显示的数据。您可以使用 监控查询语言 (MQL)、PromQL，或者您可以输入 监控过滤条件：

   菜单驱动的界面

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

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

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

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

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

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

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

      • 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，然后 选择直接过滤模式。

      删除了 Metric 和 Filter 元素，并有一个 Filters 元素 可让您输入文字的功能。

      如果您选择了资源类型、指标 或过滤器，然后再切换到直接过滤模式模式， 这些设置会显示在 Filters 元素的字段中。

   2. 输入 Monitoring 过滤条件。

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

      • 展开第一个菜单，然后选择将 时序。
      • 展开第二个菜单并确保未选择任何标签。

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

   1. 点击 Widget type 然后选择采样平均值或统计信息摘要。

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

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

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

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

7. 要将更改应用到信息中心，请在工具栏中执行以下操作： 点击应用。如需舍弃更改，请点击取消。

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

后续步骤

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

• 显示提醒政策和突发事件
• 日志条目
• 描述性文字
• 一组服务的服务等级目标 (SLO)

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

• 研究已绘制成图表的数据
• 过滤自定义信息中心