[comment]: # ({4f11bfeb-168e8cde})
# 21 Gráfico circular

[comment]: # ({/4f11bfeb-168e8cde})

[comment]: # ({0ad6140e-5cc3e4a5})
#### Descripción general

El widget *Gráfico circular* muestra datos numéricos de item como un gráfico circular o de anillo basado en vectores.
Este widget puede ayudarle a visualizar cómo los items o hosts contribuyen al conjunto de datos general.

|   |   |
|-|-|
|![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_chart.png){width="400"}|![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/doughnut_chart.png){width="400"}|

Al pasar el cursor sobre un sector, este se expande y muestra su leyenda; al hacer clic en el sector, este permanece expandido y su leyenda sigue visible hasta que se cierre.

La información mostrada en el widget *Gráfico circular* puede descargarse como una imagen PNG seleccionando la opción *Descargar imagen* en el [menú del widget](/manual/web_interface/frontend_sections/dashboards#widget-menu).

[comment]: # ({/0ad6140e-5cc3e4a5})

[comment]: # ({eff3502a-93b70ac4})
#### Configuración

Para configurar, seleccione *Gráfico circular* como tipo:

![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_dataset.png){width="600"}

[comment]: # ({/eff3502a-93b70ac4})

[comment]: # ({3ecdd5a0-013fdb30})
#### Conjunto de datos

La pestaña **Conjunto de datos** permite seleccionar datos para el gráfico circular agregando conjuntos de datos.
Se pueden agregar dos tipos de conjuntos de datos:

-   *Patrones de item* - se muestran los datos de los items que coinciden.
Puede elegir un color base único o seleccionar una fila de la paleta para asignar colores distintos a cada item coincidente.
-   *Lista de items* - se muestran los datos de los items seleccionados.
Puede elegir el color de cada item individualmente desde el selector.

De forma predeterminada, se agrega un conjunto de datos de tipo *Patrones de item*.

|   |   |   |
|-|----------|----------------------------------------|
|*Conjunto de datos*|<|Para el conjunto de datos **Patrones de item**:<br>Seleccione o introduzca patrones de host e item; se mostrarán en el gráfico circular los datos de los items que coincidan con los patrones introducidos; se pueden mostrar hasta 50 items.<br>Se pueden usar patrones comodín para la selección (por ejemplo, `*` devolverá resultados que coincidan con cero o más caracteres).<br>Para especificar un patrón comodín, introduzca la cadena manualmente y pulse *Enter*.<br>El símbolo comodín siempre se interpreta, por lo que no es posible agregar, por ejemplo, un item llamado *item\** de forma individual si hay otros items coincidentes (por ejemplo, *item2*, *item3*).<br>Es obligatorio especificar patrones de host e item para los conjuntos de datos "Patrones de item".<br>Véase también: [Detalles de configuración del conjunto de datos](#data-set-configuration-details).<br><br>Para el conjunto de datos **Lista de items**:<br>Seleccione items para el gráfico circular haciendo clic en el botón *Agregar item*.<br>La lista desplegable *Tipo* después del nombre del item permite seleccionar el tipo de visualización para cada item:<br>**Normal** - el valor del item se representa proporcionalmente en el gráfico circular (predeterminado);<br>**Total** - el valor del item ocupa todo el gráfico circular. Tenga en cuenta que solo puede existir un item "Total" por gráfico circular, y se colocará primero en la leyenda del gráfico circular. Si un item se establece como "Total", el parámetro *Agregación del conjunto de datos* (véase más abajo) se deshabilitará y se establecerá en "no usado".<br>También puede seleccionar widgets compatibles como [fuente de datos](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) para los items haciendo clic en el botón *Agregar widget*. Las mismas opciones se aplican a los widgets que a los items individuales.<br>Es obligatorio especificar items o widgets para los conjuntos de datos "Lista de items".<br>Véase también: [Detalles de configuración del conjunto de datos](#data-set-configuration-details).<br><br>Tenga en cuenta que solo se permiten tipos de item numéricos.<br><br>Al configurar el widget en un [panel de template](/manual/config/templates/template#adding-dashboards), el parámetro para especificar patrones de host no está disponible, y el parámetro para especificar una lista de items permite seleccionar solo los [items configurados en el template](/manual/config/templates/template#adding-items-triggers-graphs).|
| |*Función de agregación*|Especifique qué función de agregación usar para cada item del conjunto de datos dentro del [*Período de tiempo*](#time-period) seleccionado:<br>**min** - muestra el valor más pequeño;<br>**max** - muestra el valor más grande;<br>**avg** - muestra el valor promedio;<br>**sum** - muestra la suma de los valores;<br>**count** - muestra el recuento de valores;<br>**first** - muestra el primer valor;<br>**last** - muestra el último valor (predeterminado).<br><br>La agregación permite mostrar un valor agregado para el intervalo elegido (5 minutos, una hora, un día).<br>Solo se pueden mostrar datos numéricos para *min*, *max*, *avg* y *sum*. Para *count*, los datos no numéricos se convertirán en numéricos.|
|^|*Agregación del conjunto de datos*|Especifique qué función de agregación usar para todo el conjunto de datos:<br>**no usado** - sin agregación, los items se muestran por separado (predeterminado);<br>**min** - muestra el valor más pequeño;<br>**max** - muestra el valor más grande;<br>**avg** - muestra el valor promedio;<br>**sum** - muestra la suma de los valores;<br>**count** - muestra el recuento de valores.<br><br>La agregación permite mostrar un valor agregado para el intervalo (5 minutos, una hora, un día) seleccionado en la pestaña *Período de tiempo* o usado para todo el panel.|
|^|*Etiqueta del conjunto de datos*|Especifique una etiqueta personalizada para el conjunto de datos.<br>La etiqueta se muestra en la configuración del conjunto de datos y en la leyenda del gráfico circular (para conjuntos de datos agregados).<br>Todos los conjuntos de datos se numeran, incluidos aquellos con una *Etiqueta del conjunto de datos* especificada. Si no se especifica ninguna etiqueta, el conjunto de datos se etiquetará automáticamente según su número (por ejemplo, "Conjunto de datos #2", "Conjunto de datos #3", etc.). La numeración de los conjuntos de datos se recalcula después de reordenarlos o arrastrarlos.<br>Las etiquetas de conjunto de datos demasiado largas se acortarán para ajustarse al lugar donde se muestran (por ejemplo, "Number of proc...").|
|^|*Etiquetas de item*|Especifique etiquetas para filtrar los items mostrados en el widget.<br>Es posible incluir y excluir etiquetas y valores de etiqueta específicos. Se pueden establecer varias condiciones.<br>La coincidencia del nombre de la etiqueta siempre distingue entre mayúsculas y minúsculas.<br><br>Hay varios operadores disponibles para cada condición:<br>**Exists** - incluye los nombres de etiqueta especificados;<br>**Equals** - incluye los nombres y valores de etiqueta especificados (distingue entre mayúsculas y minúsculas);<br>**Contains** - incluye los nombres de etiqueta especificados cuyos valores de etiqueta contienen la cadena introducida (coincidencia de subcadena, no distingue entre mayúsculas y minúsculas);<br>**Does not exist** - excluye los nombres de etiqueta especificados;<br>**Does not equal** - excluye los nombres y valores de etiqueta especificados (distingue entre mayúsculas y minúsculas);<br>**Does not contain** - excluye los nombres de etiqueta especificados cuyos valores de etiqueta contienen la cadena introducida (coincidencia de subcadena, no distingue entre mayúsculas y minúsculas).<br><br>Hay dos tipos de cálculo para las condiciones:<br>**And/Or** - deben cumplirse todas las condiciones; las condiciones que tengan el mismo nombre de etiqueta se agruparán mediante la condición Or;<br>**Or** - basta con que se cumpla una condición.|

[comment]: # ({/3ecdd5a0-013fdb30})

[comment]: # ({a41ba8f1-b4dbf802})
##### Detalles de la configuración del conjunto de datos

Los conjuntos de datos existentes se muestran en una lista.
Puede reorganizar, expandir/colapsar, cambiar colores y clonar estos conjuntos de datos.

Para obtener más información, consulte los detalles de la configuración del conjunto de datos en el widget [*Gráfico*](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set-configuration-details).
Estos detalles también se aplican al widget *Gráfico circular*.

[comment]: # ({/a41ba8f1-b4dbf802})

[comment]: # ({32fe8c19-1febaa4b})
#### Opciones de visualización

La pestaña **Opciones de visualización** permite definir la selección de datos históricos y las opciones de visualización para el gráfico circular:

![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_displaying_options.png){width="600"}

|   |   |   |   |
|-|-|----------|----------------------------------------|
|*Selección de datos históricos*|<|<|Seleccione la fuente de datos:<br>**Auto**: los datos se obtienen según el [algoritmo](/manual/config/visualization/graphs/simple#generating-from-historytrends) clásico (predeterminado);<br>**Histórico**: datos del histórico;<br>**Tendencias**: datos de tendencias.|
|*Dibujar*|<|<|Seleccione el estilo de visualización del gráfico circular:<br>**Circular**: un círculo completo (los sectores ocupan el 100% del radio);<br>**Anillo**: un gráfico circular con un círculo vacío en el centro (los sectores usan hasta el 50% del radio).|
|*Espacio entre sectores*|<|<|Seleccione el tamaño del espacio (en unidades de 0 a 10) entre los sectores (el valor predeterminado es "1").|
|*Combinar sectores menores que N%*|<|<|Marque la casilla para combinar los sectores menores que N%.<br>Si está habilitado, seleccione el color de los sectores combinados y el umbral porcentual (N) para combinar sectores pequeños.|
|*Estilo de dibujo: **Anillo*** |<|<|<|
| |*Ancho*|<|Seleccione el ancho del anillo: 20, 30, 40 o 50% (predeterminado) del radio.|
|^|*Ancho del borde*|<|Seleccione el ancho del borde del sector del anillo (0-10).|
|^|*Mostrar valor total*|<|Marque la casilla para mostrar el valor total en el centro del gráfico de anillo.|
|^| |*Tamaño*|Seleccione la opción de tamaño para el valor total:<br>**Auto**: el tamaño del texto se ajusta automáticamente para que encaje de forma legible en el centro del anillo;<br>**Personalizado**: especifique el tamaño del texto como porcentaje de altura respecto a la altura total del widget.|
|^|^|*Posiciones decimales*|Especifique el número de posiciones decimales para el valor total (0-6).|
|^|^|*Unidades*|Especifique las unidades para el valor total.|
|^|^|*Negrita*|Marque la casilla para mostrar el valor total en negrita.|
|^|^|*Color*|Seleccione el color para el valor total.|

[comment]: # ({/32fe8c19-1febaa4b})

[comment]: # ({9e8618e7-dbd84beb})
#### Período de tiempo

La pestaña **Período de tiempo** permite establecer un período de tiempo personalizado para la configuración de agregación del gráfico circular:

![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_time_period.png){width="600"}

|   |   |
|--|--------|
|*Período de tiempo*|Seleccione la [fuente de datos](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) para el período de tiempo:<br>**Panel**: utiliza el [selector de período de tiempo](/manual/web_interface/time_period_selector) del panel;<br>**Widget**: utiliza un widget compatible (establecido en el parámetro *Widget*);<br>**Personalizado**: utiliza un período de tiempo personalizado especificado en los parámetros *Desde* y *Hasta*; si se establece, se mostrará un icono de reloj en la esquina superior derecha del widget, indicando el tiempo configurado al pasar el ratón.<br>Tenga en cuenta que, independientemente de la configuración de *Período de tiempo* del widget, los widgets compatibles aún pueden utilizarlo como fuente de datos para el período de tiempo.|
|*Widget*|Introduzca o seleccione un widget compatible (*Gráfico*, *Gráfico (clásico)*, *Prototipo de gráfico*) como fuente de datos para el período de tiempo.<br>Este parámetro está disponible si *Período de tiempo* está configurado en "Widget".|
|*Desde*|Introduzca o seleccione el inicio del período de tiempo.<br>Se admite la [sintaxis de tiempo relativo](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br>Este parámetro está disponible si *Período de tiempo* está configurado en "Personalizado".|
|*Hasta*|Introduzca o seleccione el final del período de tiempo.<br>Se admite la [sintaxis de tiempo relativo](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br>Este parámetro está disponible si *Período de tiempo* está configurado en "Personalizado".|

[comment]: # ({/9e8618e7-dbd84beb})

[comment]: # ({dae145c8-5d3f87b1})
#### Leyenda

La pestaña **Leyenda** permite personalizar la leyenda del gráfico circular:

![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/pie_legend.png){width="600"}

|   |   |
|--|--------|
|*Mostrar leyenda*|Desmarque esta casilla para ocultar la leyenda en el gráfico circular (marcada por defecto).|
|*Mostrar valor*|Marque esta casilla para mostrar el valor de la métrica en la leyenda.|
|*Mostrar función de agregación*|Marque esta casilla para mostrar la función de agregación en la leyenda.|
|*Filas*|Seleccione el modo de visualización para las filas de la leyenda:<br>**Fijo**: el número de filas mostradas se determina por el valor del parámetro *Número de filas*;<br>**Variable**: el número de filas mostradas se determina por la cantidad de métricas configuradas sin exceder el valor del parámetro *Número máximo de filas*.|
|*Número de filas/*<br>*Número máximo de filas*|Si *Filas* está establecido en "Fijo", establezca el número de filas de la leyenda a mostrar (1-10).<br>Si *Filas* está establecido en "Variable", establezca el número máximo de filas de la leyenda a mostrar (1-10).|
|*Número de columnas*|Establezca el número de columnas de la leyenda a mostrar (1-4).<br>Este parámetro está disponible si *Mostrar valor* está desmarcado.|

[comment]: # ({/dae145c8-5d3f87b1})
