[comment]: # ({4f11bfeb-168e8cde})
# 21 饼图
[comment]: # ({/4f11bfeb-168e8cde})
[comment]: # ({0ad6140e-5cc3e4a5})
#### 概述
*饼图* 小组件以基于矢量的饼图或环形图形式显示数值监控项数据。
此小组件可帮助您直观了解各监控项或主机对整体数据集的贡献。
| | |
|-|-|
|{width="400"}|{width="400"}|
将鼠标悬停在某个扇区上时，该扇区会展开并显示其图例；单击该扇区后，它将保持展开状态，且其图例会持续显示，直到被关闭。
*饼图* 小组件中显示的信息可通过在[小组件菜单](/manual/web_interface/frontend_sections/dashboards#widget-menu)中选择 *下载图像* 选项下载为 PNG 图像。
[comment]: # ({/0ad6140e-5cc3e4a5})
[comment]: # ({eff3502a-93b70ac4})
#### 配置
要配置，请选择 *饼图* 作为类型：
{width="600"}
[comment]: # ({/eff3502a-93b70ac4})
[comment]: # ({3ecdd5a0-013fdb30})
#### 数据集
**数据集** 选项卡允许通过添加数据集来选择饼图的数据。
可以添加两种类型的数据集：
- *监控项模式* - 显示匹配监控项的数据。
您可以选择单一基础颜色，或选择调色板行，为每个匹配的监控项分配不同颜色。
- *监控项列表* - 显示所选监控项的数据。
您可以在颜色选择器中单独为每个监控项选择颜色。
默认情况下，会添加一个 *监控项模式* 数据集。
| | | |
|-|----------|----------------------------------------|
|*数据集*|<|对于 **监控项模式** 数据集：
选择或输入主机和监控项模式；与输入模式匹配的监控项数据将显示在饼图上；最多可显示 50 个监控项。
可使用通配符模式进行选择（例如，`*` 将返回匹配零个或多个字符的结果）。
要指定通配符模式，请手动输入字符串并按 *Enter*。
通配符符号始终会被解释，因此例如当存在其他匹配监控项（如 *item2*、*item3*）时，无法单独添加名为 *item\** 的监控项。
对于“监控项模式”数据集，必须指定主机和监控项模式。
另请参见：[数据集配置详情](#data-set-configuration-details)。
对于 **监控项列表** 数据集：
单击 *Add item* 按钮选择用于饼图的监控项。
监控项名称后的 *Type* 下拉框可用于选择每个监控项的显示类型：
**Normal** - 监控项值按比例显示在饼图上（默认）；
**Total** - 监控项值占据整个饼图。请注意，每个饼图只能存在一个“Total”监控项，并且它会在饼图图例中排在第一位。如果某个监控项设置为“Total”，则 *Data set aggregation* 参数（见下文）将被禁用并设为“not used”。
您还可以通过单击 *Add widget* 按钮，将兼容的 widget 选择为监控项的 [数据源](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters)。widget 适用与单个监控项相同的选项。
对于“监控项列表”数据集，必须指定监控项或 widget。
另请参见：[数据集配置详情](#data-set-configuration-details)。
请注意，只允许数值型监控项类型。
在 [模板仪表板](/manual/config/templates/template#adding-dashboards) 上配置 widget 时，用于指定主机模式的参数不可用，而用于指定监控项列表的参数只能选择 [在模板上配置的监控项](/manual/config/templates/template#adding-items-triggers-graphs)。|
| |*Aggregation function*|指定在所选 [*Time period*](#time-period) 内对数据集中的每个监控项使用哪种聚合函数：
**min** - 显示最小值；
**max** - 显示最大值；
**avg** - 显示平均值；
**sum** - 显示总和；
**count** - 显示值的数量；
**first** - 显示第一个值；
**last** - 显示最后一个值（默认）。
聚合可用于显示所选时间间隔（5 分钟、1 小时、1 天）的聚合值。
只有数值数据才能用于 *min*、*max*、*avg* 和 *sum*。对于 *count*，非数值数据将转换为数值。|
|^|*Data set aggregation*|指定对整个数据集使用哪种聚合函数：
**not used** - 不进行聚合，监控项分别显示（默认）；
**min** - 显示最小值；
**max** - 显示最大值；
**avg** - 显示平均值；
**sum** - 显示总和；
**count** - 显示值的数量。
聚合可用于显示在 *Time period* 选项卡中选择的时间间隔（5 分钟、1 小时、1 天）的聚合值，或用于整个仪表板的聚合值。|
|^|*Data set label*|为数据集指定自定义标签。
该标签会显示在数据集配置中以及饼图图例中（对于聚合数据集）。
所有数据集都会编号，包括那些已指定 *Data set label* 的数据集。如果未指定标签，系统将根据编号自动为数据集命名（例如“Data set #2”、“Data set #3”等）。重新排序/拖动数据集后，数据集编号会重新计算。
过长的数据集标签会被缩短以适应显示位置（例如“Number of proc...”）。|
|^|*Item tags*|指定用于筛选 widget 中显示的监控项的标签。
可以包含或排除特定标签及标签值。可设置多个条件。
标签名称匹配始终区分大小写。
每个条件可使用以下运算符：
**Exists** - 包含指定的标签名称；
**Equals** - 包含指定的标签名称和值（区分大小写）；
**Contains** - 包含指定的标签名称，其中标签值包含输入的字符串（子串匹配，不区分大小写）；
**Does not exist** - 排除指定的标签名称；
**Does not equal** - 排除指定的标签名称和值（区分大小写）；
**Does not contain** - 排除指定的标签名称，其中标签值包含输入的字符串（子串匹配，不区分大小写）。
条件有两种计算类型：
**And/Or** - 必须满足所有条件，具有相同标签名称的条件将按 Or 条件分组；
**Or** - 满足任一条件即可。|
[comment]: # ({/3ecdd5a0-013fdb30})
[comment]: # ({a41ba8f1-b4dbf802})
##### 数据集配置详情
现有数据集会显示在列表中。
您可以重新排列、展开/折叠、更改颜色以及克隆这些数据集。
更多信息，请参见 [*Graph*](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set-configuration-details) 部件中的数据集配置详情。
这些详情也适用于 *Pie chart* 部件。
[comment]: # ({/a41ba8f1-b4dbf802})
[comment]: # ({32fe8c19-1febaa4b})
#### 显示选项
**显示选项**选项卡允许为饼图定义历史数据选择和可视化选项：
{width="600"}
| | | | |
|-|-|----------|----------------------------------------|
|*历史数据选择*|<|<|选择数据源：
**自动** - 根据经典[算法](/manual/config/visualization/graphs/simple#generating-from-historytrends)获取数据（默认）；
**历史** - 来自历史的数据；
**趋势** - 来自趋势的数据。|
|*绘制*|<|<|选择饼图的可视化样式：
**饼图** - 完整的饼图（扇区占用 100% 的半径）；
**环形图** - 中间带空心圆的饼图（扇区最多占用 50% 的半径）。|
|*扇区间距*|<|<|选择扇区之间的间距大小（单位为 0-10，默认值为“1”）。|
|*合并小于 N% 的扇区*|<|<|勾选复选框以合并小于 N% 的扇区。
启用后，选择合并后扇区的颜色以及用于合并小扇区的百分比阈值 (N)。|
|*绘制样式：**环形图*** |<|<|<|
| |*宽度*|<|选择环形图宽度：半径的 20%、30%、40% 或 50%（默认）。|
|^|*描边宽度*|<|选择环形图扇区边框的宽度（0-10）。|
|^|*显示总值*|<|勾选复选框以在环形图中间显示总值。|
|^| |*大小*|选择总值的大小选项：
**自动** - 自动调整文本大小，以便在环形图中间清晰显示；
**自定义** - 将文本大小指定为相对于整个小部件高度的百分比。|
|^|^|*小数位数*|指定总值的小数位数（0-6）。|
|^|^|*单位*|指定总值的单位。|
|^|^|*粗体*|勾选复选框以粗体显示总值。|
|^|^|*颜色*|选择总值的颜色。|
[comment]: # ({/32fe8c19-1febaa4b})
[comment]: # ({9e8618e7-dbd84beb})
#### 时间周期
**时间周期**选项卡允许为饼图的聚合设置自定义时间周期：
{width="600"}
| | |
|--|--------|
|*时间周期*|为时间周期选择[数据源](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters)：
**仪表板** - 使用仪表板的[时间周期选择器](/manual/web_interface/time_period_selector)；
**部件** - 使用兼容的部件（在*部件*参数中设置）；
**自定义** - 使用在*从*和*到*参数中指定的自定义时间周期；如果已设置，部件右上角将显示一个时钟图标，鼠标悬停时会指示所设置的时间。
请注意，无论部件的*时间周期*配置如何，兼容的部件仍可将其用作时间周期的数据源。|
|*部件*|输入或选择一个兼容的部件（*图形*、*图形（经典）*、*图形原型*）作为时间周期的数据源。
如果*时间周期*设置为“部件”，则此参数可用。|
|*从*|输入或选择时间周期的开始时间。
支持[相对时间语法](/manual/web_interface/time_period_selector)（`now`、`now/d`、`now/w-1w` 等）。
如果*时间周期*设置为“自定义”，则此参数可用。|
|*到*|输入或选择时间周期的结束时间。
支持[相对时间语法](/manual/web_interface/time_period_selector)（`now`、`now/d`、`now/w-1w` 等）。
如果*时间周期*设置为“自定义”，则此参数可用。|
[comment]: # ({/9e8618e7-dbd84beb})
[comment]: # ({dae145c8-5d3f87b1})
#### 图例
**图例**选项卡允许自定义饼图图例：
{width="600"}
| | |
|--|--------|
|*显示图例*|取消勾选此复选框可隐藏饼图上的图例（默认勾选）。|
|*显示值*|勾选此复选框可在图例中显示监控项的值。|
|*显示聚合函数*|勾选此复选框可在图例中显示聚合函数。|
|*行数*|选择图例行的显示方式：
**固定** - 显示的行数由*行数*参数值决定；
**可变** - 显示的行数由配置项的数量决定，但不超过*最大行数*参数值。|
|*行数/*
*最大行数*|若*行数*设置为“固定”，则设置要显示的图例行数（1-10）。
若*行数*设置为“可变”，则设置要显示的最大图例行数（1-10）。|
|*列数*|设置要显示的图例列数（1-4）。
若*显示值*未勾选，则此参数可用。|
[comment]: # ({/dae145c8-5d3f87b1})