Table of Contents
21 Gráfico circular
Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo de widget de panel permiten configurar el widget Gráfico circular en los métodos dashboard.create y dashboard.update.
Las propiedades fields del widget no se validan durante la creación o actualización de un panel. Esto permite a los usuarios modificar widgets integrados y crear widgets personalizados, pero también introduce el riesgo de crear o actualizar widgets incorrectamente. Para garantizar la creación o actualización exitosa del widget Gráfico circular, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
Parámetros
Los siguientes parámetros son compatibles para el widget Gráfico circular.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Intervalo de actualización | 0 | rf_rate | 0 - Sin actualización; 10 - 10 segundos; 30 - 30 segundos; 60 - (por defecto) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
Conjunto de datos
Se admiten los siguientes parámetros para configurar un Conjunto de datos.
El primer número en el nombre de la propiedad (por ejemplo, ds.0.hosts.0, ds.0.items.0) representa el conjunto de datos en particular, mientras que el segundo número, si está presente, representa el equipo o la métrica configurados.
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Tipo de conjunto de datos | 0 | ds.0.dataset_type | 0 - Lista de métricas; 1 - (por defecto) Patrones de métricas. |
|
| Métricas | 4 | ds.0.itemids.0 | ID de la Métrica. Al configurar el widget en un dashboard de plantilla, solo deben establecerse las métricas configuradas en la plantilla. Nota: Para configurar varias métricas, cree un objeto de campo de widget de dashboard para cada métrica con un número incrementado en el nombre de la propiedad. Comportamiento del parámetro: - obligatorio si Tipo de conjunto de datos está establecido en "Lista de métricas" y Métricas (Widget) no está establecido |
|
| Métricas (Widget) | 1 | ds.0.itemids.0._reference | En lugar del ID de la Métrica:ABCDE._itemid - establezca un widget compatible (con su parámetro Referencia establecido en "ABCDE") como fuente de datos para las métricas.Nota: Para configurar varios widgets, cree un objeto de campo de widget de dashboard para cada widget con un número incrementado en el nombre de la propiedad. Comportamiento del parámetro: - obligatorio si Tipo de conjunto de datos está establecido en "Lista de métricas" y Métricas no está establecido |
|
| Color | 1 | ds.0.color.0 | Código de color hexadecimal (por ejemplo, FF0000).Comportamiento del parámetro: - admitido si Tipo de conjunto de datos está establecido en "Lista de métricas" |
|
| Tipo de métrica | 0 | ds.0.type.0 | 0 - (por defecto) Normal; 1 - Total. El valor "Total" solo se puede establecer para una métrica en todo el gráfico. Comportamiento del parámetro: - admitido si Tipo de conjunto de datos está establecido en "Lista de métricas" |
|
| Patrones de equipos | 1 | ds.0.hosts.0 | Nombre o patrón del Equipo (por ejemplo, "Zabbix*"). Comportamiento del parámetro: - obligatorio si Tipo de conjunto de datos está establecido en "Patrones de métricas" Este parámetro no es compatible si se configura el widget en un dashboard de plantilla. |
|
| Patrones de métricas | 1 | ds.0.items.0 | Nombre o patrón de la Métrica (por ejemplo, "*: Número de valores procesados por segundo"). Al configurar el widget en un dashboard de plantilla, solo deben establecerse los patrones para las métricas configuradas en la plantilla. Comportamiento del parámetro: - obligatorio si Tipo de conjunto de datos está establecido en "Patrones de métricas" |
|
| Color | 1 | ds.0.color | Código de color hexadecimal (por ejemplo, FF0000).Comportamiento del parámetro: - admitido si Tipo de conjunto de datos está establecido en "Patrones de métricas" |
|
| Función de agregación | 0 | ds.0.aggregate_function | 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - (por defecto) last. |
|
| Agregación de conjunto de datos | 0 | ds.0.dataset_aggregation | 0 - (por defecto) ninguna; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum. Comportamiento del parámetro: - admitido si Tipo de métrica está establecido en "Total" |
|
| Etiqueta de conjunto de datos | 1 | ds.0.data_set_label | Cualquier valor de cadena. Por defecto: "" (vacío). |
|
Opciones de visualización
Se admiten los siguientes parámetros para configurar las Opciones de visualización.
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Selección de datos históricos | 0 | source | 0 - (por defecto) Automático; 1 - Historial; 2 - Tendencias. |
|
| Dibujar | 0 | draw_type | 0 - (por defecto) Tarta; 1 - Rosquilla. |
|
| Ancho | 0 | width | 20 - 20% del radio; 30 - 30% del radio; 40 - 40% del radio; 50 - (por defecto) 50% del radio. Comportamiento del parámetro: - soportado si Dibujar está configurado en "Rosquilla" |
|
| Ancho del trazo | 0 | stroke | Los valores posibles van de 0-10. Por defecto: 0. Comportamiento del parámetro: - soportado si Dibujar está configurado en "Rosquilla" |
|
| Mostrar valor total | 0 | total_show | 0 - (por defecto) Deshabilitado; 1 - Habilitado. Comportamiento del parámetro: - soportado si Dibujar está configurado en "Rosquilla" |
|
| Tamaño | 0 | value_size_type | 0 - (por defecto) Automático; 1 - Personalizado. Comportamiento del parámetro: - soportado si Mostrar valor total está configurado en "Habilitado" |
|
| Tamaño (valor para tamaño personalizado) | 0 | value_size | Los valores posibles van de 1-100. Por defecto: 20. Comportamiento del parámetro: - soportado si Mostrar valor total está configurado en "Habilitado" |
|
| Decimales | 0 | decimal_places | Los valores posibles van de 0-6. Por defecto: 2. Comportamiento del parámetro: - soportado si Mostrar valor total está configurado en "Habilitado" |
|
| Unidades (casilla de verificación) | 0 | units_show | 0 - (por defecto) Deshabilitado; 1 - Habilitado. Comportamiento del parámetro: - soportado si Mostrar valor total está configurado en "Habilitado" |
|
| Unidades (valor) | 1 | units | Cualquier valor de cadena. Comportamiento del parámetro: - soportado si Unidades (casilla de verificación) está configurado en "Habilitado" |
|
| Negrita | 0 | value_bold | 0 - (por defecto) Deshabilitado; 1 - Habilitado. Comportamiento del parámetro: - soportado si Mostrar valor total está configurado en "Habilitado" |
|
| Color | 1 | value_color | Código de color hexadecimal (por ejemplo, FF0000).Comportamiento del parámetro: - soportado si Mostrar valor total está configurado en "Habilitado" |
|
| Espacio entre sectores | 0 | space | Los valores posibles van de 0-10. Por defecto: 1. |
|
| Unir sectores menores que N% (casilla de verificación) | 0 | merge | 0 - (por defecto) Deshabilitado; 1 - Habilitado. |
|
| Unir sectores menores que N% (valor) | 0 | merge_percent | Los valores posibles van de 1-10. Por defecto: 1. Comportamiento del parámetro: - soportado si Unir sectores menores que N% (casilla de verificación) está configurado en "Habilitado" |
|
| Unir sectores menores que N% (color) | 1 | merge_color | Código de color hexadecimal (por ejemplo, FF0000).Comportamiento del parámetro: - soportado si Unir sectores menores que N% (casilla de verificación) está configurado en "Habilitado" |
|
Periodo de tiempo
Se admiten los siguientes parámetros para configurar el Periodo de tiempo.
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Periodo de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establece el selector de Periodo de tiempo como la fuente de datos;ABCDE._timeperiod - establece un widget compatible (con su parámetro Referencia configurado como "ABCDE") como la fuente de datos.Por defecto: DASHBOARD._timeperiodAlternativamente, puede establecer el periodo de tiempo solo en los parámetros Desde y Hasta. |
|
| Desde | 1 | time_period.from | Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - admitido si Periodo de tiempo no está establecido |
|
| Hasta | 1 | time_period.to | Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - admitido si Periodo de tiempo no está establecido |
|
Leyenda
Los siguientes parámetros son compatibles para configurar la Leyenda.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Mostrar leyenda | 0 | legend | 0 - Deshabilitado; 1 - (por defecto) Habilitado. |
| Mostrar valor | 0 | legend_value | 0 - (por defecto) Deshabilitado; 1 - Habilitado. Comportamiento del parámetro: - soportado si Mostrar leyenda está establecido en "Habilitado" |
| Mostrar función de agregación | 0 | legend_aggregation | 0 - (por defecto) Deshabilitado; 1 - Habilitado. Comportamiento del parámetro: - soportado si Mostrar leyenda está establecido en "Habilitado" |
| Filas | 0 | legend_lines_mode | 0 - (por defecto) Fijo; 1 - Variable. Comportamiento del parámetro: - soportado si Mostrar leyenda está establecido en "Habilitado" |
| Número de filas/ Número máximo de filas |
0 | legend_lines | Los valores posibles van de 1-10. Por defecto: 1. Comportamiento del parámetro: - soportado si Mostrar leyenda está establecido en "Habilitado" |
| Número de columnas | 0 | legend_columns | Los valores posibles van de 1-4. Por defecto: 4. Comportamiento del parámetro: - soportado si Mostrar leyenda está establecido en "Habilitado" y Mostrar valor está establecido en "Deshabilitado" |
Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget del panel para el widget Gráfico circular. Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
Configuración de un widget Gráfico circular
Configure un widget Gráfico circular de la siguiente manera:
- 2 conjuntos de datos para un total de 9 métricas en 1 equipo.
- El primer conjunto de datos es de tipo "Lista de métricas" y consta de 3 métricas que son todas de tipo "Normal" y representadas por un color diferente.
- El segundo conjunto de datos es de tipo "Patrones de métricas", consta de 6 métricas, tiene una agregación configurada para cada métrica y está representado por un color personalizado.
- El segundo conjunto de datos también tiene una etiqueta de conjunto de datos personalizada.
- Los datos en el gráfico circular se muestran como un gráfico de anillo con un ancho personalizado y el valor total con unidades en el centro.
- Los datos en el gráfico circular se muestran y agregan para un período de tiempo personalizado de las últimas 3 horas.
- La leyenda del gráfico circular muestra las métricas configuradas en 4 filas.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "piechart",
"name": "Pie chart",
"x": 0,
"y": 0,
"width": 24,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "ds.0.dataset_type",
"value": 0
},
{
"type": 4,
"name": "ds.0.itemids.1",
"value": 23264
},
{
"type": 1,
"name": "ds.0.color.1",
"value": "FF0000"
},
{
"type": 0,
"name": "ds.0.type.1",
"value": 0
},
{
"type": 4,
"name": "ds.0.itemids.2",
"value": 23269
},
{
"type": 1,
"name": "ds.0.color.2",
"value": "BF00FF"
},
{
"type": 0,
"name": "ds.0.type.2",
"value": 0
},
{
"type": 4,
"name": "ds.0.itemids.3",
"value": 23257
},
{
"type": 1,
"name": "ds.0.color.3",
"value": "0040FF"
},
{
"type": 0,
"name": "ds.0.type.3",
"value": 0
},
{
"type": 1,
"name": "ds.1.hosts.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.1.items.0",
"value": "*: Number of processed *values per second"
},
{
"type": 1,
"name": "ds.1.color",
"value": "000000"
},
{
"type": 0,
"name": "ds.1.aggregate_function",
"value": 3
},
{
"type": 1,
"name": "ds.1.data_set_label",
"value": "Number of processed values per second"
},
{
"type": 0,
"name": "draw_type",
"value": 1
},
{
"type": 0,
"name": "width",
"value": 30
},
{
"type": 0,
"name": "total_show",
"value": 1
},
{
"type": 0,
"name": "units_show",
"value": 1
},
{
"type": 0,
"name": "graph_time",
"value": 1
},
{
"type": 1,
"name": "time_period.from",
"value": "now-3h"
},
{
"type": 0,
"name": "legend_lines",
"value": 4
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta: