18 监控项值

概述

监控项值 小组件显示单个数值型或字符串型监控项的值。 它适用于关注重要指标、可视化阈值以及检测数据中的突发变化。

您可以将该小组件配置为显示以下内容：

  • 指标时间戳（2024-11-21 09:57:30）
  • 监控项描述（1 分钟平均负载、agent 状态）
  • 监控项值、变化指示器和单位（0.47 ↓、99 ↑ Mbps）
  • 背景颜色
  • 指定时间段内数值的迷你趋势图

单击该小组件会打开数值型监控项的临时图形，或字符串型监控项的最新数据。

配置

要进行配置，请选择 监控项值 作为小部件类型：

除了所有小部件通用的参数外，您还可以设置以下特定选项：
监控项 选择监控项。
或者，选择一个兼容的小部件作为监控项的数据源。
不支持返回二进制数据的监控项。
显示 勾选复选框以显示相应元素：描述、值、时间、变化指示器、迷你图。取消勾选则隐藏。至少必须选择一个元素。
覆盖主机 选择一个兼容的小部件或仪表板主机选择器作为主机的数据源。
在模板仪表板上配置该小部件时，此参数不可用。
高级配置 单击 高级配置 标签以显示高级配置选项。

高级配置

可折叠的高级配置部分中提供了高级配置选项， 并且仅适用于在显示字段中选定的那些元素（见上文）。

请注意，多个元素不能占用同一空间；如果它们被放置在同一空间中，将显示错误消息。

通用小部件参数

这些参数用于确定整个小部件的背景颜色（静态或动态）以及用于显示值的聚合函数。
背景颜色 从颜色选择器中为整个小部件选择背景颜色。
D 表示默认颜色（取决于前端主题）。要恢复默认值，请点击颜色选择器中的 Use default 按钮。
阈值 为整个小部件配置动态背景颜色。点击 Add 添加阈值，从颜色选择器中选择背景颜色，并指定一个数值。一旦监控项值等于或大于阈值，背景颜色将发生变化。
保存后，列表将按升序排序。
请注意，动态背景颜色仅对数值型监控项正确显示。
聚合函数 指定要使用的聚合函数：
min - 显示最小值；
max - 显示最大值；
avg - 显示平均值；
count - 显示值的数量；
sum - 显示值的总和；
first - 显示第一个值；
last - 显示最后一个值；
not used - 显示最近的值（不进行聚合）。

聚合可用于显示所选时间间隔（5 分钟、1 小时、1 天）的聚合值，而不是最近的值。
min、max、avg 和 sum 仅可显示数值数据。对于 count，非数值数据将被转换为数值。
时间段 用于聚合值的时间段。为时间段选择数据源：
Dashboard - 使用仪表板的时间段选择器；
Widget - 使用兼容的小部件（在 Widget 参数中设置）；
Custom - 使用在 From 和 To 参数中设置的自定义时间段；如果已设置，小部件右上角将显示一个时钟图标，鼠标悬停时会提示所设置的时间。
请注意，无论小部件的 Time period 如何配置，兼容的小部件仍可将其用作时间段的数据源。
如果 Aggregation function 设置为 "not used"，则此参数不可用。
Widget 输入或选择一个兼容的小部件，作为时间段的数据源。
如果 Time period 设置为 "Widget"，则此参数可用。
From 输入或选择时间段的开始时间。
支持相对时间语法（now、now/d、now/w-1w 等）。
如果 Time period 设置为 "Custom"，则此参数可用。
To 输入或选择时间段的结束时间。
支持相对时间语法（now、now/d、now/w-1w 等）。
如果 Time period 设置为 "Custom"，则此参数可用。
历史数据 从历史数据或趋势数据中取值：
Auto - 自动选择；
History - 使用历史数据；
Trends - 使用趋势数据。

此设置仅适用于数值数据。非数值数据始终从历史数据中获取。
描述

这些参数决定了监控项描述的显示方式。
描述 输入监控项描述。此描述可覆盖默认的监控项名称。支持多行描述。可以组合使用文本和受支持的宏。
支持 {HOST.*}、{ITEM.*}、{INVENTORY.*} 以及用户宏。
水平位置 选择监控项描述的水平位置——左、右或居中。
垂直位置 选择监控项描述的垂直位置——上、下或中间。
大小 输入监控项描述的字体高度（以相对于整个小组件高度的百分比表示）。
粗体 勾选复选框以粗体显示监控项描述。
颜色 从颜色选择器中选择监控项描述的颜色。
D 表示默认颜色（取决于前端主题）。要恢复为默认值，请在颜色选择器中单击 Use default 按钮。
值

