7 Medidor radial

Descripción

Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo del widget de tablero permiten configurar el widget Gauge 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 Gauge, 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.

Parámetro 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.
Métrica 4 itemid.0 ID de métrica.

Comportamiento del parámetro:
- obligatorio si Métrica (Widget) no está configurado
Métrica (Widget) 1 itemid._reference En lugar del ID de métrica:
ABCDE._itemid - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para las métricas.

Comportamiento del parámetro:
- obligatorio si Métrica 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".
Arco de valor 1 value_arc_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).
Fondo de arco 1 empty_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).
Fondo 1 bg_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).
Mostrar 0 show.0 1 - Descripción;
2 - Valor;
3 - Aguja;
4 - Escala;
5 - Valor arco.
< br>Nota: Para configurar varios valores, cree un objeto de campo de widget de tablero para cada valor con un número incrementado en el nombre de la propiedad.

Predeterminado: 1, 2, 4, 5.

Valores "Aguja" y "Escala" no son compatibles si ambos:
- no hay ningún objeto de campo del widget del tablero para Mostrar con el valor "Arco de valor";
- Mostrar arco configuración avanzada está configurado en "Desactivado".

Los parámetros Configuración avanzada para las opciones Mostrar no se admiten si no se configuran objetos de campo del widget de tablero con los valores respectivos.
Reemplazar equipo 1 override_hostid._reference ABCDE._hostid - establece un widget compatible (con su parámetro Reference establezido en "ABCDE") como fuente de datos para los equipos;
DASHBOARD._hostid - configure el tablero selector de equipo como la fuente de datos para los equipos.

Este parámetro no se admite si se configura el widget en una plantilla de tablero.

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 al lugar del threshold en una lista, ordenada en orden ascendente. Sin embargo, si los thresholds 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 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 admitidas: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros de usuario.
< br>Predeterminado: {ITEM.NAME}.
Tamaño 0 desc_size Los valores posibles oscilan entre 1 y 100.

Predeterminado: 15.
Posición vertical 0 desc_v_pos 0 - Arriba;
1 - (predeterminado) Abajo.
Negrita 0 desc_bold 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Color 1 desc_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).
Valor
Lugares decimales 0 decimal_places Los valores posibles van del 1 al 10.

Predeterminado: 2.
Tamaño 0 value_size Los valores posibles oscilan entre 1 y 100.

Predeterminado: 25.
Negrita 0 value_bold 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
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 - Deshabilitado;
1 - (predeterminado) Habilitado.
Unidades (valor) 1 units Cualquier valor de cadena.

Comportamiento del parámetro:
- compatible si Unidades (casilla de verificación) está configurada en "Activado"
Tamaño 0 units_size Los valores posibles oscilan entre 1 y 100.

Predeterminado: 25.

Comportamiento del parámetro:
- compatible si Unidades (casilla de verificación) está configurada en "Habilitado"
Negrita 0 units_bold 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:<br >- compatible si Unidades (casilla de verificación) está configurada en "Activado"
Posición 0 units_pos 0 - Antes del valor;
1 - Por encima del valor;
2 - (predeterminado) Después del valor;
3 - Por debajo del valor.

Comportamiento del parámetro:
- compatible si Unidades (casilla de verificación) está configurada en "Habilitado"

Este parámetro se ignora si se establece en uno 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 de valores
Tamaño del arco 0 value_arc_size Los valores posibles oscilan entre 1 y 100.

Predeterminado: 20.
Aguja
Color 1 needle_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).

Comportamiento de parámetros:
- compatible si se establece un objeto de campo de widget de tablero para Mostrar con el valor "Arco de valor", o Mostrar arco está configurado en "Habilitado"
Escala
Mostrar unidades 0 scale_show_units 0 - Deshabilitado;
1 - (predeterminado) Habilitado.

Comportamiento de parámetros:< br>- compatible si Unidades (casilla de verificación) está configurado en "Habilitado" y un objeto de campo de widget de tablero para Mostrar con el valor "Arco de valor" está configurado, o Mostrar arco está configurado en "Habilitado" "
Tamaño 0 scale_size Los valores posibles oscilan entre 1 y 100.

Predeterminado: 15.

Comportamiento del parámetro:
- compatible si se establece un objeto de campo de widget de tablero para Mostrar con el valor "Arco de valor", o Mostrar arco está configurado en "Habilitado"
Lugares decimales 0 scale_decimal_places Los valores posibles oscilan entre 1 y 10.

Valor predeterminado: 0.

Comportamiento de parámetros :
- compatible si se establece un objeto de campo de widget de tablero para Mostrar con el valor "Arco de valor", o Mostrar arco está configurado en "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) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:< br>- compatible si se establecen Umbrales y se establece un objeto de campo de widget de tablero para Mostrar con el valor "Arco de valor" o Mostrar arco está configurado en "Habilitado"
Mostrar arco 0 th_show_arc 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:< br>- compatible si se establecen Umbrales
Tamaño del arco 0 th_arc_size Los valores posibles oscilan entre 1 y 100.

Valor predeterminado: 5.

Comportamiento del parámetro :
- compatible si Mostrar arco está configurado en "Activado"

Ejemplos

Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Gauge. Para obtener más información sobre cómo configurar un tablero, consulte dashboard.create.

Configuración de un widget Gauge

Configure un widget Gauge que muestre el valor del elemento "44474" (Interfaz enp0s3: Bits enviados). Además, ajuste visualmente el widget con múltiples opciones avanzadas, incluidos los umbrales.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "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
       }

Ver también