Documentation
Table of Contents
12 Valor de la métrica
Descripción
Estos parámetros y los posibles valores de la propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Valor de métrica 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 Valor de métrica, consulte los requisitos de parámetros descritos en las tablas a continuación.
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).|
Descripción
Los siguientes parámetros son compatibles si la Configuración avanzada está configurada en "Activado" y Mostrar está configurado en "Descripción".
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Descripción | 1 | description | Cualquier valor de cadena, incluidas las macros. Macros admitidas: {HOST.*}, {ITEM.*}, {INVENTORY.*}, Macros de usuario. < br>Predeterminado: {ITEM.NAME}. |
| Posición horizontal | 0 | desc_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 | desc_v_pos | 0 - Arriba; 1 - Medio; 2 - (predeterminado) 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 | desc_size | Los valores válidos oscilan entre 1 y 100. Predeterminado: 15. |
| 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
Los siguientes parámetros son compatibles si la Configuración avanzada está establecido en "Activado" y Mostrar está establecido en "Valor".
|Parámetro|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Lugares decimales|<|<|<|<| |<|Lugares decimales|0|decimal_places|Los valores válidos van del 1 al 10.
Predeterminado: 2.| |^|Tamaño|0|decimal_size|Los valores válidos oscilan entre 1 y 100.
Predeterminado: 35.| |Posición|<|<|<|<| |<|Posición horizontal|0|value_h_pos|0 - Izquierda;
1 - (predeterminado) Centro;
2 - Derecha.
Dos o más elementos (Descripción, Valor, Hora) no pueden compartir la misma Posición horizontal y Posición vertical.| |^|Posición vertical|0|value_v_pos|0 - Arriba;
1 - (predeterminado) Medio;
2 - Abajo.
Dos o más elementos (Descripción, Valor, Hora) no pueden compartir la misma Posición horizontal y Posición vertical.| |^|Tamaño|0|value_size|Los valores válidos oscilan entre 1 y 100.
Predeterminado: 45.| |^|Negrita|0|value_bold|0 - Deshabilitado;
1 - (predeterminado) 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.| |^|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.| |^|Tamaño|0|units_size|Los valores válidos oscilan entre 1 y 100.
Predeterminado: 35.| |^|Negrita|0|units_bold|0 - Deshabilitado;
1 - (predeterminado) Habilitado.| |^|Color|1|units_color|Código de color hexadecimal (por ejemplo, FF0000).
Predeterminado: "" (vacío).|
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: