Áú»¢¶Ä²©

Esta es una traducci¨®n de la p¨¢gina de documentaci¨®n original en espa?ol. Ay¨²danos a mejorarla.

20 ³Ò°ù¨¢´Ú¾±³¦´Ç circular

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô

Estos par¨¢metros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget ³Ò°ù¨¢´Ú¾±³¦´Ç circular en los m¨¦todos dashboard.create y dashboard.update.

Las propiedades de los "campos" del widget no se validan durante la creaci¨®n o actualizaci¨®n de un tablero. 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 ³Ò°ù¨¢´Ú¾±³¦´Ç circular, consulte el comportamiento de los par¨¢metros descrito en las tablas siguientes.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ

Los siguientes par¨¢metros son compatibles con el widget ³Ò°ù¨¢´Ú¾±³¦´Ç circular.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç tipo nombre valor
Intervalo de actualizaci¨®n 0 rf_rate 0 - Sin actualizaci¨®n;
10 - 10 segundos;
30 - 30 segundos;
60 - (predeterminado) 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.

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. :::

|±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç|<|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 Áú»¢¶Ä²© 7.0.1.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç 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, "Áú»¢¶Ä²©*").
< 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: "" (±¹²¹³¦¨ª´Ç).´¥

Mostrando opciones

Los siguientes par¨¢metros son compatibles para configurar Opciones de visualizaci¨®n.

|±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Selecci¨®n de datos del historial|<|0|source|0 - (predeterminado) ´¡³Ü³Ù´Ç³¾¨¢³Ù¾±³¦´Ç;
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.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç tipo nombre valor
Per¨ªodo de tiempo 1 time_period._reference DASHBOARD._timeperiod - establece el selector de per¨ªodo de tiempo como fuente de datos.
ABCDE._timeperiod - establece un widget compatible (Graph, Graph (classic) o Prototipo de Graph con su par¨¢metro Reference establecido en "ABCDE") como fuente de datos.

Predeterminado: DASHBOARD._timeperiod

Alternativamente, puede establecer el per¨ªodo de tiempo solo en los par¨¢metros Desde y Hasta.
Desde 1 time_period.from Cadena de tiempo v¨¢lida en sintaxis de tiempo absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ahora, now/d, now/w-1w, etc.).

Comportamiento de par¨¢metros:
- compatible si Hora per¨ªodo no est¨¢ establecido
Hasta 1 time_period.to Cadena de tiempo v¨¢lida en sintaxis de tiempo absoluta (AAAA-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).

Comportamiento de par¨¢metros:
- compatible si Hora per¨ªodo no est¨¢ establecido

Leyenda

Los siguientes par¨¢metros son compatibles para configurar Legend.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç tipo nombre valor
Mostrar leyenda 0 legend 0 - Deshabilitado;
1 - (predeterminado) Habilitado.
Mostrar valor 0 legend_value 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de par¨¢metros:< br>- compatible si Mostrar leyenda est¨¢ configurado en "Activado"
Mostrar funci¨®n de agregaci¨®n 0 legend_aggregation 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de par¨¢metros:
- compatible si Mostrar leyenda est¨¢ configurado en "Activado"
Filas 0 legend_lines_mode 0 - (predeterminado) Fijo;
1 - Variable.

Comportamiento del par¨¢metro:<br >- compatible si Mostrar leyenda est¨¢ configurado en "Activado"
N¨²mero de filas/
N¨²mero m¨¢ximo de filas
0 legend_lines Los valores posibles oscilan entre 1 y 10.

Predeterminado: 1.

Comportamiento del par¨¢metro:
- compatible si Mostrar leyenda est¨¢ configurado en "Habilitado"
N¨²mero de columnas 0 legend_columns Los valores posibles oscilan entre 1 y 4.

Predeterminado: 4.

Comportamiento de par¨¢metros:
- compatible si Mostrar leyenda est¨¢ configurado en "Activado" y Mostrar valor est¨¢ configurado en "Desactivado"

Ejemplos

Los siguientes ejemplos pretenden describir ¨²nicamente la configuraci¨®n de los objetos de campo del widget del tablero para el widget ³Ò°ù¨¢´Ú¾±³¦´Ç circular. Para obtener m¨¢s informaci¨®n sobre c¨®mo configurar un tablero, consulte dashboard.create.

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô de un widget ³Ò°ù¨¢´Ú¾±³¦´Ç circular

Configure un widget ³Ò°ù¨¢´Ú¾±³¦´Ç 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": "Áú»¢¶Ä²© 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