本文档介绍如何使用 Google Cloud 控制台将图表、表、刻度盘和统计信息摘要添加到自定义信息中心。您可以通过添加折线图、堆叠面积图、条形图或热图图表来显示一段时间内的指标数据。如果您只对最近的测量结果感兴趣,可添加表格、饼图、刻度盘或统计信息摘要。量表和统计信息摘要会根据最新值与警告和危险阈值的比较结果来改变颜色。
您可以添加到信息中心的可视化图表统称为微件。如需了解有关不同 widget 类型的一般信息,请参阅信息中心概览。
自定义信息中心内的图表、表格、刻度盘和统计信息摘要可以显示具有数字值或分布值的任何指标类型,包括用户定义的指标和基于日志的指标。图表无法绘制字符串类型数据图表。
本文档介绍了如何将图表、表格、刻度盘和统计信息摘要添加到显示时间序列数据的自定义信息中心。如需了解如何向信息中心添加其他类型的微件,请参阅以下文档:
如需了解 Cloud Monitoring API,请参阅使用 API 管理信息中心。
准备工作
-
如需获取使用 Google Cloud 控制台创建和修改自定义信息中心所需的权限,请让管理员授予您项目的 Monitoring Editor (
roles/monitoring.editor
) IAM 角色。 如需详细了解如何授予角色,请参阅管理访问权限。如需详细了解角色,请参阅使用 Identity and Access Management 控制访问权限。
信息中心最多可容纳 40 个微件。
如需向信息中心添加微件,您可以选择可视化图表,然后配置该微件,也可以先选择数据类型,然后再配置可视化图表。
例如,如需向信息中心添加显示虚拟机实例 CPU 利用率的表,您可以执行以下任一操作:
- 选择 Table 微件,然后配置该微件以显示虚拟机实例的 CPU 利用率。
- 选择指标数据类型,将微件配置为显示虚拟机实例的 CPU 利用率,然后将微件类型更改为表。
本页面中的说明假定您先选择数据类型,然后配置该数据的显示方式。
将图表和表格添加到信息中心
本部分介绍如何使用 Google Cloud 控制台配置图表和表格:
图表会显示一段时间内的数据,且有四种样式:折线图、堆积面积图、堆积条形图和热图。配置图表后,您可以更改其 widget 类型。如需了解选择特定样式的原因,请参阅显示随时间变化数据的图表。
如需了解如何使用 Cloud Monitoring API 配置图表,请参阅包含
XyChart
微件的信息中心。表会为每个受监控的时序提供一行,并且仅显示最新值。有两种样式的表格。Table widget 会显示一个数值,例如“25%”。Top List widget 会根据可能值的范围,同时显示该值和一个直观指示符。您可以在这些微件类型之间切换。如需了解详情并查看示例,请参阅在信息中心内以表格形式显示数据。
如需了解如何使用 Cloud Monitoring API 配置表,请参阅包含
TimeSeriesTable
widget 的信息中心。
如需将图表或表添加到信息中心,请执行以下操作:
-
在 Google Cloud 控制台的导航面板中,选择 Monitoring,然后选择 信息中心:
执行下列其中一项操作:
- 如需创建新的信息中心,请选择创建信息中心。
- 如需更新现有信息中心,请在所有信息中心的列表中找到该信息中心,然后选择其名称。
在工具栏中,点击 add 添加微件。
在添加微件对话框中,选择 leaderboard 指标。
指定要在图表上显示的数据。您可以使用菜单驱动型界面、Monitoring Query Language (MQL)、PromQL,或输入 Monitoring 过滤条件:
菜单驱动的界面
选择要查看的时序数据:
在指标元素中,展开选择指标菜单。
选择指标菜单包含一些功能,可帮助您查找可用的指标类型:
如需查找特定的指标类型,请使用 filter_list 过滤栏。例如,如果您输入
util
,则会限制菜单显示包含util
的条目。条目在通过不区分大小写的“包含”测试后即会显示。如需显示所有指标类型,包括没有数据的指标类型,请点击
活跃。默认情况下,这些菜单仅显示包含数据的指标类型。
例如,您可能会做出以下选择:
- 在活跃资源菜单中,选择虚拟机实例。
- 在活跃指标类别菜单中,选择 uptime_check。
- 在活跃指标菜单中,选择请求延迟时间。
- 点击应用。
可选:如需指定要显示的数据子集,请在 Filter 元素中选择添加过滤条件,然后完成对话框。例如,您可以通过应用过滤条件来查看某个区域的数据。您可以添加多个过滤条件。如需了解详情,请参阅过滤已绘制成图表的数据。
如需了解详情,请参阅选择要用于绘制图表的数据。
组合和对齐时序:
如需显示每个时序,请在 Aggregation 元素中将第一个菜单设置为 Unaggregated,将第二个菜单设置为 None。
如需组合时序,请在 Aggregation 元素中执行以下操作:
展开第一个菜单并选择一个函数。
系统会刷新图表,并显示单个时序。例如,如果您选择平均值,则显示的时序是所有时序的平均值。
如需组合具有相同标签值的时序,请展开第二个菜单,然后选择一个或多个标签。
系统会刷新图表,并针对标签值的每个唯一组合显示一个时序。例如,如需按时区显示时序,请将第二个菜单设置为 zone。
当第二个菜单设置为 None 时,图表会显示一个时序。
可选:如需配置数据点之间的间距,请点击 add 添加查询元素,选择最小间隔,然后输入一个值。
如需详细了解分组和校准,请参阅选择如何显示已绘制成图表的数据。
可选:如需仅显示具有最高或最低值的时序,请使用排序和限制元素。
MQL
- 在查询构建器窗格的工具栏中,选择名为 code MQL 或 code PromQL 的按钮。
- 验证已在语言切换开关中选择 MQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
-
在查询编辑器中输入查询。例如,如需绘制 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
- 在查询构建器窗格的工具栏中,选择名为 code MQL 或 code PromQL 的按钮。
- 验证已在语言切换开关中选择 PromQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
-
在查询编辑器中输入查询。例如,如需绘制 Google Cloud 项目中虚拟机实例的平均 CPU 利用率图表,请使用以下查询:
avg(compute_googleapis_com:instance_cpu_utilization)
如需详细了解如何使用 PromQL,请参阅 Cloud Monitoring 中的 PromQL。
监控过滤条件
-
在 Metric 元素中,点击 help_outline Help,然后选择 Direct Filter Mode。
删除了 Metric 和 Filter 元素,并创建用于输入文字的 Filters 元素。
如果您在切换到直接过滤模式之前选择了资源类型、指标或过滤条件,则这些设置会显示在过滤条件元素的字段中。
- 在 Filters 元素的字段中输入 Monitoring 过滤条件。
组合和对齐时序:
如需显示每个时序,请在 Aggregation 元素中将第一个菜单设置为 Unaggregated,将第二个菜单设置为 None。
如需组合时序,请在 Aggregation 元素中执行以下操作:
展开第一个菜单并选择一个函数。
系统会刷新图表,并显示单个时序。例如,如果您选择平均值,则显示的时序是所有时序的平均值。
如需组合具有相同标签值的时序,请展开第二个菜单,然后选择一个或多个标签。
系统会刷新图表,并针对标签值的每个唯一组合显示一个时序。例如,如需按时区显示时序,请将第二个菜单设置为 zone。
当第二个菜单设置为 None 时,图表会显示一个时序。
可选:如需配置数据点之间的间距,请点击 add 添加查询元素,选择最小间隔,然后输入一个值。
如需详细了解分组和校准,请参阅选择如何显示已绘制成图表的数据。
可选:配置图表以显示多种指标类型。
菜单驱动的界面
选择添加查询。系统会添加一个新查询。例如,可能会添加带有标签 B 的查询。B
对于新查询,请在指标元素中选择资源类型和指标类型。您还可以添加过滤条件、合并时序,并对显示的时序数进行排序和限制。
以下屏幕截图展示了 Metrics Explorer 中有两个指标类型绘制成图表的情况:
MQL
不受支持。
PromQL
不受支持。
监控过滤条件
不受支持。
可选:配置图表以显示指标类型的比率。
菜单驱动的界面
- 配置图表以显示指标种类相同的两个指标类型。例如,两者都是
GAUGE
指标。 - 确保这两种指标类型的最小间隔字段的值相同。如需访问此字段,请点击 add 添加查询元素,然后选择最小间隔。
-
更新聚合字段。
我们建议分母指标类型的标签与为分子指标类型设置的值保持一致。例如,您可以为分子和分母选择
zone
标签。您无需为这两种指标类型使用相同的标签集;但是,您只能选择这两种指标类型共有的标签。
-
在查询窗格的工具栏中,选择创建比率,然后完成对话框。
创建比率后,系统会显示三个查询:
- A/B 比率用于标识比率查询。
- A 标识针对分子的查询。
- B 标识针对分母的查询。
以下示例说明了一个比率,该比率用于比较每个可用区写入磁盘的字节数总和与写入磁盘的字节总数:
-
可选:如需切换分子和分母指标,请在比率元素中展开菜单,然后进行选择。
MQL
- 在查询构建器窗格的工具栏中,选择名为 code MQL 或 code PromQL 的按钮。
- 验证已在语言切换开关中选择 MQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
-
在查询编辑器中输入查询。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
- 在查询构建器窗格的工具栏中,选择名为 code MQL 或 code PromQL 的按钮。
- 验证已在语言切换开关中选择 PromQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
-
在查询编辑器中输入查询。例如,如需绘制
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。
监控过滤条件
不受支持。
- 配置图表以显示指标种类相同的两个指标类型。例如,两者都是
可选:如需更改可视化图表,请在显示窗格中点击 arrow_drop_down 微件类型,然后进行选择。
微件类型菜单列出了可以显示相同类型数据的所有微件类型;不过,有些微件可能未启用。例如,假设信息中心上的图表配置为显示一种指标类型。折线图显示了多个时序,并且每个测量值都是双精度浮点值:
表格、饼图、折线图、堆叠条形图和堆叠面积图 widget 列为兼容。您可以选择以下任意类型。
统计信息摘要和采样平均值 widget 列为与调整兼容,因为这些 widget 只能显示单个时序。如需启用这些 widget 类型,请修改分组配置。
热图 widget 已停用,因为这些 widget 只能显示分布值数据。
日志面板未列出,因为日志面板无法显示时间序列数据。
可选:如需更改图表显示所选数据的方式,请使用 Display 窗格中的选项:
- 如需将图表配置为以 X 射线模式显示或显示统计信息,请点击 arrow_drop_down 分析模式。
- 如需比较当前数据与过往数据,请点击 arrow_drop_down 与过往数据比较。
- 如需添加参考阈值,请点击 arrow_drop_down 阈值线。
- 如需配置图例列的名称,请点击 arrow_drop_down 图例别名。
- 如需配置 Y 轴分配、标签或刻度,请使用 Y 轴分配、Y 轴标签和 Y 轴刻度菜单。
如需将更改应用于信息中心,请在工具栏中点击 Apply。如需舍弃更改,请点击取消。
要保存修改后的信息中心,请在工具栏中点击保存。
仅显示最新数据
Monitoring 提供了多种方法来仅直观呈现最近的测量结果,而不是查看测量记录:
如需以图形方式显示每个时序的最新值(其中每个值都显示为所有值总和的一部分),请添加饼图。您可以将这些图表配置为显示总值。
如需以表格形式显示每个时序的最新值,请添加表。您可以限制表中的行数,还可以将表的行数配置为显示某个值与一系列值的对比情况。
如需通过绿色、琥珀色或红色表示最新值与一组阈值的对比情况,请向信息中心添加刻度盘或统计信息摘要。
使用饼图绘制最新数据
若要查看最新数据在总数据中所占的比例,请添加饼图。 与表格一样,饼图可以显示具有数值的任何指标类型,并且可以显示分布值指标的百分位数。每个时序向饼图中做出一片。
以下屏幕截图展示了一个信息中心,该信息中心使用饼图微件的两种不同配置来显示虚拟机实例的 CPU 利用率:
有关如何向信息中心添加饼图的信息,请参阅以下文档:
Google Cloud 控制台:请参阅本文档中标题为添加图表和表格的部分。
- 选择要绘制成图表的数据后,在显示窗格中,将微件类型字段设置为饼图。
- 要显示总值,请将图表类型字段设置为甜甜圈。
Cloud Monitoring API:请参阅包含
PieChart
微件的信息中心。
以表格形式显示最新数据
如需以表格形式查看最新数据,请添加表格。 表可以显示具有数值的任何指标类型,并且可以显示分布值指标的百分位数。表格仅显示最新值,类似于刻度盘和统计信息摘要的行为。但是,与刻度盘和统计信息摘要不同,表会为每个受监控的时序添加一行。
有两种样式的表格。Top List 微件已预先配置为包含两列并限制行数。Top List widget 中的一列显示类似 instance_id
的标签,另一列显示该值和与可能值范围进行比较的直观指示符。Table widget 已预先配置为为每个标签显示一列,该列具有多个唯一值、每个时序各占一行,以及一个数值(例如“25%”)。
这两个 widget 均由相同的数据结构表示。因此,将其中一个微件添加到信息中心后,您可以限制显示的行数、更改表中显示的列以及更改值的表示方式。
以下屏幕截图展示了一个信息中心,该信息中心使用列表微件和表微件来显示虚拟机实例的 CPU 利用率:
如需了解如何向信息中心添加表,请参阅以下文档:
Google Cloud 控制台:请参阅本文档中标题为添加图表和表格的部分。
选择要绘制图表的数据后,在显示窗格中,将微件类型字段设置为表格或排行榜。
Cloud Monitoring API:请参阅包含
TimeSeriesTable
微件的信息中心。
对表格进行排序和过滤
您可以更改表显示行的顺序,并且可以过滤表内容,以便仅显示特定行。这些设置不是永久性的。当您离开信息中心页面或重新加载信息中心时,系统会舍弃您应用的排序和过滤选项。
具有以下排序和过滤选项:
如需按某个列对表格进行排序,请点击列标题。
如需更改表格列,请点击 view_column 查看列,进行修改,然后点击确定。
如需仅列出特定行,请添加一个或多个过滤条件。您可以添加多个过滤条件。如果您未在两个过滤条件之间指定 OR 运算符,则逻辑 AND 会联接那些过滤条件。
如需添加过滤条件,请点击
Enter property name or value
,从菜单中选择一个属性,然后输入值或从值菜单中选择。 例如,如果您过滤属性Name
并输入值demo
,则表仅列出Name
字段包括值demo
的行。
显示最新数据,并带有警告或错误指示
如需查看与一组颜色编码阈值相比的最近测量结果,请添加仪表盘或统计信息摘要图表。仪表盘仅显示最近的测量结果,而统计信息摘要还会显示最近测量结果的历史记录。这些微件的背景颜色也是用颜色编码的。当最新值在预期范围内时,微件颜色为白色。当该值在警告范围内时,微件会变为琥珀色。同样,当值处于危险范围内时,微件会变为红色。
两个微件都显示单个时序。以下屏幕截图显示了最近测量结果小于警告和危险阈值的刻度盘示例:
本部分的其余信息适用于 Google Cloud 控制台。如需了解如何使用 Cloud Monitoring API,请参阅包含基本 Scorecard
的信息中心。
如需向信息中心添加刻度盘或统计信息摘要图表,请执行以下操作:
-
在 Google Cloud 控制台的导航面板中,选择 Monitoring,然后选择 信息中心:
执行下列其中一项操作:
- 如需创建新的信息中心,请选择创建信息中心。
- 如需更新现有信息中心,请在所有信息中心的列表中找到该信息中心,然后选择其名称。
在工具栏中,点击 add 添加微件。
在添加微件对话框中,选择 leaderboard 指标。
指定要在图表上显示的数据。您可以使用菜单驱动型界面、Monitoring Query Language (MQL)、PromQL,或输入 Monitoring 过滤条件:
菜单驱动的界面
选择要查看的时序数据:
在指标元素中,展开选择指标菜单。
选择指标菜单包含一些功能,可帮助您查找可用的指标类型:
如需查找特定的指标类型,请使用 filter_list 过滤栏。例如,如果您输入
util
,则会限制菜单显示包含util
的条目。条目在通过不区分大小写的“包含”测试后即会显示。如需显示所有指标类型,包括没有数据的指标类型,请点击
活跃。默认情况下,这些菜单仅显示包含数据的指标类型。
例如,您可能会做出以下选择:
- 在活跃资源菜单中,选择虚拟机实例。
- 在活跃指标类别菜单中,选择 uptime_check。
- 在活跃指标菜单中,选择请求延迟时间。
- 点击应用。
可选:如需指定要显示的数据子集,请在 Filter 元素中选择添加过滤条件,然后完成对话框。例如,您可以通过应用过滤条件来查看某个区域的数据。您可以添加多个过滤条件。如需了解详情,请参阅过滤已绘制成图表的数据。
如需了解详情,请参阅选择要用于绘制图表的数据。
使用 Aggregation 字段合并时序:
- 展开第一个菜单,然后选择用于组合时序的函数。
- 展开第二个菜单并确保未选择任何标签。
MQL
- 在查询构建器窗格的工具栏中,选择名为 code MQL 或 code PromQL 的按钮。
- 验证已在语言切换开关中选择 MQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
-
在查询编辑器中输入查询。您必须确保将聚合字段设置为合并所有时序。例如,如需绘制 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
- 在查询构建器窗格的工具栏中,选择名为 code MQL 或 code PromQL 的按钮。
- 验证已在语言切换开关中选择 PromQL。语言切换开关位于同一工具栏中,用于设置查询的格式。
-
在查询编辑器中输入查询。例如,如需绘制 Google Cloud 项目中虚拟机实例的平均 CPU 利用率图表,请使用以下查询:
avg(compute_googleapis_com:instance_cpu_utilization)
如需详细了解如何使用 PromQL,请参阅 Cloud Monitoring 中的 PromQL。
监控过滤条件
-
在 Metric 元素中,点击 help_outline Help,然后选择 Direct Filter Mode。
删除了 Metric 和 Filter 元素,并创建用于输入文字的 Filters 元素。
如果您在切换到直接过滤模式之前选择了资源类型、指标或过滤条件,则这些设置会显示在过滤条件元素的字段中。
- 输入 Monitoring 过滤条件。
使用 Aggregation 字段合并时序:
- 展开第一个菜单,然后选择用于组合时序的函数。
- 展开第二个菜单并确保未选择任何标签。
在 Display 窗格中,配置刻度盘或统计信息摘要:
点击 arrow_drop_down 微件类型,然后选择采样平均值或统计信息摘要。
对于刻度盘微件,请点击 arrow_drop_down 采样平均值范围,然后设置最小值和最大值。当量表显示百分比时,请分别将这些值设置为 0 和 1。
点击 arrow_drop_down 采样阈值,然后设置警告和危险阈值。系统不使用空阈值字段。
对于之前显示的量表,设置了两个阈值。大于 0.9 的值处于危险范围内。高于 0.7 但不在危险范围内的值包含在警告范围内。
对于统计信息摘要,请点击 arrow_drop_down Spark 图表视图,然后展开选项菜单,然后选择显示样式。
如需将更改应用于信息中心,请在工具栏中点击 Apply。如需舍弃更改,请点击取消。
要保存修改后的信息中心,请在工具栏中点击保存。
后续步骤
您还可以将以下微件添加到自定义信息中心:
如需了解如何探索绘制成图表的数据以及如何过滤信息中心,请参阅以下文档: