8 图形

概述

图形小部件提供了一种现代且灵活的方式，通过矢量图像绘制技术来可视化 Zabbix 收集的数据。 自 Zabbix 4.0 起支持此图形小部件。请注意，Zabbix 4.0 之前支持的图形小部件仍可作为 Graph (classic) 使用。 另请参阅 Dashboards 页面中的 Adding widgets 部分，以了解更多详细信息。

在 小部件菜单 中选择 Download image 选项后，Graph 小部件中显示的信息可以下载为 PNG 图像。

配置

要配置，请选择 图表 作为类型：

数据集

数据集 选项卡允许通过添加数据集来选择图表的数据。 可以添加两种类型的数据集：

  • 监控项模式 - 显示匹配监控项的数据。您可以选择单一基础颜色，或选择调色板行，为每个匹配的监控项分配不同颜色。
  • 监控项列表 - 显示所选监控项的数据。您可以在颜色选择器中单独为每个监控项选择颜色。

默认会添加一个 监控项模式 数据集。
数据集 对于 监控项模式 数据集：
选择或输入主机和监控项模式；匹配这些模式的监控项数据将显示在图表上；最多可显示 50 个监控项。
可使用通配符模式进行选择（例如，* 将返回匹配零个或多个字符的结果）。
要指定通配符模式，请手动输入字符串并按 Enter。
通配符符号始终会被解释，因此例如在存在其他匹配监控项（如 item2、item3）时，无法单独添加名为 item* 的监控项。
对于“监控项模式”数据集，必须指定主机和监控项模式。
另请参见：数据集配置详情。

对于 监控项列表 数据集：
通过单击 添加监控项 按钮选择图表的监控项。
您也可以通过单击 添加 widget 按钮，选择兼容的 widget 作为监控项的数据源。
对于“监控项列表”数据集，必须指定监控项或 widget。
另请参见：数据集配置详情。

请注意，只允许数值型监控项类型。

在 模板仪表板 上配置 widget 时，用于指定主机模式的参数不可用，而用于指定监控项列表的参数只能选择在模板上配置的监控项。
绘制 选择指标的绘制类型。
可选绘制类型：Line（默认）、Points、Staircase 和 Bar。
请注意，如果线形/阶梯图中只有一个数据点，则无论绘制类型如何，都会将其绘制为点。点大小根据线宽计算，但即使线宽更小，也不能小于 3 像素。
Stacked 勾选此复选框可将数据显示为堆叠形式（显示填充区域）。
选择 Points 绘制类型时，此选项不可用。
Width 设置线宽。
选择 Line 或 Staircase 绘制类型时，此选项可用。
Point size 设置点大小。
选择 Points 绘制类型时，此选项可用。
Transparency 设置透明度级别。
Fill 设置填充级别。
选择 Line 或 Staircase 绘制类型时，此选项可用。
Missing data 选择缺失数据的显示方式：
None - 保持空白间隙；
Connected - 连接两个边界值；
Treat as 0 - 将缺失数据显示为 0 值；
Last known - 将缺失数据显示为与最后已知值相同的值；不适用于 Points 和 Bar 绘制类型。
Override host 选择兼容的 widget 或仪表板作为主机的数据源。
在 模板仪表板 上配置 widget 时，此参数不可用。
Y-axis 选择 Y 轴在图表中显示的侧边。
Time shift 如有需要，请指定时间偏移。
此字段可使用时间后缀。允许使用负值。
Aggregation function 指定在所选 Aggregation interval 内对每个监控项或整个数据集使用的聚合函数：
min - 显示最小值；
max - 显示最大值；
avg - 显示平均值；
sum - 显示总和；
count - 显示数量；
first - 显示第一个值；
last - 显示最后一个值。
如果选择 not used，则显示所有值（不进行聚合）。

只有数值型数据才能用于 min、max、avg 和 sum。对于 count，非数值数据将转换为数值。
另请参见：图表中的聚合。
Aggregation interval 指定聚合值的时间间隔。
此字段可使用时间后缀。不带后缀的数值将视为秒。

请注意，如果 widget 配置为基于趋势显示历史数据（History data selection 设置为 Trends 或 Auto），建议使用 1 小时的整数倍作为聚合间隔（例如 3600、60m、1h、3h 等）。趋势会存储按小时聚合的值，因此使用不是 1 小时整数倍的聚合间隔（例如 100s、7min、15min、90min 等）可能会导致结果难以解释。
Aggregate 指定是否进行聚合：
Each item - 数据集中的每个监控项都会分别聚合并单独显示；
Data set - 所有数据集监控项将聚合并显示为一个值。
Approximation 指定当每个垂直图表像素对应多个值时显示哪个值：
all - 显示最小值、最大值和平均值；
min - 显示最小值；
max - 显示最大值；
avg - 显示平均值。

此设置在显示较长时间范围且更新间隔较短的图表时很有用（例如，每 10 分钟采集一次、持续一年的数据）。
Data set label 指定显示在图表 数据集 配置和图表 图例 中的数据集标签（适用于聚合数据集）。
所有数据集都会编号，包括那些已指定 Data set label 的数据集。如果未指定标签，系统将根据编号自动为数据集命名（例如 "Data set #2"、"Data set #3" 等）。在重新排序/拖动数据集后，数据集编号会重新计算。
过长的数据集标签会被截断以适应显示位置（例如 "Number of proc..."）。
数据集配置详情

现有数据集以列表形式显示。您可以：

  • 点击 移动图标，并将数据集拖动到列表中的新位置。
  • 点击 展开图标以展开数据集详情。展开后，此图标会变为 折叠图标。
  • 点击 颜色图标以打开选择器。您可以输入十六进制代码，选择纯色样本，或切换到 Palette 选项卡并选择一行预定义颜色。所选颜色会直接应用于 Item list 数据集，或作为 Item patterns 中生成色阶的基础。使用 Tab 在对话框控件之间移动，使用方向键浏览色块或调色板行，按 Enter 进行选择，按 Esc 取消。
  • 点击 Add new data set 按钮以添加一个空的数据集，从而可以选择主机和监控项模式。 如果您点击 Add new data set 按钮旁边的向下箭头图标，会出现一个下拉菜单，允许您添加新的 Item patterns 或 Item list 数据集，或者克隆当前打开的数据集。如果所有数据集都已折叠，则 Clone 选项不可用。

监控项模式数据集包含 主机模式 和 监控项模式 字段，这两个字段都可识别完整名称或包含通配符（*）的模式。 此功能允许您选择所有包含所选模式的主机名和监控项名称。 在 监控项模式 字段中输入监控项名称或监控项模式时，下拉列表中仅显示属于所选主机名的监控项。

例如，在 主机模式 字段中输入模式 z* 后，下拉列表会显示所有包含该模式的主机名：z*、Zabbix server、Zabbix proxy。 按下 Enter 后，该模式会被接受并显示为 z*。 类似地，在 监控项模式 字段中输入模式 a* 后，下拉列表会显示所有包含该模式的监控项名称：a*、Available memory、Available memory in %。

按下 Enter 后，该模式会被接受并显示为 **a***。

随后，图形将显示属于所选主机名的所有监控项。

Item list 数据集包含 Add item 按钮，您可以通过它添加要显示在图表上的监控项。
您还可以通过单击 Add widget 按钮，将兼容的小部件添加为监控项的 data source。

例如，单击 Add item 按钮会打开一个包含 Host 参数的弹出窗口。
选择主机后，会以列表形式显示该主机所有可供选择的监控项。

选择一个或多个监控项后，它们将显示在数据集监控项列表和图表中。

图表中的聚合

聚合允许显示在指定时间间隔（5 分钟、1 小时、1 天等）内的聚合值（最小值、最大值、平均值等），而不是显示所有单独的值。 在一个数据集中，聚合既可以分别应用于每个监控项，也可以应用于整个数据集。

聚合功能的一些使用场景如下：

  • 每天 Nginx 服务器的平均请求数。
  • 每周各集群中最低的磁盘空间。

在下面的示例中，"max" 聚合函数应用于时间间隔为 5 分钟的监控项：

该示例展示了 5 分钟内的最大 CPU 负载（由 1 分钟平均值聚合而来），并与 5 分钟内的平均 CPU 负载进行比较。

当为图例选择 显示聚合函数 时，监控项会以括号显示，并在图例和工具提示中以前缀形式显示聚合函数。 如果为图表指定了 数据集标签，则该标签会以括号显示，并以前缀形式显示聚合函数。

显示选项

显示选项 选项卡允许定义历史数据选择：
历史数据选择 设置图形数据来源：
Auto - 数据根据经典图形 算法 获取（默认）；
History - 来自历史数据；
Trends - 来自趋势数据。
简单触发器 勾选此复选框可显示简单触发器的触发器阈值。阈值将使用触发器严重性颜色绘制为虚线。
简单触发器是指在表达式中针对一个监控项仅包含一个函数（仅 last、max、min、avg）的触发器。
最多可绘制三个触发器。请注意，触发器必须位于绘制范围内才可见。
工作时间 勾选此复选框可在图形上显示工作时间。工作时间（工作日）在图形中显示为白色背景，而非工作时间显示为灰色（使用 Original blue 默认前端主题时）。
百分位线（左） 勾选此复选框并输入百分位值，可在图形左侧 Y 轴上显示指定百分位的线。
例如，如果设置为 95% 百分位，则百分位线将位于 95% 的值落在其下方的位置。
百分位线（右） 勾选此复选框并输入百分位值，可在图形右侧 Y 轴上显示指定百分位的线。
例如，如果设置为 95% 百分位，则百分位线将位于 95% 的值落在其下方的位置。

时间段

时间段 选项卡允许设置在图表中显示数据的时间段：
时间段 选择该时间段的数据源：
Dashboard - 将 Time period 选择器设为数据源；
Widget - 将 Widget 参数中指定的兼容 widget 设为数据源；
Custom - 将 From 和 To 参数中指定的时间段设为数据源；如果设置了该项，widget 右上角将显示一个时钟图标，鼠标悬停时会显示所设置的时间。
Widget 输入或选择一个兼容的 widget 作为该时间段的数据源。
当 Time period 设置为 "Widget" 时，此参数可用。
From 输入或选择时间段的开始时间。
支持相对时间语法（now、now/d、now/w-1w 等）。
当 Time period 设置为 "Custom" 时，此参数可用。
To 输入或选择时间段的结束时间。
支持相对时间语法（now、now/d、now/w-1w 等）。
当 Time period 设置为 "Custom" 时，此参数可用。

坐标轴

坐标轴选项卡允许自定义坐标轴的显示方式：
左 Y 勾选此复选框可显示左侧 Y 轴。
如果在数据集或覆盖选项卡中未选中，此复选框可能会被禁用。
右 Y 勾选此复选框可显示右侧 Y 轴。
如果在数据集或覆盖选项卡中未选中，此复选框可能会被禁用。
X 轴 取消勾选此复选框可隐藏 X 轴（默认选中）。
刻度 从下拉列表中选择图表坐标轴值的刻度：
线性 - 坐标轴值按固定增量递增（例如 10、20、30），适用于变化平稳或范围较小到中等的数据；
对数 - 坐标轴值按指数方式递增（例如 10、100、1000），适用于变化快速或范围较大的数据。
最小值 设置相应坐标轴的最小值。
指定 Y 轴可见范围的最小值。
最大值 设置相应坐标轴的最大值。
指定 Y 轴可见范围的最大值。
单位 从下拉列表中选择图表坐标轴值的单位：
自动 - 坐标轴值使用数据集中第一个监控项的单位显示；
静态 - 坐标轴值使用值输入字段中指定的单位显示；如果该字段留空，则仅显示数值。

图例

图例选项卡允许自定义图表图例：
显示图例 取消勾选此复选框可隐藏图表上的图例（默认勾选）.
显示最小值/平均值/最大值 勾选此复选框可显示图例中项目的最小值,平均值和最大值.
显示聚合函数 勾选此复选框可在图例中显示聚合函数.
行数 选择图例行的显示模式：
固定 - 显示的行数由行数参数值决定;
可变 - 显示的行数由配置项的数量决定,但不超过最大行数参数值.
行数/
最大行数		 若行数设置为“固定”,则设置要显示的图例行数（1-10）.
若行数设置为“可变”,则设置要显示的最大图例行数（1-10）.
列数 设置要显示的图例列数（1-4）.
若显示最小值/平均值/最大值未勾选,则此参数可用.

问题

问题 选项卡允许自定义问题显示：
显示问题 勾选此复选框以启用在图表上显示问题（默认未勾选，即已禁用）。
仅所选监控项 勾选此复选框后，仅在图表上显示所选监控项的问题。
问题主机 选择要在图表上显示的问题主机。

可使用通配符模式（例如，* 将返回匹配零个或多个字符的结果）。
要指定通配符模式，只需手动输入字符串并按 Enter。
在输入时，请注意下拉列表中会显示所有匹配的主机。

在 模板仪表板 上配置小部件时，此参数不可用。
严重性 勾选问题严重性以筛选要在图表上显示的问题。
如果未勾选任何严重性，将显示所有问题。
问题 指定要在图表上显示的问题名称。
问题标签 指定问题标签以限制小部件中显示的问题数量。
可以包含或排除特定标签及标签值。可设置多个条件。标签名称匹配始终区分大小写。

每个条件都有以下几种可用运算符：
存在 - 包含指定的标签名称；
等于 - 包含指定的标签名称和值（区分大小写）；
包含 - 包含标签值中含有输入字符串的指定标签名称（子字符串匹配，不区分大小写）；
不存在 - 排除指定的标签名称；
不等于 - 排除指定的标签名称和值（区分大小写）；
不包含 - 排除标签值中含有输入字符串的指定标签名称（子字符串匹配，不区分大小写）。

条件有两种计算类型：
与/或 - 必须满足所有条件，具有相同标签名称的条件将按 或 条件分组；
或 - 满足任一条件即可。

覆盖

覆盖 选项卡允许为数据集添加自定义覆盖：

当使用 * 通配符为一个数据集选择了多个监控项，并且您希望更改这些监控项的默认显示方式时，覆盖非常有用（例如默认基础颜色或其他任何属性）。

现有的覆盖（如果有）会以列表形式显示。要添加新的覆盖：

  • 单击 按钮
  • 选择用于覆盖的主机和监控项。或者，您也可以输入主机和监控项模式。可以使用通配符模式（例如，* 将返回匹配零个或多个字符的结果）。要指定通配符模式，只需手动输入字符串并按 Enter。在输入时，请注意所有匹配的主机都会显示在下拉列表中。通配符符号始终会被解释，因此例如在存在其他匹配项（如 item2、item3）时，无法单独添加名为 "item*" 的监控项。主机模式和监控项模式参数是必填的。 在配置 模板仪表板 上的小部件时，用于指定主机模式的参数不可用。 在配置 模板仪表板 上的小部件时，用于指定监控项列表的参数只能选择模板上配置的监控项。
  • 单击 ， 以选择覆盖参数。至少应选择一个覆盖参数。有关参数说明，请参见上面的 数据集 选项卡。