Estos par¨¢metros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹ 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 Historial de ³¾¨¦³Ù°ù¾±³¦²¹, consulte el comportamiento de los par¨¢metros descrito en las tablas siguientes.
Los siguientes par¨¢metros son compatibles con el widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | 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. |
Dise?o | 0 | layout | 0 - (predeterminado) Horizontal; 1 - Vertical. |
Columnas (ver abajo) | |||
Mostrar l¨ªneas | 0 | show_lines | Los valores posibles oscilan entre 1 y 100. Predeterminado: 25. |
Reemplazar equipo | 1 | override_hostid._reference | ABCDE._hostid - establece un widget compatible (con su par¨¢metro Reference establecido en "ABCDE ") como fuente de datos para los equipos;DASHBOARD._hostid - establece el tablero selector de equipo como fuente de datos para los equipos.Este par¨¢metro no se admite si se configura el widget en un tablero de una plantilla. |
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô avanzada (ver abajo) | |||
Referencia | 1 | referencia | Cualquier valor de cadena que consta de 5 caracteres (por ejemplo, ABCDE o JBPNL ). Este valor debe ser ¨²nico dentro del tablero al que pertenece el widget.Comportamiento del par¨¢metro: - requerido |
Las columnas tienen par¨¢metros comunes y par¨¢metros adicionales seg¨²n la configuraci¨®n del par¨¢metro Item.
Para todos los par¨¢metros relacionados con columnas, el n¨²mero en el nombre de la propiedad (por ejemplo, columns.0.name) hace referencia a una columna para la cual est¨¢ configurado el par¨¢metro.
Los siguientes par¨¢metros son compatibles con todas las columnas.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | tipo | nombre | valor |
---|---|---|---|
Nombre | 1 | columns.0.name | Cualquier valor de cadena. Comportamiento del par¨¢metro: - obligatorio |
²Ñ¨¦³Ù°ù¾±³¦²¹ | 4 | columns.0.itemid | ID de ³¾¨¦³Ù°ù¾±³¦²¹. Al configurar el widget en una plantilla de tablero, solo se deben configurar las ³¾¨¦³Ù°ù¾±³¦²¹s configuradas en la plantilla. Comportamiento de par¨¢metros: - obligatorio |
Color base | 1 | columns.0.base_color | C¨®digo de color hexadecimal (por ejemplo, FF0000 ).Predeterminado: "" (±¹²¹³¦¨ª´Ç). |
Los siguientes par¨¢metros de columna son compatibles si el Item configurado es una ³¾¨¦³Ù°ù¾±³¦²¹ de tipo num¨¦rico.
|±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Pantalla|<|0|columns.0.display|1 - (predeterminado) Tal cual;
2 - Barra;
3 - Indicadores.| |Min|<|1|columns.0.min|Cualquier valor num¨¦rico.
Comportamiento del par¨¢metro:
- compatible si Pantalla est¨¢ configurada en "Barra" o "Indicadores"| |Max|<|1|columns.0.max|Cualquier valor num¨¦rico.
Comportamiento del par¨¢metro:
- compatible si Pantalla est¨¢ configurada en "Barra" o "Indicadores"| |Umbrales|<|<|<|<| |<|Color|1|columns.0.thresholds.0.color|C¨®digo de color hexadecimal (por ejemplo, FF0000
).| |^|Umbral|1|columns.0.thresholds.0.threshold|Cualquier valor num¨¦rico. Se admiten Sufijos (por ejemplo, "1d", "2w", "4K", "8G").| |Datos del historial|<|0|columns.0.history|0 - (predeterminado) ´¡³Ü³Ù´Ç³¾¨¢³Ù¾±³¦´Ç;
1 - Historial;
2 - Tendencias.|
Los siguientes par¨¢metros de columna son compatibles si la ²Ñ¨¦³Ù°ù¾±³¦²¹ configurada es una ³¾¨¦³Ù°ù¾±³¦²¹ de tipo car¨¢cter, texto o registro.
|±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Destacados|<|<|<|<| |<|Resaltado|1|columns.0.highlights.0.color|C¨®digo de color hexadecimal (por ejemplo, FF0000
).| |^|Umbral|1|columns.0.highlights.0.pattern|Cualquier expresi¨®n regular.| |Pantalla|<|0|columns.0.display|1 - (predeterminado) Tal cual;
4 - HTML;
5 - Una sola l¨ªnea.| |<|Una sola l¨ªnea|0|columns.0.max_length|Los valores posibles oscilan entre 1 y 500.
Predeterminado: 100.
Comportamiento del par¨¢metro:
- compatible si Pantalla est¨¢ configurada en "Una sola l¨ªnea"| |Usar fuente monoespaciada|<|0|columns.0.monospace_font|0 - (predeterminado) Usar fuente predeterminada;
1 - Usar fuente monoespaciada.| |Mostrar hora local|<|0|columns.0.local_time|0 - (predeterminado) Mostrar marca de tiempo;
1 - Mostrar hora local.
Comportamiento de par¨¢metros:
- compatible si Item est¨¢ configurado como ³¾¨¦³Ù°ù¾±³¦²¹ de tipo de registro y Mostrar marca de tiempo est¨¢ configurado como "Habilitado"|
Los siguientes par¨¢metros de columna son compatibles si el Item configurado es una ³¾¨¦³Ù°ù¾±³¦²¹ de tipo binario.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | tipo | nombre | valor |
---|---|---|---|
Mostrar miniatura | 1 | columns.0.show_thumbnail | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
Los siguientes par¨¢metros de configuraci¨®n avanzada son compatibles con el widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | tipo | nombre | valor | |
---|---|---|---|---|
Nuevos valores | 0 | sortorder | 0 - (predeterminado) Arriba; 1 - Abajo. |
|
Mostrar marca de tiempo | 0 | show_timestamp | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
Mostrar encabezado de columna | 0 | show_column_header | 0 - Desactivado; 1 - Horizontal; 2 - (predeterminado) Vertical. |
|
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 (con su par¨¢metro Reference establecido en "ABCDE ") como fuente de datos.Valor 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 (now , now/d , now/w-1w , etc.).Comportamiento de par¨¢metros: - compatible si Per¨ªodo de tiempo 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 Per¨ªodo de tiempo no est¨¢ establecido |
Los siguientes ejemplos pretenden describir ¨²nicamente la configuraci¨®n de los objetos de campo del widget del tablero para el widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹. Para obtener m¨¢s informaci¨®n sobre c¨®mo configurar un tablero, consulte dashboard.create
.
Configure un widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹ que muestre los datos m¨¢s recientes para dos ³¾¨¦³Ù°ù¾±³¦²¹s num¨¦ricas "42269" y "42270". Adem¨¢s, configure las columnas de las ³¾¨¦³Ù°ù¾±³¦²¹s para que se muestren verticalmente y los nombres de las columnas se muestren horizontalmente; limite la visualizaci¨®n a 15 l¨ªneas de datos e incluya una columna de marca de tiempo separada.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "itemhistory",
"name": "Item history",
"x": "0",
"y": "0",
"width": "18",
"height": "6",
"view_mode": "0",
"fields": [
{
"type": "0",
"name": "layout",
"value": "1"
},
{
"type": "1",
"name": "columns.0.name",
"value": "CPU utilization"
},
{
"type": "4",
"name": "columns.0.itemid",
"value": "42269"
},
{
"type": "1",
"name": "columns.1.name",
"value": "Memory utilization"
},
{
"type": "4",
"name": "columns.1.itemid",
"value": "42270"
},
{
"type": "0",
"name": "show_lines",
"value": "15"
},
{
"type": "0",
"name": "show_timestamp",
"value": "1"
},
{
"type": "0",
"name": "show_column_header",
"value": "1"
},
{
"type": "1",
"name": "reference",
"value": "KIVKD"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Respuesta: