[comment]: # ({4f11bfeb-168e8cde})
# 21 Круговая диаграмма
[comment]: # ({/4f11bfeb-168e8cde})
[comment]: # ({0ad6140e-5cc3e4a5})
#### Обзор
Виджет *Pie chart* отображает числовые данные элемента данных в виде векторной круговой или кольцевой диаграммы.
Этот виджет помогает визуализировать, как элементы данных или узлы сети вносят вклад в общий набор данных.
| | |
|-|-|
|{width="400"}|{width="400"}|
При наведении курсора соответствующий сектор увеличивается и показывает свою легенду; при щелчке по сектору он остается увеличенным, а его легенда видимой, пока не будет закрыт.
Информацию, отображаемую в виджете *Pie chart*, можно загрузить в виде изображения PNG, выбрав параметр *Download image* в [меню виджета](/manual/web_interface/frontend_sections/dashboards#widget-menu).
[comment]: # ({/0ad6140e-5cc3e4a5})
[comment]: # ({eff3502a-93b70ac4})
#### Настройка
Для настройки выберите *Круговая диаграмма (Pie chart)* в качестве типа:
{width="600"}
[comment]: # ({/eff3502a-93b70ac4})
[comment]: # ({3ecdd5a0-013fdb30})
#### Набор данных
Вкладка **Набор данных** позволяет выбрать данные для круговой диаграммы, добавляя наборы данных.
Можно добавить два типа наборов данных:
- *Шаблоны элементов данных* - отображаются данные из совпадающих элементов данных.
Вы можете выбрать один базовый цвет или строку палитры, чтобы назначить отдельные цвета каждому совпавшему элементу данных.
- *Список элементов данных* - отображаются данные из выбранных элементов данных.
Вы можете выбрать цвет каждого элемента отдельно с помощью палитры.
По умолчанию добавляется набор данных типа *Шаблоны элементов данных*.
| | | |
|-|----------|----------------------------------------|
|*Набор данных*|<|Для набора данных **Шаблоны элементов данных**:
Выберите или введите шаблоны узла сети и элемента данных; на круговой диаграмме будут отображаться данные элементов, которые соответствуют введенным шаблонам; может быть отображено до 50 элементов.
Для выбора можно использовать шаблоны с подстановочными знаками (например, `*` вернет результаты, соответствующие нулю или более символам).
Чтобы указать шаблон с подстановочным знаком, введите строку вручную и нажмите *Enter*.
Символ подстановки всегда интерпретируется, поэтому невозможно добавить, например, элемент с именем *item\** отдельно, если есть другие совпадающие элементы (например, *item2*, *item3*).
Указание шаблонов узла сети и элемента данных обязательно для наборов данных типа "Шаблоны элементов данных".
См. также: [Подробности настройки набора данных](#data-set-configuration-details).
Для набора данных **Список элементов данных**:
Выберите элементы для круговой диаграммы, нажав кнопку *Добавить элемент*.
Выпадающий список *Тип* рядом с именем элемента позволяет выбрать тип отображения для каждого элемента:
**Normal** - значение элемента отображается пропорционально на круговой диаграмме (по умолчанию);
**Total** - значение элемента занимает всю круговую диаграмму. Обратите внимание, что на круговой диаграмме может существовать только один элемент типа "Total", и он будет первым в легенде круговой диаграммы. Если для элемента задано значение "Total", параметр *Агрегация набора данных* (см. ниже) будет отключен и установлен в значение "not used".
Вы также можете выбрать совместимые виджеты в качестве [источника данных](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) для элементов, нажав кнопку *Добавить виджет*. Для виджетов применяются те же параметры, что и для отдельных элементов.
Указание элементов или виджетов обязательно для наборов данных типа "Список элементов данных".
См. также: [Подробности настройки набора данных](#data-set-configuration-details).
Обратите внимание, что допускаются только числовые типы элементов данных.
При настройке виджета на [панели шаблона](/manual/config/templates/template#adding-dashboards) параметр для указания шаблонов узла сети недоступен, а параметр для указания списка элементов позволяет выбрать только [элементы, настроенные на шаблоне](/manual/config/templates/template#adding-items-triggers-graphs).|
| |*Функция агрегации*|Укажите, какую функцию агрегации использовать для каждого элемента в наборе данных в пределах выбранного [*Периода времени*](#time-period):
**min** - отображать наименьшее значение;
**max** - отображать наибольшее значение;
**avg** - отображать среднее значение;
**sum** - отображать сумму значений;
**count** - отображать количество значений;
**first** - отображать первое значение;
**last** - отображать последнее значение (по умолчанию).
Агрегация позволяет отображать агрегированное значение за выбранный интервал (5 минут, час, день).
Для *min*, *max*, *avg* и *sum* можно отображать только числовые данные. Для *count* нечисловые данные будут преобразованы в числовые.|
|^|*Агрегация набора данных*|Укажите, какую функцию агрегации использовать для всего набора данных:
**not used** - агрегация не используется, элементы отображаются отдельно (по умолчанию);
**min** - отображать наименьшее значение;
**max** - отображать наибольшее значение;
**avg** - отображать среднее значение;
**sum** - отображать сумму значений;
**count** - отображать количество значений.
Агрегация позволяет отображать агрегированное значение за интервал (5 минут, час, день), выбранный на вкладке *Период времени*, или используемый для всей панели.|
|^|*Метка набора данных*|Укажите пользовательскую метку для набора данных.
Метка отображается в настройках набора данных и в легенде круговой диаграммы (для агрегированных наборов данных).
Все наборы данных нумеруются, включая те, для которых указана *Метка набора данных*. Если метка не указана, набор данных будет автоматически помечен в соответствии со своим номером (например, "Data set #2", "Data set #3" и т. д.). Нумерация наборов данных пересчитывается после изменения порядка/перетаскивания наборов данных.
Слишком длинные метки наборов данных будут сокращены, чтобы поместиться в месте отображения (например, "Number of proc...").|
|^|*Теги элементов данных*|Укажите теги для фильтрации элементов, отображаемых в виджете.
Можно как включать, так и исключать определенные теги и значения тегов. Можно задать несколько условий.
Сопоставление имени тега всегда чувствительно к регистру.
Для каждого условия доступны несколько операторов:
**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"}
| | | | |
|-|-|----------|----------------------------------------|
|*Выбор данных истории*|<|<|Выберите источник данных:
**Auto** - данные берутся в соответствии с классическим [алгоритмом](/manual/config/visualization/graphs/simple#generating-from-historytrends) (по умолчанию);
**History** - данные из history;
**Trends** - данные из trends.|
|*Отрисовка*|<|<|Выберите стиль визуализации круговой диаграммы:
**Pie** - полная круговая диаграмма (секторы занимают 100% радиуса);
**Doughnut** - круговая диаграмма с пустым кругом в центре (секторы занимают до 50% радиуса).|
|*Пространство между секторами*|<|<|Выберите размер промежутка (в диапазоне 0-10) между секторами (по умолчанию "1").|
|*Объединять сектора меньше чем N%*|<|<|Установите флажок, чтобы объединять сектора меньше чем N%.
Если включено, выберите цвет для объединенных секторов и пороговое значение процента (N) для объединения мелких секторов.|
|*Стиль отрисовки: **Doughnut*** |<|<|<|
| |*Ширина*|<|Выберите ширину doughnut: 20, 30, 40 или 50% (по умолчанию) от радиуса.|
|^|*Ширина обводки*|<|Выберите ширину границы сектора doughnut (0-10).|
|^|*Показывать итоговое значение*|<|Установите флажок, чтобы показывать итоговое значение в центре диаграммы doughnut.|
|^| |*Размер*|Выберите параметр размера для итогового значения:
**Auto** - размер текста определяется автоматически, чтобы он читабельно помещался в центре doughnut;
**Custom** - укажите размер текста как процент высоты от общей высоты виджета.|
|^|^|*Знаков после запятой*|Укажите количество знаков после запятой для итогового значения (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) панели мониторинга;
**Виджет** - использовать совместимый виджет (задается в параметре *Виджет*);
**Пользовательский** - использовать пользовательский период времени, указанный в параметрах *С* и *По*; если задан, в правом верхнем углу виджета будет отображаться значок часов, показывающий установленное время при наведении курсора.
Обратите внимание, что независимо от настройки *Период времени* виджета, совместимые виджеты по-прежнему могут использовать его как источник данных для периода времени.|
|*Виджет*|Введите или выберите совместимый виджет (*Graph*, *Graph (classic)*, *Graph prototype*) в качестве источника данных для периода времени.
Этот параметр доступен, если для *Период времени* выбрано значение "Виджет".|
|*С*|Введите или выберите начало периода времени.
Поддерживается [синтаксис относительного времени](/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})
#### Легенда
Вкладка **Легенда (Legend)** позволяет настроить легенду круговой диаграммы:
{width="600"}
| | |
|--|--------|
|*Легенда*
*(Show legend)*|Снимите этот флажок, чтобы скрыть легенду на графике (по умолчанию флажок отмечен).|
|*Отображение значения*
*(Show value)*|Установите этот флажок для отображения в легенде значения элемента данных.|
|*Отображение функции агрегирования*
*(Show aggregation function)*|Установите этот флажок для отображения в легенде функции агрегирования.|
|*Количество строк*
*(Rows)*|Выберите режим отображения строк легенды:
**Фиксированное (Fixed)** — количество отображаемых строк определяется значением параметра *Количество строк (Number of rows)*;
**Переменное (Variable)** — количество отображаемых строк определяется количеством настроенных элементов данных, в то же время не превышая значения параметра *Максимальное количество строк (Maximum number of rows)*.|
|*Количество строк/*
*Максимальное количество строк*
*(Number of rows/*
*Maximum number of rows)*|Если *Количество строк (Rows)* имеет значение «Фиксированное (Fixed)», задать количество отображаемых строк легенды (1-10).
Если *Количество строк (Rows)* имеет значение «Переменное (Variable)», задать максимальное количество отображаемых строк легенды (1-10).|
|*Количество колонок*
*(Number of columns)*|Задать количество отображаемых столбцов легенды (1-4).
Этот параметр доступен, если *Отображение значения (Show value)* не отмечено.|
[comment]: # ({/dae145c8-5d3f87b1})