文档 Grafana 文档 面板和可视化 可视化 状态时间线

状态时间线

状态时间线可视化以显示随时间推移的状态变化的方式显示数据。在状态时间线中，数据以一系列条或带的形式呈现，这些条或带称为 状态区域。状态区域可以带值或不带值进行渲染，区域长度表示在给定时间范围内的状态持续时间或频率。

例如，如果您正在监控服务器的 CPU 使用率，可以使用状态时间线来可视化随时间推移的不同状态，例如“LOW”、“NORMAL”、“HIGH”或“CRITICAL”。每个状态由不同的颜色表示，长度表示服务器保持在该状态的时间长度。

状态时间线可视化在需要监控和分析各种实体随时间推移的状态变化时非常有用。您可以在以下情况下使用它：

• 监控服务器、应用或服务的状态，以了解您的基础设施何时出现问题。
• 识别随时间推移的操作趋势。
• 发现应用健康状况中的任何周期性问题。

配置状态时间线

使用 Grafana Play 试试看

使用 Grafana Play，您可以探索并了解其工作原理，从实际示例中学习以加速您的开发。此功能可在 Grafana 状态时间线和状态历史中看到。

试试看

支持的数据格式

如果您有捕获实体随时间推移的各种状态的数据，并格式化为表格，状态时间线可视化效果最佳。数据必须包含：

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

每个状态在下一个状态开始或出现 null 值时结束。

示例 1

以下示例只有一个时间列，包含 null 值

数据转换为如下形式，null 和空值可视化为空隙在状态时间线中

示例 2

以下示例有两个时间列，不包含任何 null 值

数据转换为如下形式

如果您的查询结果不是像上面示例那样的表格格式，尤其是对于时间序列数据，您可以应用特定的转换来达到目的。

时间序列数据

您也可以使用时间序列数据创建状态时间线可视化。为此，请添加阈值，将时间序列转换为离散的彩色状态区域。

配置选项

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

面板选项

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

状态时间线选项

使用这些选项微调可视化。

页面大小 (启用分页)

页面大小选项允许您对状态时间线可视化进行分页，以限制一次可见的序列数。当序列很多时此功能很有用。分页结果时，可视化在每页上显示所有序列的一个子集。

连接 null 值

选择 null 值（即数据中的空隙）在图表上如何显示。Null 值可以连接形成连续的线条，或设置为一个阈值，超过该阈值数据中的空隙将不再连接。

• 从不 - 数据中存在空隙的时间序列数据点永远不会连接。
• 始终 - 数据中存在空隙的时间序列数据点始终连接。
• 阈值 - 指定一个阈值，超过该阈值数据中的空隙将不再连接。当数据中连接的空隙大小已知且/或在已知范围内，而超出此范围的空隙不应再连接时，此功能很有用。

断开值

选择是否设置一个阈值，超过该阈值的数据中的值应该断开。

• 从不 - 数据中的时间序列数据点永远不会断开。
• 阈值 - 指定一个阈值，超过该阈值数据中的值将断开。当数据中的所需值大小已知且/或在已知范围内，而超出此范围的值不应再连接时，此功能很有用。

图例选项

启用图例选项后，它可以显示值映射或阈值范围。要在图例中显示值映射，重要的是颜色方案中引用的颜色方案设置为单色或经典调色板。要查看图例中的阈值范围，请将颜色方案设置为来自阈值。

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

可见性

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

模式

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

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

位置

选择图例的显示位置。

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

宽度

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

工具提示选项

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

工具提示模式

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

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

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

值排序顺序

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

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

坐标轴选项

标准选项

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

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

数据链接和操作

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

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

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

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

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

值映射

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

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

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

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

阈值

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

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

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

字段覆盖

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

从以下覆盖选项中选择：

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