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
Se admiten los siguientes parámetros para el widget Gauge.
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Intervalo de actualización | 0 | rf_rate | 0 - Sin actualización; 10 - 10 segundos; 30 - 30 segundos; 60 - (por defecto) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
|
| Elemento | 4 | itemid.0 | ID del Elemento. Comportamiento del parámetro: - obligatorio si Elemento (Widget) no está establecido |
|
| Elemento (Widget) | 1 | itemid._reference | En lugar del ID del Elemento:ABCDE._itemid - establezca un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos para los elementos.Comportamiento del parámetro: - obligatorio si Elemento no está establecido |
|
| Mín | 1 | min | Cualquier valor numérico. Se admiten Sufijos (por ejemplo, "1d", "2w", "4K", "8G"). Por defecto: "0". |
|
| Máx | 1 | max | Cualquier valor numérico. Se admiten Sufijos (por ejemplo, "1d", "2w", "4K", "8G"). Por defecto: "100". |
|
| Arco de valor | 1 | value_arc_color | Código de color hexadecimal (por ejemplo, FF0000).Por defecto: "" (vacío). |
|
| Fondo del arco | 1 | empty_color | Código de color hexadecimal (por ejemplo, FF0000).Por defecto: "" (vacío). |
|
| Fondo | 1 | bg_color | Código de color hexadecimal (por ejemplo, FF0000).Por defecto: "" (vacío). |
|
| Mostrar | 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 de widget de panel para cada valor con un número incrementado en el nombre de la propiedad. Por defecto: 1, 2, 4, 5. Los valores "Aguja" y "Escala" no son compatibles si ambos: - no se establece ningún objeto de campo de widget de panel para Mostrar con el valor "Arco de valor"; - el parámetro de configuración avanzada Mostrar arco está configurado en "Deshabilitado". Los parámetros de configuración avanzada para las opciones de Mostrar no son compatibles si no se establecen objetos de campo de widget de panel con los valores respectivos. |
|
| Anular equipo | 1 | override_hostid._reference | ABCDE._hostid - establezca un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos para los equipos;DASHBOARD._hostid - establezca el selector de equipos del panel como fuente de datos para los equipos.Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
Configuración avanzada
Los siguientes parámetros de configuración avanzada son compatibles con el widget Gauge.
El número en el 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 thresholds 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").
| Parameter | type | name | value |
|---|---|---|---|
| Angle | 0 | angle | Valores posibles: 180 (predeterminado) o 270. |
| Description | |||
| Description | 1 | description | Cualquier valor de cadena, incluidas macros. Macros compatibles: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros de usuario.Predeterminado: {ITEM.NAME}. |
| Size | 0 | desc_size | El rango de valores posibles es de 1 a 100. Predeterminado: 15. |
| Vertical position | 0 | desc_v_pos | 0 - Arriba; 1 - (predeterminado) Abajo. |
| Bold | 0 | desc_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
| Color | 1 | desc_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
| Value | |||
| Decimal places | 0 | decimal_places | El rango de valores posibles es de 1 a 10. Predeterminado: 2. |
| Size | 0 | value_size | El rango de valores posibles es de 1 a 100. Predeterminado: 25. |
| Bold | 0 | value_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
| Color | 1 | value_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
| Units | |||
| Units (checkbox) | 0 | units_show | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. |
| Units (value) | 1 | units | Cualquier valor de cadena. Parameter behavior: - supported si Units (checkbox) está configurado en "Enabled" |
| Size | 0 | units_size | El rango de valores posibles es de 1 a 100. Predeterminado: 25. Parameter behavior: - supported si Units (checkbox) está configurado en "Enabled" |
| Bold | 0 | units_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. Parameter behavior: - supported si Units (checkbox) está configurado en "Enabled" |
| Position | 0 | units_pos | 0 - Antes del valor; 1 - Encima del valor; 2 - (predeterminado) Después del valor; 3 - Debajo del valor. Parameter behavior: - supported si Units (checkbox) está configurado en "Enabled" Este parámetro se ignora si se establece en 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). |
| Value arc | |||
| Arc size | 0 | value_arc_size | El rango de valores posibles es de 1 a 100. Predeterminado: 20. |
| Needle | |||
| Color | 1 | needle_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío).Parameter behavior: - supported si un objeto de campo del widget del dashboard para Show con el valor "Value arc" está configurado, o Show arc está configurado en "Enabled" |
| Scale | |||
| Show units | 0 | scale_show_units | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. Parameter behavior: - supported si Units (checkbox) está configurado en "Enabled" y además se cumple una de estas condiciones: un objeto de campo del widget del dashboard para Show con el valor "Value arc" está configurado, o Show arc está configurado en "Enabled" |
| Size | 0 | scale_size | El rango de valores posibles es de 1 a 100. Predeterminado: 15. Parameter behavior: - supported si un objeto de campo del widget del dashboard para Show con el valor "Value arc" está configurado, o Show arc está configurado en "Enabled" |
| Decimal places | 0 | scale_decimal_places | El rango de valores posibles es de 1 a 10. Predeterminado: 0. Parameter behavior: - supported si un objeto de campo del widget del dashboard para Show con el valor "Value arc" está configurado, o Show arc está configurado en "Enabled" |
| Thresholds | |||
| Color | 1 | thresholds.0.color | Código de color hexadecimal (por ejemplo, FF0000). |
| Threshold | 1 | thresholds.0.threshold | Cualquier valor numérico. Se admiten sufijos (por ejemplo, "1d", "2w", "4K", "8G"). |
| Show labels | 0 | th_show_labels | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. Parameter behavior: - supported si se establecen Thresholds y además se cumple una de estas condiciones: un objeto de campo del widget del dashboard para Show con el valor "Value arc" está configurado o Show arc está configurado en "Enabled" |
| Show arc | 0 | th_show_arc | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. Parameter behavior: - supported si se establecen Thresholds |
| Arc size | 0 | th_arc_size | El rango de valores posibles es de 1 a 100. Predeterminado: 5. Parameter behavior: - supported si Show arc está configurado en "Enabled" |
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
}