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. |
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: ""
(±¹²¹³¦¨ª´Ç).´¥
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"|
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 |
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" |
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
.
Configure un widget ³Ò°ù¨¢´Ú¾±³¦´Ç circular de la siguiente manera:
{
"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: