菜单
Grafana Cloud Enterprise 开源

Stat

注意

此可视化取代了 Singlestat 可视化,Singlestat 已在 Grafana 7.0 中弃用,并在 Grafana 8.0 中移除。

Stat 可视化以您感兴趣的单一值(例如系列的最新或当前值)显示您的数据,并可选择附带图表迷你图。图表迷你图仅在 Stat 可视化中可用,是在可视化中每个值的背景中显示的小型时间序列图。

例如,如果您正在监控各种服务的利用率,您可以使用 Stat 可视化显示它们的最新使用情况

A stat panel showing latest usage of various services

在需要以下情况时使用 Stat 可视化

  • 快速浏览关键指标,例如应用的最新健康状况、应用中高优先级 bug 的数量或总销售额。
  • 显示聚合数据,例如服务的平均响应时间。
  • 突出显示高于正常阈值的值,以便快速识别任何指标是否超出预期范围。
Give it a try using Grafana Play
在 Grafana Play 中试用

通过 Grafana Play,您可以探索并了解其工作原理,从实际示例中学习,从而加速您的开发。此功能可在 Grafana 中的 Stat 可视化中看到。

配置 Stat 可视化

创建仪表盘后,以下视频将向您展示如何配置 Stat 可视化

另外,请参阅这篇博文,了解如何在 Grafana 中使用 Stat 可视化轻松从范围中检索值。

支持的数据格式

Stat 可视化支持多种数据格式显示。支持的格式包括

  • 单一值 - 最常见的格式,可以是数值、字符串或布尔值。
  • 时间序列数据 - 计算类型可以应用于您的时间序列数据,以在指定时间范围内显示单一值。

示例

下表是 Stat 可视化所需数据类型及其格式的示例。

单一数值

高优先级 bug 数量
80
52
59
40

数据可视化如下,显示了最新值以及迷你图和百分比变化

A stat panel showing the latest number of high priority bugs

时间序列数据

时间地下室客厅门廊卧室客房厨房
2024-03-20 06:34:4012.318.318.815.99.299.61
2024-03-20 06:41:4016.817.121.514.110.517.5
2024-03-20 06:48:4016.718.021.09.5113.620.1
2024-03-20 06:55:4014.318.716.59.1114.812.5
2024-03-20 07:02:4012.815.221.115.67.9813.0

数据可视化如下,显示了每个房间的平均值以及房间名称、迷你图和计量单位

A stat panel showing some statistics for each room in square meters

默认情况下,Stat 显示以下内容之一

  • 仅显示单一系列或字段的值。
  • 显示多个系列或字段的值和名称。

您可以使用文本模式控制文本的显示方式。

配置选项

以下部分描述了此可视化在面板编辑器窗格中的可用配置选项。这些选项尽可能按照它们在 Grafana 中出现的顺序排列。

面板选项

在面板编辑器窗格的面板选项部分,设置基本选项,例如面板标题和描述,以及面板链接。要了解更多信息,请参阅配置面板选项

值选项

使用以下选项调整可视化显示值的方式

选项描述
显示按列或系列显示单一值,或显示每行的值。选择以下选项:
  • 计算 - 基于所有行显示计算值。
  • 所有值 - 为每一行显示一个单独的 Stat。如果选择此选项,则还可以限制要显示的行数。
计算当您选择计算作为您的显示选项时,此选项会显示。选择 Grafana 将用于将多个字段减少为单个值的 reducer 函数。有关可用计算列表,请参阅计算类型
限制当您选择所有值作为您的显示选项时,此选项会显示。设置要显示的最大行数。默认值为 5,000。
字段选择可视化中显示的字段。

Stat 样式

Stat 可视化会根据仪表盘中可用的宽度和高度自动调整布局,但您也可以使用以下选项进一步设置可视化样式。

选项描述
方向选择堆叠方向。选择以下选项:
  • 自动 - Grafana 选择理想方向。
  • 水平 - 条形图水平延伸,从左到右。
  • 垂直 - 条形图垂直延伸,从上到下。
文本模式您可以使用文本模式选项控制可视化渲染哪些文本。如果值不重要,只需要名称和颜色,则将文本模式更改为名称。该值仍将用于确定颜色并显示在工具提示中。
宽布局设置是否启用宽布局。默认情况下启用宽布局。此选项仅适用于文本模式设置为值和名称时。
颜色模式选择颜色模式。选择以下选项:
  • - 不对值应用颜色。
  • - 对值和图表区域应用颜色。
  • 背景渐变 - 对值、图表区域和背景应用颜色,并带有轻微的背景渐变。
  • 背景纯色 - 对值、图表区域和背景应用颜色,并带有纯色背景。
图表模式选择图表迷你图模式。选择以下选项:
  • - 隐藏图表迷你图,仅显示值。
  • 区域 - 在值下方显示图表迷你图。这要求您的查询返回一个时间列。
如果面板变得太小,图表迷你图会自动隐藏。
文本对齐选择对齐模式。选择以下选项:
  • 自动 - 如果仅显示单个值(不重复),则值居中。如果显示多个系列或行,则值左对齐。
  • 居中 - Stat 值居中。
显示百分比变化设置是否显示百分比变化。默认情况下禁用。此选项适用于当“值选项”下的“显示”设置设置为“计算”时。
百分比变化颜色模式仅当启用显示百分比变化时才显示此选项。选择以下选项:
  • 标准 - 如果百分比变化为正,则为绿色;如果百分比变化为负,则为红色。
  • 反转 - 如果百分比变化为正,则为红色;如果百分比变化为负,则为绿色。
  • 与值相同 - 使用与值相同的颜色。

文本模式

您可以使用文本模式选项控制可视化渲染哪些文本。如果值不重要,只需要名称和颜色,则将文本模式更改为名称。该值仍将用于确定颜色并显示在工具提示中。

  • 自动 - 如果数据包含多个系列或字段,则同时显示名称和值。
  • - 仅显示值,不显示名称。名称显示在悬停工具提示中。
  • 值和名称 - 始终显示值和名称。
  • 名称 - 显示名称而不是值。值显示在悬停工具提示中。
  • - 不显示任何内容(空)。名称和值显示在悬停工具提示中。

宽布局

设置是否启用宽布局。默认情况下启用宽布局。

  • 启用 - 启用宽布局。
  • 禁用 - 禁用宽布局。

此选项仅适用于文本模式设置为值和名称时。当启用宽布局时,如果面板足够宽,值和名称会并排显示,值在右侧。当禁用宽布局时,值始终显示在名称下方。

文本大小

调整 Stat 文本的大小。

  • 标题 - 输入 Stat 标题大小的数值。
  • - 输入 Stat 值大小的数值。

标准选项

面板编辑器窗格中的标准选项允许您更改字段数据在可视化中的显示方式。设置标准选项后,更改会应用于所有字段或系列。要更精细地控制字段显示,请参阅配置覆盖

选项描述
单位选择字段应使用的单位。
最小值/最大值设置百分比阈值计算中使用的最小值和最大值,或将这些字段留空以便自动计算。
字段最小值/最大值启用字段最小值/最大值,让 Grafana 根据字段的最小值或最大值单独计算每个字段的最小值或最大值。
小数位数指定 Grafana 在渲染值中包含的小数位数。
显示名称设置所有字段的显示标题。您可以在字段标题中使用变量。
配色方案为整个可视化设置单一或多种颜色。
无值输入字段值为空或 null 时 Grafana 应显示的内容。默认值是连字符 (-)。

要了解更多信息,请参阅配置标准选项

数据链接允许您链接到其他面板、仪表盘和外部资源,同时保持源面板的上下文。您可以创建包含系列名称甚至光标下值的链接。要了解更多信息,请参阅配置数据链接和操作

注意

此可视化不支持操作。

对于每个数据链接,设置以下选项

  • 标题
  • URL
  • 在新标签页中打开

此可视化的数据链接不包含一键开关,但是,如果仅配置了一个数据链接,则该数据链接具有单次点击功能。如果配置了多个数据链接,则点击可视化会打开一个菜单,显示所有数据链接。

值映射

值映射是一种可以用来更改数据在可视化中显示方式的技术。

对于每个值映射,设置以下选项

  • 条件 - 选择映射到显示文本和(可选)颜色的内容
    • - 特定值
    • 范围 - 数值范围
    • Regex - 正则表达式
    • 特殊 - 特殊值,例如 NullNaN(非数字)或布尔值,例如 truefalse
  • 显示文本
  • 颜色(可选)
  • 图标(仅限 Canvas)

要了解更多信息,请参阅配置值映射

阈值

阈值是您为指标设置的值或限制,当达到或超过该值或限制时,会在视觉上反映出来。阈值是基于查询结果有条件地设置可视化样式和颜色的方法之一。

对于每个阈值,设置以下选项

选项描述
设置每个阈值的值。
阈值模式选择绝对百分比

要了解更多信息,请参阅配置阈值

字段覆盖

覆盖允许您自定义特定字段或系列的可视化设置。添加覆盖规则时,它会针对特定的字段集,并允许您为该字段的显示方式定义多个选项。

选择以下覆盖选项

选项描述
按名称选择字段从所有可用字段列表中选择一个字段。
名称匹配 regex 的字段使用正则表达式指定要覆盖的字段。
按类型选择字段按类型选择字段,例如字符串、数值或时间。
查询返回的字段选择特定查询返回的所有字段,例如 A、B 或 C。
带有值的字段选择您定义的 reducer 条件返回的所有字段,例如 MinMaxCountTotal

要了解更多信息,请参阅配置字段覆盖