23 Problemas

Descripción

Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo del widget de dashboard permiten configurar el widget Problemas 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 dashboard. 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 a continuación.

Parámetros

Los siguientes parámetros son compatibles con el widget Problems.

Parameter type name value
Refresh interval 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.
Show 0 show 1 - (predeterminado) Problemas recientes;
2 - Historial;
3 - Problemas.
Host groups 2 groupids.0 ID de Host group.

Nota: Para configurar varios grupos de hosts, cree un objeto de campo de widget del dashboard para cada grupo de hosts con un número incrementado en el nombre de la propiedad.

Este parámetro no es compatible si se configura el widget en un template dashboard.
Host groups (Widget) 1 groupids._reference En lugar del ID de Host group:
ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para los grupos de hosts.

Este parámetro no es compatible si se configura el widget en un template dashboard.
Exclude host groups 2 exclude_groupids.0 ID de Host group.

Nota: Para excluir varios grupos de hosts, cree un objeto de campo de widget del dashboard para cada grupo de hosts con un número incrementado en el nombre de la propiedad.

Este parámetro no es compatible si se configura el widget en un template dashboard.
Hosts 3 hostids.0 ID de Host.

Nota: Para configurar varios hosts, cree un objeto de campo de widget del dashboard para cada host con un número incrementado en el nombre de la propiedad. Para varios hosts, el parámetro Host groups debe no configurarse en absoluto o configurarse con al menos un grupo de hosts al que pertenezcan los hosts configurados.

Este parámetro no es compatible si se configura el widget en un template dashboard.
Hosts (Widget/Dashboard) 1 hostids._reference En lugar del ID de Host:
DASHBOARD.hostids - establezca el selector Host como fuente de datos para los hosts;
ABCDE._hostids - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para los hosts.

Este parámetro no es compatible si se configura el widget en un template dashboard.
Problem 1 problem Nombre del evento del problema (sin distinción entre mayúsculas y minúsculas, nombre completo o parte de él).
Severity 0 severities.0 0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Promedio;
4 - Alto;
5 - Desastre.

Predeterminado: vacío (todos habilitados).

Nota: Para configurar varios valores, cree un objeto de campo de widget del dashboard para cada valor con un número incrementado en el nombre de la propiedad.
Problem tags
Evaluation type 0 evaltype 0 - (predeterminado) Y/O;
2 - O.
Tag name 1 tags.0.tag Cualquier valor de cadena.

Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.

Comportamiento del parámetro:
- obligatorio si se configuran Problem tags
Operator 0 tags.0.operator 0 - Contiene;
1 - Igual a;
2 - No contiene;
3 - No es igual a;
4 - Existe;
5 - No existe.

Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.

Comportamiento del parámetro:
- obligatorio si se configuran Problem tags
Tag value 1 tags.0.value Cualquier valor de cadena.

Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.

Comportamiento del parámetro:
- obligatorio si se configuran Problem tags
Show tags 0 show_tags 0 - (predeterminado) Ninguno;
1 - 1;
2 - 2;
3 - 3.
Tag name (format) 0 tag_name_format 0 - (predeterminado) Completo;
1 - Abreviado;
2 - Ninguno.

Comportamiento del parámetro:
- compatible si Show tags está establecido en "1", "2" o "3"
Tag display priority 1 tag_priority Lista de etiquetas separadas por comas.

Comportamiento del parámetro:
- compatible si Show tags está establecido en "1", "2" o "3"
Show operational data 0 show_opdata 0 - (predeterminado) Ninguno;
1 - Separadamente;
2 - Con el nombre del problema.
Show suppressed problems 0 show_suppressed 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Acknowledgement status 0 acknowledgement_status 0 - (predeterminado) todos;
1 - Sin reconocer;
2 - Reconocido.
By me 0 acknowledged_by_me 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Sort entries by 0 sort_triggers 1 - Severidad (descendente);
2 - Host (ascendente);
3 - Hora (ascendente);
4 - (predeterminado) Hora (descendente);
13 - Severidad (ascendente);
14 - Host (descendente);
15 - Problema (ascendente);
16 - Problema (descendente).

Para todos los valores, excepto "Hora (descendente)" y "Hora (ascendente)", el parámetro Show timeline debe establecerse en "Deshabilitado".

Los valores "Host (ascendente)" y "Host (descendente)" no son compatibles si se configura el widget en un template dashboard.
Show timeline 0 show_timeline 0 - Deshabilitado;
1 - (predeterminado) Habilitado.

Comportamiento del parámetro:
- compatible si Sort entries by está establecido en "Hora (descendente)" o "Hora (ascendente)"
Highlight whole row 0 highlight_row 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Este parámetro no es compatible con los temas de alto contraste.

Esta opción es compatible desde Zabbix 7.4.3.
Show lines 0 show_lines Los valores posibles van de 1 a 100.

Predeterminado: 25.
Reference 1 reference Cualquier valor de cadena compuesto por 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del dashboard al que pertenece el widget.

Comportamiento del parámetro:
- obligatorio

Ejemplos

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

Configuración de un widget Problemas

Configure un widget Problemas que muestre los problemas para el grupo de equipos "4" que cumplan las siguientes condiciones:

  • Problemas que tengan una etiqueta con el nombre "scope" que contenga los valores "performance" o "availability", o "capacity".
  • Problemas que tengan las siguientes severidades: "Aviso", "Media", "Alta", "Desastre".

Además, configure el widget para mostrar etiquetas y datos operativos.

Petición:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "Mi panel",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "problems",
                        "name": "Problemas",
                        "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": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "performance"
                            },
                            {
                                "type": 1,
                                "name": "tags.1.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.1.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.1.value",
                                "value": "availability"
                            },
                            {
                                "type": 1,
                                "name": "tags.2.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.2.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.2.value",
                                "value": "capacity"
                            },
                            {
                                "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:

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

Véase también