Documentation
Table of Contents
17 Valor de ³¾¨¦³Ù°ù¾±³¦²¹
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
Estos par¨¢metros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Valor de la ³¾¨¦³Ù°ù¾±³¦²¹ 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 los 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 Valor de la ³¾¨¦³Ù°ù¾±³¦²¹, consulte el comportamiento de los par¨¢metros que se describen en las tablas siguientes.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
Los siguientes par¨¢metros son compatibles con el widget Valor 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. |
| ²Ñ¨¦³Ù°ù¾±³¦²¹ | 4 | itemid.0 | Id de ³¾¨¦³Ù°ù¾±³¦²¹. Comportamiento del par¨¢metro : - obligatorio |
| Mostrar | 0 | show.0 | 1 - ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô; 2 - Valor; 3 - Hora; 4 - Indicador de cambio. Predeterminado: 1, 2, 3 , 4 (todos habilitados). Nota: Para configurar m¨²ltiples valores, cree un objeto de campo de widget de tablero para cada valor con un n¨²mero incrementado en el nombre de la propiedad. |
| Reemplazar equipo | 1 | override_hostid._reference | ABCDE._hostid - establece un widget compatible (Navegador de equipo con su par¨¢metro Reference establecido en "ABCDE") como fuente de datos que contiene el equipo.< br>DASHBOARD._hostid: establece el Selector de equipo del tablero como la fuente de datos que contiene el equipo.Este par¨¢metro es no es compatible si se configura el widget en una plantilla de tablero. |
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô avanzada
Los siguientes par¨¢metros de configuraci¨®n avanzada son compatibles con el widget Valor de la ³¾¨¦³Ù°ù¾±³¦²¹.
El n¨²mero en el nombre de la propiedad Thresholds (por ejemplo, thresholds.0.color) hace referencia al lugar del umbral en una lista, ordenada en orden ascendente. Sin embargo, si los umbrales se configuran en un orden diferente, los valores se ordenar¨¢n en orden ascendente despu¨¦s de actualizar la configuraci¨®n del widget en la interfaz de Áú»¢¶Ä²©. (por ejemplo,"thresholds.0.threshold":"5" ¡ú "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" ¡ú "thresholds.1.threshold": "5").
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | tipo | nombre | valor | |
|---|---|---|---|---|
| Color de fondo | 1 | bg_color | C¨®digo de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (±¹²¹³¦¨ª´Ç). |
|
| Umbrales | ||||
| Color | 1 | thresholds.0.color | C¨®digo de color hexadecimal (por ejemplo, FF0000). |
|
| Umbral | 1 | thresholds.0.threshold | Cualquier valor de cadena. | |
| Funci¨®n de agregaci¨®n | 0 | aggregate_function | 0 - (predeterminado) no utilizado; 1 - min; 2 - max; 3 - promedio; 4 - recuento; 5 - suma; 6 - primero; 7 - ¨²ltimo. |
|
| Per¨ªodo de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establece el selector de per¨ªodo de tiempo como fuente de datos.ABCDE._timeperiod - establecer un widget compatible (Graph, Graph (classic) o Graph prototipo con su par¨¢metro reference igual a ABCDE) como fuente de datos.Predeterminado: DASHBOARD._timeperiodComo alternativa, puede establecer el per¨ªodo de tiempo solo en los par¨¢metros Desde y Hasta. Comportamiento de par¨¢metros: - compatible si la Funci¨®n de agregaci¨®n est¨¢ configurada en "min", "max", "avg", "count", "sum", "first", "last" |
|
| 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 El per¨ªodo de tiempo no est¨¢ establecido y la Funci¨®n de agregaci¨®n est¨¢ configurada en "min", "max", "avg", "count", "sum", "first", "last" |
|
| 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 El per¨ªodo de tiempo no est¨¢ establecido y la Funci¨®n de agregaci¨®n est¨¢ configurada en "min", "max", "avg", "count", "sum", "first", "last" |
|
| Datos del historial | 0 | history | 0 - (predeterminado) Auto; 1 - Historial; 2 - Tendencias. |
|
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
Los siguientes par¨¢metros son compatibles si °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô avanzada est¨¢ configurado en "Activado" y Mostrar est¨¢ configurado en "¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô".
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | tipo | nombre | valor |
|---|---|---|---|
| Description | 1 | »å±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | Cualquier valor de cadena, incluidas las macros. Macros admitidas: {HOST.*}, {ITEM.*}, {INVENTORY.*}, Macros de usuario. < br>Predeterminado: {ITEM.NAME}. |
| Horizontal position | 0 | desc_h_pos | 0 - Izquierda; 1 - (predeterminado) Centro; 2 - Derecha. Dos o m¨¢s elementos (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô, Valor, Hora) no puede compartir la misma posici¨®n horizontal y posici¨®n vertical. |
| Vertical position | 0 | desc_v_pos | 0 - Arriba; 1 - Medio; 2 - (predeterminado) Abajo. Dos o m¨¢s elementos (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô, Valor, Tiempo) no puede compartir la misma posici¨®n horizontal y posici¨®n vertical. |
| Size | 0 | desc_size | Los valores v¨¢lidos oscilan entre 1 y 100. Predeterminado: 15. |
| Bold | 0 | desc_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
| Color | 1 | desc_color | C¨®digo de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (±¹²¹³¦¨ª´Ç). |
Valor
Los siguientes par¨¢metros de configuraci¨®n avanzada son compatibles si Mostrar est¨¢ establecido en "Valor".
|±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Lugares decimales|<|<|<|<| |<|Lugares decimales|0|decimal_places|Los valores posibles van del 1 al 10.
Predeterminado: 2.| |^|Tama?o|0|decimal_size|Los valores posibles oscilan entre 1 y 100.
Predeterminado: 35.| |±Ê´Ç²õ¾±³¦¾±¨®²Ô|<|<|<|<| |<|±Ê´Ç²õ¾±³¦¾±¨®²Ô horizontal|0|value_h_pos|0 - Izquierda;
1 - (predeterminado) Centro;
2 - Derecha.
Dos o m¨¢s elementos (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô, Valor, Hora) no pueden compartir la misma ±Ê´Ç²õ¾±³¦¾±¨®²Ô horizontal y ±Ê´Ç²õ¾±³¦¾±¨®²Ô vertical.| |^|±Ê´Ç²õ¾±³¦¾±¨®²Ô vertical|0|value_v_pos|0 - Arriba;
1 - (predeterminado) Medio;
2 - Abajo.
Dos o m¨¢s elementos (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô, Valor, Hora) no pueden compartir la misma ±Ê´Ç²õ¾±³¦¾±¨®²Ô horizontal y ±Ê´Ç²õ¾±³¦¾±¨®²Ô vertical.| |^|Tama?o|0|value_size|Los valores posibles oscilan entre 1 y 100.
Predeterminado: 45.| |^|Negrita|0|value_bold|0 - Deshabilitado;
1 - (predeterminado) Habilitado.| |^|Color|1|value_color|C¨®digo de color hexadecimal (por ejemplo, FF0000).
Predeterminado: "" (±¹²¹³¦¨ª´Ç).| |Unidades|<|<|<|<| |<|Unidades (casilla de verificaci¨®n)|0|units_show|0 - Deshabilitado;
1 - (predeterminado) Habilitado.| |^|Unidades (valor)|1|unidades|Cualquier valor de cadena.| |^|±Ê´Ç²õ¾±³¦¾±¨®²Ô|0|units_pos|0 - Antes del valor;
1 - Por encima del valor;
2 - (predeterminado) Despu¨¦s del valor;
3 - Por debajo del valor.| |^|Tama?o|0|units_size|Los valores posibles oscilan entre 1 y 100.
Predeterminado: 35.| |^|Negrita|0|units_bold|0 - Deshabilitado;
1 - (predeterminado) Habilitado.| |^|Color|1|units_color|C¨®digo de color hexadecimal (por ejemplo, FF0000).
Predeterminado: "" (±¹²¹³¦¨ª´Ç).|
Tiempo
Los siguientes par¨¢metros de configuraci¨®n avanzada son compatibles si Mostrar est¨¢ configurado en "Hora".
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | tipo | nombre | valor |
|---|---|---|---|
| ±Ê´Ç²õ¾±³¦¾±¨®²Ô horizontal | 0 | time_h_pos | 0 - Izquierda; 1 - (predeterminado) Centro; 2 - Derecha. Dos o m¨¢s elementos (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô, Valor, Hora) no puede compartir la misma posici¨®n horizontal y posici¨®n vertical. |
| ±Ê´Ç²õ¾±³¦¾±¨®²Ô vertical | 0 | time_v_pos | 0 - (predeterminado) Arriba; 1 - Medio; 2 - Abajo. Dos o m¨¢s elementos (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô, Valor, Tiempo) no puede compartir la misma posici¨®n horizontal y posici¨®n vertical. |
| Tama?o | 0 | time_size | Los valores posibles oscilan entre 1 y 100. Predeterminado: 15. |
| Negrita | 0 | time_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
| Color | 1 | time_color | C¨®digo de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (±¹²¹³¦¨ª´Ç). |
Cambiar indicador
Los siguientes par¨¢metros de configuraci¨®n avanzada son compatibles si Mostrar est¨¢ configurado en "Indicador de cambio".
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | tipo | nombre | valor |
|---|---|---|---|
| Indicador de cambio ¡ü color | 1 | up_color | C¨®digo de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (±¹²¹³¦¨ª´Ç). |
| Cambiar indicador ¡ý color | 1 | down_color | C¨®digo de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (±¹²¹³¦¨ª´Ç). |
| Cambiar indicador ? color | 1 | updown_color | C¨®digo de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (±¹²¹³¦¨ª´Ç). |
Sparkline
The following advanced configuration parameters are supported if Show is set to "Sparkline".
| Parameter | type | name | value | |
|---|---|---|---|---|
| Width | 0 | sparkline.width | Possible values range from 0-10. Default: 1. |
|
| Fill | 0 | sparkline.fill | Possible values range from 0-10. Default: 3. |
|
| Color | 1 | sparkline.color | Hexadecimal color code (e.g. FF0000).Default: 42A5F5. |
|
| Time period | 1 | sparkline.time_period._reference | DASHBOARD._timeperiod - set the Time period selector as the data source;ABCDE._timeperiod - set a compatible widget (with its reference parameter equal to ABCDE) as the data source.Default: DASHBOARD._timeperiodAlternatively, you can set the time period only in the From and To parameters. |
|
| From | 1 | sparkline.time_period.from | Valid time string in absolute (YYYY-MM-DD hh:mm:ss) or relative time syntax (now, now/d, now/w-1w, etc.). |
|
| To | 1 | sparkline.time_period.to | Valid time string in absolute (YYYY-MM-DD hh:mm:ss) or relative time syntax (now, now/d, now/w-1w, etc.). |
|
| History data | 0 | sparkline.history | 0 - (default) Auto; 1 - History; 2 - Trends. |
|
Ejemplos
Los siguientes ejemplos pretenden describir ¨²nicamente la configuraci¨®n de los objetos de campo del widget del tablero para el widget Valor de la ³¾¨¦³Ù°ù¾±³¦²¹. Para obtener m¨¢s informaci¨®n sobre c¨®mo configurar un tablero, consulte dashboard.create.
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô de un widget Valor de ³¾¨¦³Ù°ù¾±³¦²¹
Configure un widget Valor de ³¾¨¦³Ù°ù¾±³¦²¹ que muestre el valor de la ³¾¨¦³Ù°ù¾±³¦²¹ "42266" (disponibilidad del agente Áú»¢¶Ä²©). Adem¨¢s, ajuste visualmente el widget con m¨²ltiples opciones avanzadas, incluido un color de fondo din¨¢mico que cambia seg¨²n el estado de disponibilidad del agente Áú»¢¶Ä²©.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "item",
"name": "Item value",
"x": 0,
"y": 0,
"width": 12,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 42266
},
{
"type": 0,
"name": "show.0",
"value": 1
},
{
"type": 0,
"name": "show.1",
"value": 2
},
{
"type": 0,
"name": "show.2",
"value": 3
},
{
"type": 1,
"name": "description",
"value": "Agent status"
},
{
"type": 0,
"name": "desc_h_pos",
"value": 0
},
{
"type": 0,
"name": "desc_v_pos",
"value": 0
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 1,
"name": "desc_color",
"value": "F06291"
},
{
"type": 0,
"name": "value_h_pos",
"value": 0
},
{
"type": 0,
"name": "value_size",
"value": 25
},
{
"type": 1,
"name": "value_color",
"value": "FFFF00"
},
{
"type": 0,
"name": "units_show",
"value": 0
},
{
"type": 0,
"name": "time_h_pos",
"value": 2
},
{
"type": 0,
"name": "time_v_pos",
"value": 2
},
{
"type": 0,
"name": "time_size",
"value": 10
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 1,
"name": "time_color",
"value": "9FA8DA"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "E1E1E1"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "0"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "D1C4E9"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "1"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta: