Documentation
Table of Contents
22 Problemas
Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget del tablero permiten configurar el widget Problemas 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 los 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 Problemas, consulte el comportamiento de los parámetros descrito en las tablas siguientes.
Parámetros
Los siguientes parámetros son compatibles con el widget Problemas.
| 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. |
|
| Mostrar | 0 | show | 1 - (predeterminado) Problemas recientes; 2 - Historial; 3 - Problemas. |
|
| Grupos de equipos | 2 | groupids.0 | ID de grupo de equipos. Nota: Para configurar varios grupos de equipos, cree un objeto de campo de widget de tablero para cada grupo de equipos con un número incrementado en el nombre de la propiedad. Este parámetro no se admite si se configura el widget en una plantilla de tablero. |
|
| Excluir grupos de equipos | 2 | exclude_groupids.0 | ID de grupo de equipos ID. Nota: Para excluir varios grupos de equipos, cree un objeto de campo de widget de tablero para cada grupo de equipos con un número incrementado en el nombre de la propiedad. Este parámetro no se admite si se configura el widget en una plantilla de tablero. |
|
| Equipos | 3 | hostids.0 | ID de equipo. Nota: Para configurar varios equipos, cree un objeto de campo de widget de tablero para cada equipo con un número incrementado en el nombre de la propiedad. Para varios equipos, el parámetro Grupos de equipos no debe estar configurado en absoluto o configurarse con al menos un grupo de equipos al que pertenecen los equipos configurados. Este parámetro no se admite si se configura el widget en una plantilla de tablero. |
|
| Problema | 1 | problem | Nombre del evento de problema (no distingue entre mayúsculas y minúsculas, nombre completo o parte del mismo). | |
| Gravedad | 0 | severities.0 | 0 - No clasificado; 1 - Información; 2 - Advertencia; 3 - Promedio; 4 - Alto; 5 - Desastre. Valor predeterminado: vacío (todo habilitado). Nota: para configurar varios valores, cree un objeto de campo del widget de tablero para cada valor con un número incrementado en el nombre de la propiedad. |
|
| Etiquetas problemáticas | ||||
| Tipo de evaluación | 0 | evaltype | 0 - (predeterminado) Y/O; 2 - O. |
|
| Nombre de etiqueta | 1 | tags.0.tag | Cualquier valor de cadena. Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas. Comportamiento de parámetros: - obligatorio si se configuran Etiquetas de problema |
|
| Operador | 0 | tags.0.operator | 0 - Contiene; 1 - Es igual; 2 - No contiene; 3 - No es igual; 4 - Existe ; 5 - No existe. Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de problema |
|
| Valor de etiqueta | 1 | tags.0.value | Cualquier valor de cadena. Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas. Comportamiento de parámetros: - obligatorio si se configuran Etiquetas de problema |
|
| Mostrar etiquetas | 0 | show_tags | 0 - (predeterminado) Ninguno; 1 - 1; 2 - 2; 3 - 3. |
|
| Nombre de etiqueta (formato) | 0 | tag_name_format | 0 - (predeterminado) Completo; 1 - Acortado; 2 - Ninguno. Comportamiento del parámetro: - compatible si Mostrar etiquetas está configurado en "1", "2" o "3" |
|
| Prioridad de visualización de etiquetas | 1 | tag_priority | Lista de etiquetas separadas por comas. Comportamiento de parámetros: - compatible si Mostrar etiquetas está configurado en "1", "2" o "3" |
|
| Mostrar datos operativos | 0 | show_opdata | 0 - (predeterminado) Ninguno; 1 - Por separado; 2 - Con nombre del problema. |
|
| Mostrar problemas suprimidos | 0 | show_suppressed | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Estado de confirmación | 0 | acknowledgement_status | 0 - (predeterminado) todos; 1 - No reconocido; 2 - Reconocido. |
|
| Por mí | 0 | acknowledged_by_me | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Ordenar entradas por | 0 | sort_triggers | 1 - Gravedad (descendente); 2 - Host (ascendente); 3 - Tiempo (ascendente); 4 - (predeterminado) Tiempo (descendente); 13 - Gravedad (ascendente); 14 - Anfitrión (descendente); 15 - Problema (ascendente); 16 - Problema (descendente). <br >Para todos los valores, excepto "Tiempo (descendente)" y "Tiempo (ascendente)", el parámetro Mostrar línea de tiempo debe estar configurado en "Desactivado". Valores "Host (ascendente)" y "Host (descendente)" no se admiten si se configura el widget en un panel de plantilla. |
|
| Mostrar línea de tiempo | 0 | show_timeline | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. Comportamiento de parámetros : - compatible si Ordenar entradas por está configurado en "Hora (descendente)" o "Hora (ascendente)" |
|
| Mostrar líneas | 0 | show_lines | Los valores posibles oscilan entre 1 y 100. Predeterminado: 25. |
|
Ejemplos
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Problemas. Para obtener más información sobre cómo configurar un tablero, consulte dashboard.create.
Configurando un widget Problemas
Configure un widget Problemas que muestre problemas para el grupo de equipos "4" que cumplan las siguientes condiciones:
- Problemas que tienen una etiqueta con el nombre "alcance" que contiene valores "rendimiento" o "disponibilidad", o "capacidad".
- Problemas que tienen las siguientes gravedades: "Advertencia", "Promedio", "Alta", "Desastre".
Además, configure el widget para mostrar etiquetas y datos operativos.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "problems",
"name": "Problems",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 1,
"name": "tags.0.tag",
"value": "alcance"
},
{
"type": 0,
"name": "tags.0.operator",
"value": 0
},
{
"type": 1,
"name": "tags.0.value",
"value": "rendimiento"
},
{
"type": 1,
"name": "tags.1.tag",
"value": "scope"
},
{
"type": 0,
"name": "tags.1.operator",
"value": 0
},
{
"type": 1,
"name": "tags.1.value",
"value": "disponibilidad"
},
{
"type": 1,
"name": "tags.2.tag",
"value": "scope"
},
{
"type": 0,
"name": "tags.2.operator",
"value": 0
},
{
"type": 1,
"name": "tags.2.value",
"value": "capacidad"
},
{
"type": 0,
"name": "severities.0",
"value": 2
},
{
"type": 0,
"name": "severities.1",
"value": 3
},
{
"type": 0,
"name": "severities.2",
"value": 4
},
{
"type": 0,
"name": "severities.3",
"value": 5
},
{
"type": 0,
"name": "show_tags",
"value": 1
},
{
"type": 0,
"name": "show_opdata",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta: