Esta es una traducción de la página de documentación original en español. Ayúdanos a mejorarla.

12 Valor de la métrica

Description

These parameters and the possible property values for the respective dashboard widget field objects allow to configure the Item value widget in dashboard.create and dashboard.update methods.

Parámetros

Los siguientes parámetros son compatibles con el widget Valor de métrica.

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
(obligatorio)
4 itemid ID de métrica.
Mostrar 0 show 1 - Descripción;
2 - Valor;
3 - Hora;
4 - Indicador de cambio.

Predeterminado: 1, 2, 3, 4 (todo habilitado).

Nota: Para configurar múltiples valores, cree un objeto de campo de widget de panel para cada valor.
Métrica dinámica 0 dynamic 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Configuración avanzada 0 adv_conf 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Configuración avanzada

Los siguientes parámetros son compatibles si Configuración avanzada está configurado en "Activado".

|Parámetro|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Color de fondo|<|1|bg_color|Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).|

Description

The following parameters are supported if Advanced configuration is set to "Enabled", and Show is set to "Description".

Parameter type name value
Description 1 description Any string value, including macros.
Supported macros: {HOST.*}, {ITEM.*}, {INVENTORY.*}, User macros.

Default: {ITEM.NAME}.
Horizontal position 0 desc_h_pos 0 - Left;
1 - (default) Center;
2 - Right.

Two or more elements (Description, Value, Time) cannot share the same Horizontal position and Vertical position.
Vertical position 0 desc_v_pos 0 - Top;
1 - Middle;
2 - (default) Bottom.

Two or more elements (Description, Value, Time) cannot share the same Horizontal position and Vertical position.
Size 0 desc_size Valid values range from 1-100.

Default: 15.
Bold 0 desc_bold 0 - (default) Disabled;
1 - Enabled.
Color 1 desc_color Hexadecimal color code (e.g. FF0000).

Default: "" (empty).
Value

The following parameters are supported if Advanced configuration is set to "Enabled", and Show is set to "Value".

Parameter type name value
Decimal places
Decimal places 0 decimal_places Valid values range from 1-10.

Default: 2.
Size 0 decimal_size Valid values range from 1-100.

Default: 35.
Position
Horizontal position 0 value_h_pos 0 - Left;
1 - (default) Center;
2 - Right.

Two or more elements (Description, Value, Time) cannot share the same Horizontal position and Vertical position.
Vertical position 0 value_v_pos 0 - Top;
1 - (default) Middle;
2 - Bottom.

Two or more elements (Description, Value, Time) cannot share the same Horizontal position and Vertical position.
Size 0 value_size Valid values range from 1-100.

Default: 45.
Bold 0 value_bold 0 - Disabled;
1 - (default) Enabled.
Color 1 value_color Hexadecimal color code (e.g. FF0000).

Default: "" (empty).
Units
Units (checkbox) 0 units_show 0 - Disabled;
1 - (default) Enabled.
Units (value) 1 units Any string value.
Position 0 units_pos 0 - Before value;
1 - Above value;
2 - (default) After value;
3 - Below value.
Size 0 units_size Valid values range from 1-100.

Default: 35.
Bold 0 units_bold 0 - Disabled;
1 - (default) Enabled.
Color 1 units_color Hexadecimal color code (e.g. FF0000).

Default: "" (empty).
Tiempo

Los siguientes parámetros son compatibles si Configuración avanzada está configurado en "Activado" y Mostrar está configurado en "Hora".

Parámetro tipo nombre valor
Posición horizontal 0 time_h_pos 0 - Izquierda;
1 - (predeterminado) Centro;
2 - Derecha.

Dos o más elementos (Descripción, Valor, Hora) no puede compartir la misma posición horizontal y posición vertical.
Posición vertical 0 time_v_pos 0 - (predeterminado) Arriba;
1 - Medio;
2 - Abajo.

Dos o más elementos (Descripción, Valor, Tiempo) no puede compartir la misma posición horizontal y posición vertical.
Tamaño 0 time_size Los valores válidos 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: "" (vacío).
Cambiar indicador

Los siguientes parámetros son compatibles si Configuración avanzada está configurado en "Habilitado" y Mostrar está configurado en "Indicador de cambio".

Parámetro tipo nombre valor
Indicador de cambio ↑ color 1 up_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).
Cambiar indicador ↓ color 1 down_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).
Cambiar indicador ↕ color 1 updown_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).

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 métrica. Para obtener más información sobre cómo configurar un tablero, consulte dashboard.create.

Configuración de un widget Valor de la métrica

Configure un widget Valor de la métrica que muestre el valor de la métrica "42266" (disponibilidad del agente Zabbix). Además, ajuste visualmente el widget con múltiples opciones avanzadas.

Solicitud:

{
           "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": 4,
                               "height": 3,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 4,
                                       "name": "itemid",
                                       "value": 42266
                                   },
                                   {
                                       "type": 0,
                                       "name": "show",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "show",
                                       "value": 2
                                   },
                                   {
                                       "type": 0,
                                       "name": "show",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "adv_conf",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "bg_color",
                                       "value": "D1C4E9"
                                   },
                                   {
                                       "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"
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Ver también