Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

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.

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

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

Comportamiento del parámetro:
- requerido si Métrica 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 de 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 múltiples 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.
Sobrescribir equipo 1 override_hostid._reference ABCDE._hostid - establece un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos para equipos;
DASHBOARD._hostid - establece el selector de Equipo del panel como fuente de datos para 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 para 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 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 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 (por defecto) o 270.
Descripción
Descripción 1 description Cualquier valor de cadena, incluyendo macros.
Macros soportadas: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros de usuario.

Por defecto: {ITEM.NAME}.
Tamaño 0 desc_size El rango de valores posibles es de 1-100.

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

Por defecto: "" (vacío).
Valor
Decimales 0 decimal_places El rango de valores posibles es de 1-10.

Por defecto: 2.
Tamaño 0 value_size El rango de valores posibles es de 1-100.

Por defecto: 25.
Negrita 0 value_bold 0 - (por defecto) Deshabilitado;
1 - Habilitado.
Color 1 value_color Código de color hexadecimal (por ejemplo, FF0000).

Por defecto: "" (vacío).
Unidades
Unidades (checkbox) 0 units_show 0 - Deshabilitado;
1 - (por defecto) Habilitado.
Unidades (valor) 1 units Cualquier valor de cadena.

Comportamiento del parámetro:
- soportado si Unidades (checkbox) está establecido en "Habilitado"
Tamaño 0 units_size El rango de valores posibles es de 1-100.

Por defecto: 25.

Comportamiento del parámetro:
- soportado si Unidades (checkbox) está establecido en "Habilitado"
Negrita 0 units_bold 0 - (por defecto) Deshabilitado;
1 - Habilitado.

Comportamiento del parámetro:
- soportado si Unidades (checkbox) está establecido en "Habilitado"
Posición 0 units_pos 0 - Antes del valor;
1 - Encima del valor;
2 - (por defecto) Después del valor;
3 - Debajo del valor.

Comportamiento del parámetro:
- soportado si Unidades (checkbox) está establecido en "Habilitado"

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).

Por defecto: "" (vacío).
Arco de valor
Tamaño del arco 0 value_arc_size El rango de valores posibles es de 1-100.

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

Por defecto: "" (vacío).

Comportamiento del parámetro:
- soportado si se establece un objeto de campo de widget de dashboard para Mostrar con el valor "Arco de valor", o Mostrar arco está establecido en "Habilitado"
Escala
Mostrar unidades 0 scale_show_units 0 - Deshabilitado;
1 - (por defecto) Habilitado.

Comportamiento del parámetro:
- soportado si Unidades (checkbox) está establecido en "Habilitado" y se establece un objeto de campo de widget de dashboard para Mostrar con el valor "Arco de valor", o Mostrar arco está establecido en "Habilitado"
Tamaño 0 scale_size El rango de valores posibles es de 1-100.

Por defecto: 15.

Comportamiento del parámetro:
- soportado si se establece un objeto de campo de widget de dashboard para Mostrar con el valor "Arco de valor", o Mostrar arco está establecido en "Habilitado"
Decimales 0 scale_decimal_places El rango de valores posibles es de 1-10.

Por defecto: 0.

Comportamiento del parámetro:
- soportado si se establece un objeto de campo de widget de dashboard para Mostrar con el valor "Arco de valor", o Mostrar arco está establecido 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 - (por defecto) Deshabilitado;
1 - Habilitado.

Comportamiento del parámetro:
- soportado si se establecen Umbrales y se establece un objeto de campo de widget de dashboard para Mostrar con el valor "Arco de valor" o Mostrar arco está establecido en "Habilitado"
Mostrar arco 0 th_show_arc 0 - (por defecto) Deshabilitado;
1 - Habilitado.

Comportamiento del parámetro:
- soportado si se establecen Umbrales
Tamaño del arco 0 th_arc_size El rango de valores posibles es de 1-100.

Por defecto: 5.

Comportamiento del parámetro:
- soportado si Mostrar arco está establecido en "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.

Solicitud:

{
           "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
       }

Véase también