菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 面板和可视化breadcrumb arrow 可视化breadcrumb arrow 状态历史
Grafana Cloud Enterprise Open source

状态历史

状态历史可视化以显示一段时间内周期性状态的方式显示数据。在状态历史中，每个字段或系列都渲染为一行水平行，其中包含多个框，显示不同的状态。这为您提供了组件或服务状态的集中视图。

例如，如果您正在监控不同服务的健康状态，您可以使用状态历史可视化不同状态（例如“True”或“False”）随时间的变化。每种状态都由不同的颜色表示

A status history panel showing the health status of different sensors

注意

状态历史类似于一个

状态时间线，但配置选项不同。与状态时间线不同，状态历史不合并连续值。

在以下情况需要使用状态历史

  • 监控服务器、应用程序或服务的状态，了解您的基础设施何时随时间推移出现问题。
  • 识别随时间变化的运营趋势。
  • 发现应用程序健康方面出现的任何重复问题。

配置状态历史

创建仪表盘后，您可以使用以下状态时间线视频作为如何配置状态历史的参考

Give it a try using Grafana Play
使用 Grafana Play 试一试

通过 Grafana Play，您可以探索并了解其工作原理，从实际示例中学习以加快您的开发。可以在 Grafana State Timeline & Status History 上查看此功能。

试用

支持的数据格式

如果您的数据以表格形式捕获实体随时间推移的各种状态，则状态历史可视化效果最佳。数据必须包含

  • 时间戳 - 指示每个状态更改发生的时间。这也可以是状态更改的开始时间。您还可以添加一个可选的时间戳来指示状态更改的结束时间。
  • 实体名称/标识符 - 表示您尝试监控的实体的名称。
  • 状态值 - 表示您监控的实体的状态值。这些可以是字符串、数值或布尔状态。

示例

以下表格是状态历史可视化所需数据类型及其格式的示例。

带有空值的单时间列

时间戳Backend_01Backend_02
2024-02-29 8:00:00OKWARN
2024-02-29 8:15:00WARN
2024-02-29 8:18:00WARN
2024-02-29 8:30:00BAD
2024-02-29 8:36:00OK
2024-02-29 8:45:00OK

数据转换如下，空值和空白值在状态历史中可视化为空隙

A status history panel with null values showing the status of two servers

没有空值的双时间列

开始时间结束时间Backend_01Backend_02
2024-02-29 8:00:002024-02-29 8:15:00OKOK
2024-02-29 8:15:002024-02-29 8:30:00OKOK
2024-02-29 8:30:002024-02-29 8:45:00OKOK
2024-02-29 8:45:002024-02-29 9:00:00BADWARN
2024-02-29 9:00:002024-02-29 9:15:00OKWARN

数据转换如下

A status history panel with two time columns showing the status of two servers

配置选项

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

面板选项

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

状态历史选项

使用这些选项优化可视化。

选项描述
显示值控制值是否在状态区域内渲染。选择自动、始终和从不。如果空间充足，自动会渲染值。
行高控制框的高度。1 = 最大空间，0 = 最小空间。
列宽控制框的宽度。1 = 最大空间，0 = 最小空间。
每页大小（启用分页）每页大小选项允许您对状态历史可视化进行分页，以限制一次可见的系列数量。当您有许多系列时，这非常有用。
线宽控制状态区域的线宽。
填充不透明度控制状态区域内的值对齐。

图例选项

当图例选项启用时，它可以显示值映射或阈值区间。要在图例中显示值映射，请务必将颜色方案（如颜色方案中所述）设置为单色或经典调色板。要在图例中查看阈值区间，请将颜色方案设置为来自阈值。

有关图例的更多信息，请参阅配置图例。

可见性

切换开关以打开或关闭图例。

模式

使用这些设置定义图例在可视化中的显示方式。

  • 列表 - 将图例显示为列表。这是图例的默认显示模式。
  • 表格 - 将图例显示为表格。

位置

选择图例的显示位置。

  • 底部 - 在图表下方。
  • 右侧 - 在图表右侧。

宽度

控制图例放置在可视化右侧时的宽度。此选项仅在您将图例位置设置为右侧时显示。

工具提示选项

工具提示选项控制将鼠标悬停在可视化数据点上时出现的信息叠加层。

选项描述
工具提示模式当您将光标悬停在可视化上时，Grafana 可以显示工具提示。选择工具提示的行为方式。
值排序顺序此选项控制工具提示中值的列表顺序。
最大宽度设置工具提示框的最大宽度。
最大高度设置工具提示框的最大高度。默认值为 600 像素。

工具提示模式

当您将光标悬停在可视化上时，Grafana 可以显示工具提示。选择工具提示的行为方式。

  • 单个 - 悬停工具提示仅显示一个系列，即您在可视化上悬停的系列。
  • 所有 - 悬停工具提示显示可视化中的所有系列。Grafana 在工具提示的系列列表中以粗体突出显示您悬停的系列。
  • 隐藏 - 与可视化交互时，不显示工具提示。

使用覆盖来隐藏工具提示中的单个系列。

值排序顺序

当您将工具提示模式设置为所有时，会显示值排序顺序选项。此选项控制工具提示中值的列表顺序。请从以下选项中选择

  • 无 - Grafana 自动对工具提示中显示的值进行排序。
  • 升序 - 工具提示中的值从小到大排序。
  • 降序 - 工具提示中的值从大到小排序。

轴选项

选项描述
位置控制沿 y 轴的系列名称或沿 x 轴的时间值的可见性。
宽度为轴设置固定宽度。默认情况下，Grafana 会动态计算轴的宽度。

标准选项

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

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

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

数据链接允许您链接到其他面板、仪表盘和外部资源，而操作允许您触发基本的、未经身份验证的 API 调用。在这两种情况下，您都可以在保持源面板上下文的同时执行这些任务。

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

  • 标题
  • URL
  • 在新标签页打开
  • 一键点击 - 单击即可打开数据链接。一次只能有一个数据链接启用一键点击。

对于每个操作，定义以下 API 调用设置

选项描述
标题在 UI 中显示的操作的人类可读标签。
确认消息描述性提示，用于确认或取消操作。
方法从 POST、PUT 或 GET 中选择。
URL请求 URL。

要添加变量，请点击 URL 字段并输入 $ 或按下 Ctrl+Space 或 Cmd+Space 查看可用变量列表。

查询参数键和值对。点击 + 图标添加任意数量的键/值对。
头部由键和值对以及Content-Type组成。

点击 + 图标添加任意数量的键/值对。

内容类型从以下选项中选择：application/json、text/plain、application/XML 和 application/x-www-form-urlencoded。
主体请求的主体。

要了解更多信息，请参阅配置数据链接和操作。

值映射

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

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

  • 条件 - 选择要映射到显示文本和（可选）颜色的内容
    • 值 - 特定值
    • 范围 - 数值范围
    • Regex - 正则表达式
    • 特殊值 - 特殊值，例如 Null、NaN（非数字）或布尔值，例如 true 和 false。
  • 显示文本
  • 颜色（可选）
  • 图标（仅限 Canvas）

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

阈值

阈值是您为指标设置的一个值或限制，当达到或超过该值或限制时，它会以视觉方式反映出来。阈值是您可以根据查询结果有条件地设置可视化样式和颜色的一种方式。

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

选项描述
值为每个阈值设置值。
阈值模式从绝对值和百分比中选择。

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

字段覆盖

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

从以下覆盖选项中选择

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

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