[comment]: # ({364afe17-6fe0d1f1})
# 6 仪表盘指示器

[comment]: # ({/364afe17-6fe0d1f1})

[comment]: # ({4c03826a-822e017f})
#### 概述

*Gauge* 小部件将单个数值型监控项的值以仪表盘形式显示。
它适用于持续关注重要指标、可视化阈值以及检测突发变化。

![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/gauge_styles.png){width="600"}

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

-   监控项描述（Used space: {ITEM.LASTVALUE}, Temperature）
-   监控项值和单位（21 %, 18.7 °C, 1.2 bar）
-   仪表盘刻度（1GB/24GB/28GB/32GB, -50/-40/-30/etc.）
-   仪表盘弧线（仪表盘数值弧线和仪表盘阈值弧线）
-   仪表盘指针

单击该小部件会为该监控项打开一个[简单图形](/manual/config/visualization/graphs/simple)。

通过在[小部件菜单](/manual/web_interface/frontend_sections/dashboards#widget-menu)中选择*Download image*选项，可以将 *Gauge* 小部件中显示的信息下载为 PNG 图像。

[comment]: # ({/4c03826a-822e017f})

[comment]: # ({30857b45-3aa15745})
#### 配置

要进行配置，请选择 *Gauge* 作为类型：

![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/gauge_configuration.png){width="600"}

除了所有部件通用的[常见](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters)参数外，您还可以设置以下特定选项：

|   |   |
|--|--------|
|*Item*|选择监控项。<br>或者，选择一个兼容的部件作为监控项的[数据源](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters)。<br>此字段支持自动补全，因此开始输入监控项名称时，将显示包含匹配监控项的下拉列表。<br>请注意，您只能选择返回[数值型](/manual/config/items/item#configuration)数据的监控项（二进制数据除外）。|
|*Min*|输入仪表的最小值。<br>支持[后缀](/manual/appendix/suffixes)（例如 "1d"、"2w"、"4K"、"8G"）。支持[值映射](/manual/config/items/mapping)。|
|*Max*|输入仪表的最大值。<br>支持[后缀](/manual/appendix/suffixes)（例如 "1d"、"2w"、"4K"、"8G"）。支持[值映射](/manual/config/items/mapping)。|
|*Colors*|从颜色选择器中选择颜色：<br>**Value arc** - 选择仪表值弧的颜色；<br>**Arc background** - 选择仪表值弧和仪表阈值弧的背景颜色；<br>**Background** - 选择部件背景颜色。<br><br>“D”表示默认颜色，该颜色取决于前端主题。如果设置了[*Thresholds*](#advanced-configuration)，则 **Value arc** 的默认颜色取决于阈值颜色。要恢复为默认颜色，请单击颜色选择器中的 *Use default* 按钮。|
|*Show*|勾选复选框以显示相应的仪表元素——描述、值、值弧、指针、刻度（仪表弧起始和结束位置的最小值和最大值）。取消勾选则隐藏。必须至少选择一个元素。<br><br>请注意，只有在显示仪表值弧或仪表阈值弧（请参见[高级配置](#advanced-configuration)选项）时，才能显示仪表指针和刻度。另请注意，如果显示仪表指针，则值显示在指针下方；如果隐藏指针，则值与仪表弧底部对齐。|
|*Override host*|选择一个兼容的部件或仪表板[主机选择器](/manual/web_interface/time_period_selector#host-selector)作为主机的[数据源](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters)。<br>在[模板仪表板](/manual/config/templates/template#adding-dashboards)上配置该部件时，此参数不可用。|
|*Advanced configuration*|单击 *Advanced configuration* 标题以显示[高级配置](#advanced-configuration)选项。您还可以在此调整 *Show* 字段中选择的仪表元素。|

[comment]: # ({/30857b45-3aa15745})

[comment]: # ({0ace07fa-139a1aaa})
##### 高级配置

在可折叠的 *高级配置* 中提供了高级配置选项：

![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/gauge_advanced_configuration.png){width="600"}

| | |
|--|--------|
|*角度*|选择仪表角度（180° 或 270°）。|
|***说明***|<|
|*说明*|输入监控项说明。此说明可能会覆盖默认监控项名称。<br>支持多行说明。可以结合使用文本和支持的宏。<br>支持 {HOST.\*}、{ITEM.\*}、{INVENTORY.\*} 和用户宏。|
|*大小*|输入监控项描述的字体大小高度（以百分比表示，相对于组件总高度）。|
|*垂直位置*|选择监控项描述的垂直位置（顶部或底部，相对于仪表弧）。|
|*粗体*|选中复选框以粗体显示监控项描述。|
|*颜色*|从颜色选择器中选择监控项描述颜色。<br>“D”代表默认颜色，取决于前端主题。要返回默认颜色，请单击颜色选择器中的*使用默认*按钮。|
|***值***|<|
|*小数位数*|输入要与值一起显示的小数位数。<br>此选项仅影响返回[数字（浮点数）]（/manual/config/items/item#configuration）数据的监控项。|
|*大小*|输入值的字体大小高度（以百分比表示，相对于仪表弧高度）。|
|*粗体*|选中复选框以粗体显示值。|
|*颜色*|从颜色选择器中选择值颜色。<br>“D”代表默认颜色，取决于前端主题。要返回默认颜色，请单击颜色选择器中的*使用默认*按钮。|
|***单位***|<|
|*单位*|选中复选框以显示监控项值的单位。<br>如果输入单位名称，它将覆盖[监控项配置](/manual/config/items/item#configuration)中设置的单位。|
|*大小*|输入监控项单位的字体大小高度（以百分比表示，相对于仪表弧高度）。|
|*粗体*|选中复选框以粗体显示监控项单位。|
|*位置*|选择监控项单位的位置（相对于监控项值的上方、下方、前方或后方）。<br>对于以下[时间相关单位](/manual/config/items/item#configuration)，此选项将被忽略：UNIX时间、运行时间、s。|
|*颜色*|从颜色选择器中选择监控项单位颜色。<br>“D”代表默认颜色，取决于前端主题。要返回默认颜色，请单击颜色选择器中的*使用默认*按钮。|
|***值弧***|<|
|*弧大小*|输入仪表值弧的大小高度（以百分比表示，相对于仪表弧半径）。|
|***针***|<|
|*颜色*|从颜色选择器中选择仪表针颜色。<br>“D”代表默认颜色，取决于前端主题。如果设置了*阈值*，则针的默认颜色取决于阈值颜色。要返回默认颜色，请单击颜色选择器中的*使用默认*按钮。|
|***比例***|<|
|*显示单位*|选中复选框以显示仪表最小值和最大值的单位。|
|*大小*|输入仪表最小值和最大值的字体大小高度（以百分比表示，相对于仪表弧高度）。|
|*小数位数*|输入仪表最小值和最大值显示的小数位数。<br>此选项仅影响返回 [数字（浮点数）](/manual/config/items/item#configuration) 数据的监控项。|
|***阈值***|<|
|*阈值*|单击“*添加*”可添加阈值，从颜色选择器中选择阈值颜色，然后指定数值。<br>保存时，阈值列表将按升序排列。<br>请注意，配置为阈值的颜色仅对数字监控项才会正确显示。<br>支持[后缀](/manual/appendix/suffixes)（例如，“1d”、“2w”、“4K”、“8G”）。支持 [值映射](/manual/config/items/mapping)。|
|*显示标签*|勾选复选框以将阈值显示为仪表刻度上的标签。|
|*显示圆弧*|勾选复选框以显示仪表阈值圆弧。|
|*圆弧大小*|输入仪表阈值圆弧的大小高度（以百分比表示，相对于仪表圆弧半径）。|

[comment]: # ({/0ace07fa-139a1aaa})
