20 Gráfico circular

Descripción

Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Gráfico circular en los métodos dashboard.create y dashboard.update.

Parámetros

Los siguientes parámetros son compatibles con el widget Gráfico circular.

Conjunto de datos

Los siguientes parámetros son compatibles para configurar un conjunto de datos.

::: nota clásica 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 particular. mientras que el segundo número, si está presente, representa el host o elemento configurado. :::

|Parámetro|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Tipo de conjunto de datos|<|0|ds.0.dataset_type|0 - Lista de elementos;
1 - (predeterminado) Patrones de elementos.| |<|Items|4|ds.0.itemids.0|Item ID.
Al configurar el widget en un panel de plantilla, solo se deben configurar los elementos configurados en la plantilla.

Nota: Para configurar varios elementos, cree un objeto de campo de widget de panel para cada elemento con un número incrementado en el nombre de la propiedad. .

Comportamiento de parámetros:
- obligatorio si Tipo de conjunto de datos está configurado en "Lista de elementos" y Elementos (Widget) no está configurado | |^|Elementos (Widget)|1|ds.0.itemids.0._reference|En lugar de Elemento ID:
ABCDE._itemid - establecer un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para los elementos.
<br >Nota: Para configurar múltiples widgets, cree un objeto de campo de widget de panel para cada widget con un número incrementado en el nombre de la propiedad.

Este parámetro es compatible desde Zabbix 7.0.1.

Parámetro comportamiento:
- obligatorio si Tipo de conjunto de datos está configurado en "Lista de elementos" y Elementos no está configurado| |^|Color|1|ds.0.color.0|Código de color hexadecimal (por ejemplo, FF0000).

Comportamiento de parámetros:
- compatible si Tipo de conjunto de datos está configurado en "Lista de elementos"| |^|Tipo de elemento|0|ds.0.type.0|0 - (predeterminado) Normal;
1 - Total.

El valor "Total" sólo se puede configurar para un elemento en todo el gráfico.

Comportamiento de parámetros:
- compatible si Tipo de conjunto de datos está configurado en "Lista de elementos" | |^|Patrones de host|1|ds.0.hosts.0|Host nombre o patrón (por ejemplo, "Zabbix*").
< br>Comportamiento del parámetro:
- obligatorio si Tipo de conjunto de datos está configurado en "Patrones de elementos"

Este parámetro no es compatible si configura el widget en un panel de plantilla.| |^|Patrones de elementos|1|ds.0.items.0|Item nombre o patrón (por ejemplo, "*: Número de *valores procesados por second").

Al configurar el widget en un panel de plantilla, solo se deben configurar los patrones para los elementos configurados en la plantilla.
< br>Comportamiento de parámetros:
- obligatorio si Tipo de conjunto de datos está configurado en "Patrones de elementos"| |^|Color|1|ds.0.color|Código de color hexadecimal (por ejemplo, FF0000).

Comportamiento de parámetros:<br >- compatible si Tipo de conjunto de datos está configurado en "Patrones de elementos"| |Función de agregación|<|0|ds.0.aggregate_function|1 - min;
2 - max;
3 - promedio;
4 - recuento;
5 - suma;<br >6 - primero;
7 - (predeterminado) último.| |Agregación de conjuntos de datos|<|0|ds.0.dataset_aggregation|0 - (predeterminado) ninguno;
1 - min;
2 - max;
3 - promedio;
4 - recuento;
5 - suma.

Comportamiento de parámetros:
- compatible si Tipo de elemento está establecido en " Totales"| |Etiqueta del conjunto de datos|<|1|ds.0.data_set_label|Cualquier valor de cadena.

Predeterminado: "" (vacío).|

Mostrando opciones

Los siguientes parámetros son compatibles para configurar Opciones de visualización.

|Parámetro|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Selección de datos del historial|<|0|source|0 - (predeterminado) Automático;
1 - Historial;
2 - Tendencias.| |Dibujar|<|0|draw_type|0 - (predeterminado) Pastel;
1 - Donut.| |<|Ancho|0|width|20 - 20% del radio;
30 - 30% del radio;
40 - 40% del radio;
50 - (predeterminado) 50% del radio.

Comportamiento de parámetros:
- compatible si Dibujar está configurado en "Donut"| |^|Mostrar valor total|0|total_show|0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:
- compatible si Dibujar está configurado en "Donut"| |^|Tamaño|0|value_size_type|0 - (predeterminado) Auto;
1 - Personalizado.

Comportamiento del parámetro:
- compatible si Mostrar valor total está configurado en "Habilitado"| |^|Tamaño (valor para tamaño personalizado)|0|value_size|Los valores posibles oscilan entre 1 y 100.

Predeterminado: 20.

Comportamiento del parámetro:
- compatible si Mostrar valor total está configurado en "Habilitado"| |^|Lugares decimales|0|decimal_places|Los valores posibles oscilan entre 0 y 6.

Predeterminado: 2.

Comportamiento de los parámetros:
- compatible si Mostrar valor total está configurado en "Habilitado"| |^|Unidades (casilla de verificación)|0|units_show|0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:
- compatible si Mostrar valor total está configurado en "Habilitado"| |^|Unidades (valor)|1|unidades|Cualquier valor de cadena.

Comportamiento del parámetro:
- compatible si * Unidades* (casilla de verificación) está configurada en "Habilitado"| |^|Negrita|0|value_bold|0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:
- compatible si Mostrar valor total está configurado en "Habilitado"| |^|Color|1|value_color|Código de color hexadecimal (por ejemplo, FF0000).

Comportamiento del parámetro:
- compatible si Mostrar valor total está configurado en "Activado"| |Espacio entre sectores|<|0|space|Los valores posibles oscilan entre 0 y 10.

Predeterminado: 1.| |Fusionar sectores menores que N% (casilla de verificación)|<|0|merge|0 - (predeterminado) Deshabilitado;
1 - Habilitado.| |Fusionar sectores menores que N% (valor)|<|0|merge_percent|Los valores posibles oscilan entre 1 y 10.

Predeterminado: 1.

Comportamiento de parámetros:
- compatible si Fusionar sectores menores que N% (casilla de verificación) está configurado en "Habilitado"| |Fusionar sectores más pequeños que N% (color)|<|1|merge_color|Código de color hexadecimal (por ejemplo, FF0000).

Comportamiento de parámetros:
- compatible si Fusionar sectores menores a N% (casilla de verificación) está configurado en "Habilitado"|

Periodo de tiempo

Los siguientes parámetros son compatibles para configurar Período de tiempo.

Leyenda

Los siguientes parámetros son compatibles para configurar Legend.

Ejemplos

Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Gráfico circular. Para obtener más información sobre cómo configurar un tablero, 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 del tipo "Lista de métricas" y consta de 3 métricas, todos de tipo "Normal" y representados por un color diferente.
• El segundo conjunto de datos es del 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 del gráfico circular se muestran como un gráfico de anillos con un ancho personalizado y un valor total con unidades en el centro.
• Los datos del 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 configurados en 4 filas.

Solicitud:

{
           "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:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Ver también

• Campo del widget del panel
• dashboard.create
• dashboard.update