这些参数用于确定如何显示监控项值。
小数位数 选择值显示时保留的小数位数。此值仅影响浮点型监控项。对于单位设置为“s”的监控项，如果此值大于 0（默认值为 2），部件会对最高有效时间单位进行四舍五入，并显示数值（例如“10.43m”），而不是将该值转换为完整的时间字符串。设置为 0 时，秒数将转换为人类可读的时间字符串（例如“4h 56m 30s”）。
大小 输入小数位数字体高度（相对于部件总高度的百分比）。
水平位置 选择监控项值的水平位置——左、右或居中。
垂直位置 选择监控项值的垂直位置——上、下或中间。
大小 输入监控项值的字体高度（相对于部件总高度的百分比）。
请注意，监控项值的大小具有更高优先级；其他元素必须为该值让出空间。不过对于变化指示器，如果该值过大，则会被截断以显示变化指示器。
粗体 勾选复选框以粗体显示监控项值。
颜色 从颜色选择器中选择监控项值的颜色。
D 表示默认颜色（取决于前端主题）。要恢复默认值，请在颜色选择器中单击 使用默认值 按钮。
单位
单位 勾选复选框以在监控项值旁显示单位。如果输入单位名称，它将覆盖监控项配置中的单位。
位置 选择监控项单位的位置——位于值的上方、下方、前面或后面。
大小 输入监控项单位的字体高度（相对于部件总高度的百分比）。
粗体 勾选复选框以粗体显示监控项单位。
颜色 从颜色选择器中选择监控项单位的颜色。
D 表示默认颜色（取决于前端主题）。要恢复默认值，请在颜色选择器中单击 使用默认值 按钮。
时间

这些参数用于确定时间（来自监控项历史记录的时钟值）的显示方式。
Horizontal position 选择时间的水平位置——左、右或居中。
Vertical position 选择时间的垂直位置——上、下或中间。
Size 输入时间的字体高度（以相对于 widget 总高度的百分比表示）。
Bold 勾选复选框以粗体显示时间。
Color 从颜色选择器中选择时间颜色。
D 表示默认颜色（取决于前端主题）。要恢复为默认值，请在颜色选择器中单击 Use default 按钮。
变化指示器

本节允许从颜色选择器中选择变化指示器的颜色。

变化指示器如下：

  • ↑ - 监控项值上升（适用于数值型监控项）
  • ↓ - 监控项值下降（适用于数值型监控项）
  • ↕ - 监控项值已变化（适用于字符串监控项和具有值映射的监控项）

注意：

  • 如果只有一个值，则不会显示上升 (↑) 和下降 (↓) 指示器。
  • 值始终在相同范围内进行比较；例如：
    • 最新值与前一个值进行比较。
    • 月值与前一个月进行比较。
    • 对于聚合，前一个周期与所选周期持续时间相同，并且结束于所选周期开始之前的紧邻时刻。

D 表示默认颜色（取决于前端主题）。要恢复为默认值，请单击颜色选择器中的 Use default 按钮。

变化指示器的垂直大小等于该值的大小（对于数值型监控项，为值的整数部分）。

迷你图

这些参数用于确定迷你图表的显示方式。
宽度 使用滑块或手动输入 0 到 10 范围内的值来设置图形线条粗细。
颜色 选择线条和填充颜色。
填充 使用滑块或手动输入 0 到 10 范围内的值来设置填充颜色透明度级别。
时间段 指定要包含在迷你图中的值的时间段。为该时间段选择数据源：
仪表板 - 使用仪表板时间段选择器；
部件 - 使用兼容的部件（在 部件 参数中设置）；
自定义 - 使用在 从 和 到 参数中设置的自定义时间段；如果已设置，部件右上角将显示一个时钟图标，鼠标悬停时会指示所设置的时间。
请注意，无论部件的 时间段 配置如何，兼容部件仍可将其用作时间段的数据源。
如果 聚合函数 设置为“未使用”，则此参数不可用。
部件 输入或选择一个兼容的部件作为时间段的数据源。
如果 时间段 设置为“部件”，则此参数可用。
从 输入或选择时间段的开始时间。
支持相对时间语法（now、now/d、now/w-1w 等）。
如果 时间段 设置为“自定义”，则此参数可用。
到 输入或选择时间段的结束时间。
支持相对时间语法（now、now/d、now/w-1w 等）。
如果 时间段 设置为“自定义”，则此参数可用。
历史数据 从历史数据或趋势数据中取值：
自动 - 自动选择；
历史 - 使用历史数据；
趋势 - 使用趋势数据。