文档 Grafana 文档 面板和可视化 可视化 时间序列

时间序列

时间序列可视化是显示一组数据值随时间变化的默认方式。每个数据点都与一个时间戳匹配，并且此时间序列会显示为图表。该可视化可以将序列渲染为线条、点或条形，并且其功能足够丰富，可以显示几乎任何类型的时间序列数据。

时间序列可视化显示一个 x-y 图，其中 x 轴表示时间进程，y 轴表示值的幅度。此可视化非常适合显示大量定时数据点，这些数据点很难在表格或列表中进行跟踪。

如果您需要跟踪以下内容，则可以使用时间序列可视化：

• 全天的温度变化
• 您的退休账户的每日进展
• 您一年中每天慢跑的距离

配置时间序列可视化

以下视频将引导您完成时间序列可视化的创建步骤和常见自定义设置，非常适合初学者。

在 Grafana Play 中试用

借助 Grafana Play，您可以探索并了解其工作原理，通过实践示例学习，加速您的开发。此功能可以在 Grafana 中的时间序列可视化中看到。

试用

支持的数据格式

时间序列可视化需要时间序列数据——按时间排序的一系列测量值，并格式化为表格——表格中的每一行表示特定时间的一次测量。了解更多关于时间序列数据的信息。

数据集必须至少包含一个数字字段，并且在多个数字字段的情况下，每个字段都绘制为一条新线、点或条形，并在工具提示中使用字段名称进行标记。

示例 1

在以下示例中，有三个数字字段，在图表中表示为三条线：

如果时间字段未自动检测，您可能需要使用数据转换将数据转换为时间格式。

示例 2

时间序列可视化还支持多个数据集。如果所有数据集都采用正确格式，则可视化会绘制所有数据集的数字字段，并使用字段的列名对其进行标记。

Query1

Query2

示例 3

如果您想更轻松地比较不同但重叠时间范围之间的事件，可以通过在查询比较数据集时使用时间偏移来实现：

Query1

Query2

添加偏移后，生成的可视化会使数据集看起来同时发生，以便您更轻松地比较它们。

告警规则

您可以将告警规则链接到时间序列可视化，形式为标注，以观察何时触发和解除告警。此外，您可以在面板编辑器中的告警选项卡中创建告警规则。

特殊覆盖

以下覆盖可帮助您进一步优化时间序列可视化。

Transform 覆盖属性

使用图形样式 > 转换覆盖属性转换系列值，而不会影响工具提示、上下文菜单或图例中显示的值。从以下转换选项中选择：

• 常量 - 将第一个值显示为常量线。
• Y 轴负向转换 - 将结果翻转为 Y 轴上的负值。

Fill below to 覆盖属性

图形样式 > 填充到下方覆盖属性填充两个系列之间的区域。配置该属性时，选择您希望填充停止的系列。

以下示例显示了三个系列：Min、Max 和 Value。Min 和 Max 系列的线条宽度设置为 0。Max 的填充到下方覆盖设置为 Min，这会将 Max 和 Min 之间的区域填充为 Max 的线条颜色。

多个 Y 轴

在某些情况下，您可能希望显示多个 Y 轴。例如，如果您有一个数据集显示温度和湿度随时间变化，您可能希望显示两个 Y 轴，两个系列使用不同的单位。

您可以通过添加字段覆盖来配置多个 Y 轴并控制它们在可视化中的显示位置。此包含温度和湿度数据集的示例描述了如何进行配置。对您希望显示的每个 Y 轴重复这些步骤。

配置选项

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

面板选项

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

工具提示选项

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

工具提示模式

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

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

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

值排序顺序

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

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

悬停距离

设置悬停距离（以像素为单位），以控制光标必须离数据点多近才能触发工具提示显示。

图例选项

图例选项控制图表下方或右侧显示的系列名称和统计信息。有关图例的更多信息，请参阅配置图例。

坐标轴选项

坐标轴部分下的选项控制 x 轴和 y 轴的渲染方式。某些选项直到您点击正在编辑的字段选项框外部才会生效。您也可以按 Enter。

位置

选择 Y 轴的位置。从以下选项中选择：

• 自动 - 自动为系列分配 Y 轴。当存在两个或多个具有不同单位的系列时，Grafana 将左侧轴分配给第一个单位，右侧轴分配给随后的单位。
• 左侧 - 将所有 Y 轴显示在左侧。
• 右侧 - 将所有 Y 轴显示在右侧。
• 隐藏 - 隐藏所有坐标轴。要选择性隐藏坐标轴，请添加定位特定字段的字段覆盖。

比例

设置 Y 轴值的比例。从以下选项中选择：

• 线性 - 将比例分成等份。
• 对数 - 使用对数比例。选择此选项时，将出现一个列表供您选择二进制（以 2 为底）或常用（以 10 为底）对数比例。
• 对称对数 - 使用对称对数比例。选择此选项时，将出现一个列表供您选择二进制（以 2 为底）或常用（以 10 为底）对数比例。线性阈值选项允许您设置比例从线性变为对数的阈值。

软最小值和软最大值

为更好地控制 Y 轴限制设置软最小值或软最大值选项。默认情况下，Grafana 根据数据集自动设置 Y 轴的范围。

软最小值和软最大值设置可以防止当数据大部分平坦时，数据的微小变化被放大。相反，硬最小值和最大值有助于防止通过裁剪超出特定点的间歇性峰值而掩盖数据中有用的细节。

要定义 Y 轴的硬限制，请设置标准最小值/最大值选项。更多信息，请参阅配置标准选项。

图形样式选项

图形样式部分下的选项允许您控制图表的一般外观，不包括颜色。

样式

选择将时间序列数据显示为线条、条形或点。您可以使用覆盖在同一图表中组合多种样式。从以下选项中选择：

线条插值

选择图表如何插值系列线：

• 线性 - 点通过直线连接。
• 平滑 - 点通过平滑点之间过渡的曲线连接。
• 步进前 - 线条显示为点之间的步进。点在步进结束时渲染。
• 步进后 - 线条显示为点之间的步进。点在步进开始时渲染。

线条宽度

使用线条宽度滑块设置系列线的粗细或条形的轮廓。

填充不透明度

使用填充不透明度滑块设置系列区域填充颜色。

渐变模式

选择渐变模式来控制渐变填充，该填充基于系列颜色。要更改颜色，请使用标准配色方案字段选项。更多信息，请参阅配色方案。

• 无 - 无渐变填充。这是默认设置。
• 不透明度 - 不透明度渐变，填充的不透明度随着 Y 轴值的增加而增加。
• 色调 - 基于系列颜色的微妙渐变。
• 方案 - 由您的配色方案定义的颜色渐变。此设置用于填充区域和线条。更多信息，请参阅方案渐变模式。

渐变外观受填充不透明度设置的影响。下图显示填充不透明度设置为 50。

方案渐变模式

图形样式部分下的渐变模式选项有一个称为方案的模式。启用方案后，线条或条形会获得从所选配色方案定义的渐变颜色。

来自阈值

如果配色方案设置为来自阈值（按值），并且渐变模式设置为方案，则线条或条形颜色会在跨越定义的阈值时发生变化。

渐变配色方案

下图显示了一个折线图，选中了绿-黄-红（按值）配色方案选项。

线条样式

选择实线、虚线或点线样式：

• 实线 - 显示实线。这是默认设置。
• 虚线 - 显示虚线。选择此选项时，将出现一个列表，供您选择线段的长度和间隔（长度、间隔）。默认的虚线间隔为 10, 10。
• 点线 - 显示点线。选择此选项时，将出现一个列表，供您选择点间距的间隔（长度 = 0，间隔）。默认的点间距为 0, 10。

连接空值

选择图表上如何显示空值（即数据中的空白）。可以将空值连接起来形成连续线，或设置一个阈值，超出该阈值的数据中的空白将不再连接。

• 从不 - 数据中有空白的时间序列数据点永不连接。
• 总是 - 数据中有空白的时间序列数据点总是连接。
• 阈值 - 指定一个阈值，超出该阈值的数据中的空白将不再连接。当数据中连接的空白具有已知大小和/或在已知范围内，而超出此范围的空白不应再连接时，此设置会很有用。

断开值

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

• 从不 - 数据中的时间序列数据点永不断开连接。
• 阈值 - 指定一个阈值，超出该阈值的数据中的值将断开连接。当数据中的期望值具有已知大小和/或在已知范围内，而超出此范围的值不应再连接时，此设置会很有用。

要更改颜色，请使用标准配色方案字段选项。

显示点

设置是否将数据点显示为线或条形。选择以下选项：

• 自动 - Grafana 根据数据密度确定点的可见性。如果密度较低，则会显示点。
• 总是 - 无论数据集的密度如何，都显示点。
• 从不 - 不显示点。

堆叠系列

设置 Grafana 是堆叠还是将系列彼此叠加显示。使用堆叠时请谨慎，因为它可能会创建误导性的图表。要详细了解为什么堆叠可能不是最佳方法，请参阅堆叠的问题。选择以下选项：

• 关闭 - 关闭系列堆叠。当设为关闭时，所有系列在可视化中共享同一空间。
• 正常 - 将系列彼此堆叠。
• 100% - 按百分比堆叠，所有系列总计为 100%。

按组堆叠系列

堆叠组选项仅作为覆盖项提供。有关创建覆盖项的更多信息，请参阅配置字段覆盖。

1. 编辑面板并点击覆盖项。

2. 为堆叠系列选项创建字段覆盖。

3. 在堆叠模式下，点击正常。

4. 命名您希望系列显示在其中的堆叠组。

   堆叠组名称选项仅在创建覆盖项时可用。

条形对齐

设置条形相对于数据点的位置。在下面的示例中，显示点设置为总是，这使得更容易看到此设置带来的差异。点本身不会改变，但条形与点的关系会改变。选择以下选项：

• 之前 条形绘制在点之前。点位于条形的后角。
• 居中 条形绘制在点周围。点位于条形的中心。这是默认设置。
• 之后 条形绘制在点之后。点位于条形的前角。

标准选项

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

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

数据链接和操作

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

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

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

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

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

值映射

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

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

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

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

阈值

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

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

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

字段覆盖

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

选择以下覆盖选项

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