23 Problèmes

Description

Ces paramètres et les valeurs de propriété possibles pour les objets de champ du widget de tableau de bord respectifs permettent de configurer le widget Problems dans les méthodes dashboard.create et dashboard.update.

Les propriétés fields du widget ne sont pas validées lors de la création ou de la mise à jour d’un tableau de bord. Cela permet aux utilisateurs de modifier les widgets intégrés et de créer des widgets personnalisés, mais introduit également le risque de créer ou de mettre à jour des widgets de manière incorrecte. Pour garantir la réussite de la création ou de la mise à jour du widget Problems, veuillez vous référer au comportement des paramètres décrit dans les tableaux ci-dessous.

Paramètres

Les paramètres suivants sont pris en charge pour le widget Problèmes.

Paramètre type name value
Intervalle d'actualisation 0 rf_rate 0 - Aucune actualisation ;
10 - 10 secondes ;
30 - 30 secondes ;
60 - (par défaut) 1 minute ;
120 - 2 minutes ;
600 - 10 minutes ;
900 - 15 minutes.
Afficher 0 show 1 - (par défaut) Problèmes récents ;
2 - Historique ;
3 - Problèmes.
Groupes d'hôtes 2 groupids.0 ID du groupe d'hôtes.

Remarque : pour configurer plusieurs groupes d'hôtes, créez un objet de champ de widget de tableau de bord pour chaque groupe d'hôtes, avec un numéro incrémenté dans le nom de la propriété.

Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un tableau de bord de modèle.
Groupes d'hôtes (widget) 1 groupids._reference À la place de l'ID du groupe d'hôtes :
ABCDE._hostgroupids - définissez un widget compatible (avec son paramètre Référence défini sur "ABCDE") comme source de données pour les groupes d'hôtes.

Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un tableau de bord de modèle.
Exclure les groupes d'hôtes 2 exclude_groupids.0 ID du groupe d'hôtes.

Remarque : pour exclure plusieurs groupes d'hôtes, créez un objet de champ de widget de tableau de bord pour chaque groupe d'hôtes, avec un numéro incrémenté dans le nom de la propriété.

Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un tableau de bord de modèle.
Hôtes 3 hostids.0 ID de l'hôte.

Remarque : pour configurer plusieurs hôtes, créez un objet de champ de widget de tableau de bord pour chaque hôte, avec un numéro incrémenté dans le nom de la propriété. Pour plusieurs hôtes, le paramètre Groupes d'hôtes doit être soit entièrement non configuré, soit configuré avec au moins un groupe d'hôtes auquel appartiennent les hôtes configurés.

Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un tableau de bord de modèle.
Hôtes (widget/tableau de bord) 1 hostids._reference À la place de l'ID de l'hôte :
DASHBOARD.hostids - définissez le sélecteur Hôte comme source de données pour les hôtes ;
ABCDE._hostids - définissez un widget compatible (avec son paramètre Référence défini sur "ABCDE") comme source de données pour les hôtes.

Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un tableau de bord de modèle.
Problème 1 problem Nom de l'événement du problème (insensible à la casse, nom complet ou partie du nom).
Gravité 0 severities.0 0 - Non classifié ;
1 - Information ;
2 - Avertissement ;
3 - Moyenne ;
4 - Élevée ;
5 - Désastre.

Par défaut : vide (toutes activées).

Remarque : pour configurer plusieurs valeurs, créez un objet de champ de widget de tableau de bord pour chaque valeur, avec un numéro incrémenté dans le nom de la propriété.
Étiquettes des problèmes
Type d'évaluation 0 evaltype 0 - (par défaut) Et/Ou ;
2 - Ou.
Nom de l'étiquette 1 tags.0.tag Toute valeur de chaîne.

Remarque : le numéro dans le nom de la propriété fait référence à l'ordre de l'étiquette dans la liste d'évaluation des étiquettes.

Comportement du paramètre :
- obligatoire lors de la configuration des Étiquettes des problèmes
Opérateur 0 tags.0.operator 0 - Contient ;
1 - Est égal à ;
2 - Ne contient pas ;
3 - N'est pas égal à ;
4 - Existe ;
5 - N'existe pas.

Remarque : le numéro dans le nom de la propriété fait référence à l'ordre de l'étiquette dans la liste d'évaluation des étiquettes.

Comportement du paramètre :
- obligatoire lors de la configuration des Étiquettes des problèmes
Valeur de l'étiquette 1 tags.0.value Toute valeur de chaîne.

Remarque : le numéro dans le nom de la propriété fait référence à l'ordre de l'étiquette dans la liste d'évaluation des étiquettes.

Comportement du paramètre :
- obligatoire lors de la configuration des Étiquettes des problèmes
Afficher les étiquettes 0 show_tags 0 - (par défaut) Aucune ;
1 - 1 ;
2 - 2 ;
3 - 3.
Nom de l'étiquette (format) 0 tag_name_format 0 - (par défaut) Complet ;
1 - Raccourci ;
2 - Aucun.

Comportement du paramètre :
- pris en charge si Afficher les étiquettes est défini sur "1", "2" ou "3"
Priorité d'affichage des étiquettes 1 tag_priority Liste d'étiquettes séparées par des virgules.

Comportement du paramètre :
- pris en charge si Afficher les étiquettes est défini sur "1", "2" ou "3"
Afficher les données opérationnelles 0 show_opdata 0 - (par défaut) Aucune ;
1 - Séparément ;
2 - Avec le nom du problème.
Afficher les problèmes supprimés 0 show_suppressed 0 - (par défaut) Désactivé ;
1 - Activé.
État de l'acquittement 0 acknowledgement_status 0 - (par défaut) Tous ;
1 - Non acquittés ;
2 - Acquittés.
Par moi 0 acknowledged_by_me 0 - (par défaut) Désactivé ;
1 - Activé.
Trier les entrées par 0 sort_triggers 1 - Gravité (décroissante) ;
2 - Hôte (croissant) ;
3 - Heure (croissante) ;
4 - (par défaut) Heure (décroissante) ;
13 - Gravité (croissante) ;
14 - Hôte (décroissant) ;
15 - Problème (croissant) ;
16 - Problème (décroissant).

Pour toutes les valeurs, à l'exception de « Heure (décroissante) » et « Heure (croissante) », le paramètre Afficher la chronologie doit être défini sur « Désactivé ».

Les valeurs « Hôte (croissant) » et « Hôte (décroissant) » ne sont pas prises en charge lors de la configuration du widget sur un tableau de bord de modèle.
Afficher la chronologie 0 show_timeline 0 - Désactivé ;
1 - (par défaut) Activé.

Comportement du paramètre :
- pris en charge si Trier les entrées par est défini sur « Heure (décroissante) » ou « Heure (croissante) »
Surligner toute la ligne 0 highlight_row 0 - (par défaut) Désactivé ;
1 - Activé.

Ce paramètre n'est pas pris en charge dans les thèmes à contraste élevé.

Cette option est prise en charge depuis Zabbix 7.4.3.
Afficher les lignes 0 show_lines Les valeurs possibles vont de 1 à 100.

Par défaut : 25.
Référence 1 reference Toute valeur de chaîne composée de 5 caractères (par exemple, ABCDE ou JBPNL). Cette valeur doit être unique au sein du tableau de bord auquel appartient le widget.

Comportement du paramètre :
- obligatoire

Exemples

Les exemples suivants visent à décrire uniquement la configuration des objets de champ du widget de tableau de bord pour le widget Problèmes. Pour plus d'informations sur la configuration d'un tableau de bord, consultez dashboard.create.

Configuration d’un widget Problems

Configurez un widget Problems qui affiche les problèmes pour le groupe d’hôtes « 4 » et qui satisfont aux conditions suivantes :

  • Les problèmes qui ont un tag nommé « scope » contenant les valeurs « performance », « availability » ou « capacity ».
  • Les problèmes ayant les sévérités suivantes : « Warning », « Average », « High », « Disaster ».

En outre, configurez le widget pour afficher les tags et les données opérationnelles.

Requête :

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

Réponse :

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

Voir également