En esta página
6 Medidor
Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo de widget de panel permiten configurar el widget Medidor en los métodos dashboard.create y dashboard.update.
Las propiedades fields del widget no se validan durante la creación o actualización de un panel.
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 Medidor, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
Parámetros
Los siguientes parámetros son compatibles con el widget Gauge.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 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. |
|
| Item | 4 | itemid.0 | ID de Item. Comportamiento del parámetro: - required si Item (Widget) no está configurado |
|
| Item (Widget) | 1 | itemid._reference | En lugar del ID de Item:ABCDE._itemid - establece un widget compatible (con su parámetro Reference configurado como "ABCDE") como fuente de datos para los items.Comportamiento del parámetro: - required si Item no está configurado |
|
| Min | 1 | min | Cualquier valor numérico. Se admiten sufijos (por ejemplo, "1d", "2w", "4K", "8G"). Predeterminado: "0". |
|
| Max | 1 | max | Cualquier valor numérico. Se admiten sufijos (por ejemplo, "1d", "2w", "4K", "8G"). Predeterminado: "100". |
|
| Value arc | 1 | value_arc_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
|
| Arc background | 1 | empty_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
|
| Background | 1 | bg_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
|
| Show | 0 | show.0 | 1 - Descripción; 2 - Valor; 3 - Aguja; 4 - Escala; 5 - Arco de valor. Nota: Para configurar varios valores, cree un objeto de campo del widget del dashboard para cada valor con un número incrementado en el nombre de la propiedad. Predeterminado: 1, 2, 4, 5. Los valores "Aguja" y "Escala" no son compatibles si se cumplen ambas condiciones: - no se ha configurado ningún objeto de campo del widget del dashboard para Show con el valor "Arco de valor"; - el parámetro Show arc de configuración avanzada está configurado como "Deshabilitado". Los parámetros de configuración avanzada para las opciones de Show no son compatibles si no se han configurado objetos de campo del widget del dashboard con los valores respectivos. |
|
| Override host | 1 | override_hostid._reference | ABCDE._hostid - establece un widget compatible (con su parámetro Reference configurado como "ABCDE") como fuente de datos para hosts;DASHBOARD._hostid - establece el selector de Host del dashboard como fuente de datos para hosts.Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
Configuración avanzada
Los siguientes parámetros de configuración avanzada son compatibles con el widget Gauge.
El número del nombre de la propiedad Thresholds (por ejemplo, thresholds.0.color) hace referencia a la posición del umbral en una lista ordenada de forma ascendente.
Sin embargo, si los umbrales se configuran en un orden diferente, los valores se ordenarán de forma ascendente después de actualizar la configuración del widget en el frontend de Zabbix
(por ejemplo, "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Ángulo | 0 | angle | Valores posibles: 180 (predeterminado) o 270. |
| Descripción | |||
| Descripción | 1 | description | Cualquier valor de cadena, incluidas las macros. Macros compatibles: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros de usuario. Predeterminado: {ITEM.NAME}. |
| Tamaño | 0 | desc_size | Los valores posibles van de 1 a 100. Predeterminado: 15. |
| Posición vertical | 0 | desc_v_pos | 0 - Arriba; 1 - (predeterminado) Abajo. |
| Negrita | 0 | desc_bold | 0 - (predeterminado) Deshabilitada; 1 - Habilitada. |
| Color | 1 | desc_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
| Valor | |||
| Posiciones decimales | 0 | decimal_places | Los valores posibles van de 1 a 10. Predeterminado: 2. |
| Tamaño | 0 | value_size | Los valores posibles van de 1 a 100. Predeterminado: 25. |
| Negrita | 0 | value_bold | 0 - (predeterminado) Deshabilitada; 1 - Habilitada. |
| Color | 1 | value_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
| Unidades | |||
| Unidades (casilla de verificación) | 0 | units_show | 0 - Deshabilitadas; 1 - (predeterminado) Habilitadas. |
| Unidades (valor) | 1 | units | Cualquier valor de cadena. Comportamiento del parámetro: - compatible si Unidades (casilla de verificación) está configurado como "Habilitadas" |
| Tamaño | 0 | units_size | Los valores posibles van de 1 a 100. Predeterminado: 25. Comportamiento del parámetro: - compatible si Unidades (casilla de verificación) está configurado como "Habilitadas" |
| Negrita | 0 | units_bold | 0 - (predeterminado) Deshabilitada; 1 - Habilitada. Comportamiento del parámetro: - compatible si Unidades (casilla de verificación) está configurado como "Habilitadas" |
| Posición | 0 | units_pos | 0 - Antes del valor; 1 - Encima del valor; 2 - (predeterminado) Después del valor; 3 - Debajo del valor. Comportamiento del parámetro: - compatible si Unidades (casilla de verificación) está configurado como "Habilitadas" Este parámetro se ignora si se configura con una de las siguientes unidades relacionadas con el tiempo: unixtime, uptime, s. |
| Color | 1 | units_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
| Arco del valor | |||
| Tamaño del arco | 0 | value_arc_size | Los valores posibles van de 1 a 100. Predeterminado: 20. |
| Aguja | |||
| Color | 1 | needle_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío).Comportamiento del parámetro: - compatible si se configura un objeto de campo del widget del dashboard para Mostrar con el valor "Arco del valor", o si Mostrar arco está configurado como "Habilitado" |
| Escala | |||
| Mostrar unidades | 0 | scale_show_units | 0 - Deshabilitadas; 1 - (predeterminado) Habilitadas. Comportamiento del parámetro: - compatible si Unidades (casilla de verificación) está configurado como "Habilitadas" y se configura un objeto de campo del widget del dashboard para Mostrar con el valor "Arco del valor", o si Mostrar arco está configurado como "Habilitado" |
| Tamaño | 0 | scale_size | Los valores posibles van de 1 a 100. Predeterminado: 15. Comportamiento del parámetro: - compatible si se configura un objeto de campo del widget del dashboard para Mostrar con el valor "Arco del valor", o si Mostrar arco está configurado como "Habilitado" |
| Posiciones decimales | 0 | scale_decimal_places | Los valores posibles van de 1 a 10. Predeterminado: 0. Comportamiento del parámetro: - compatible si se configura un objeto de campo del widget del dashboard para Mostrar con el valor "Arco del valor", o si Mostrar arco está configurado como "Habilitado" |
| Umbrales | |||
| Color | 1 | thresholds.0.color | Código de color hexadecimal (por ejemplo, FF0000). |
| Umbral | 1 | thresholds.0.threshold | Cualquier valor numérico. Se admiten sufijos (por ejemplo, "1d", "2w", "4K", "8G"). |
| Mostrar etiquetas | 0 | th_show_labels | 0 - (predeterminado) Deshabilitadas; 1 - Habilitadas. Comportamiento del parámetro: - compatible si se configuran Umbrales y se configura un objeto de campo del widget del dashboard para Mostrar con el valor "Arco del valor", o si Mostrar arco está configurado como "Habilitado" |
| Mostrar arco | 0 | th_show_arc | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. Comportamiento del parámetro: - compatible si se configuran Umbrales |
| Tamaño del arco | 0 | th_arc_size | Los valores posibles van de 1 a 100. Predeterminado: 5. Comportamiento del parámetro: - compatible si Mostrar arco está configurado como "Habilitado" |
Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Indicador.
Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
Configuración de un widget Gauge
Configure un widget Gauge que muestre el valor de la métrica "44474" (Interfaz enp0s3: Bits enviados). Además, ajuste visualmente el widget con múltiples opciones avanzadas, incluidos los umbrales.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "Mi panel",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "gauge",
"name": "Gauge",
"x": 0,
"y": 0,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 44474
},
{
"type": 1,
"name": "min",
"value": "100000"
},
{
"type": 1,
"name": "max",
"value": "1000000"
},
{
"type": 0,
"name": "show.0",
"value": 1
},
{
"type": 0,
"name": "show.1",
"value": 2
},
{
"type": 0,
"name": "show.2",
"value": 3
},
{
"type": 0,
"name": "show.4",
"value": 4
},
{
"type": 0,
"name": "show.5",
"value": 5
},
{
"type": 0,
"name": "angle",
"value": 270
},
{
"type": 0,
"name": "desc_size",
"value": 10
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 0,
"name": "decimal_places",
"value": 0
},
{
"type": 0,
"name": "value_bold",
"value": 1
},
{
"type": 0,
"name": "units_size",
"value": 15
},
{
"type": 0,
"name": "units_pos",
"value": 3
},
{
"type": 1,
"name": "needle_color",
"value": "3C3C3C"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "FF465C"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "700000"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "FFD54F"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "500000"
},
{
"type": 1,
"name": "thresholds.2.color",
"value": "0EC9AC"
},
{
"type": 1,
"name": "thresholds.2.threshold",
"value": "100000"
},
{
"type": 0,
"name": "th_show_labels",
"value": 1
},
{
"type": 0,
"name": "th_show_arc",
"value": 1
},
{
"type": 0,
"name": "th_arc_size",
"value": 15
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}