22 Hôtes en problème
Description
Ces paramètres et les valeurs de propriété possibles pour les objets de champ du widget de tableau de bord correspondants permettent de configurer le widget Hôtes avec problèmes 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 Hôtes avec problèmes, 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 Hôtes avec problèmes.
| Paramètre | type | name | value | |
|---|---|---|---|---|
| Intervalle d’actualisation | 0 | rf_rate | 0 - Pas d’actualisation ; 10 - 10 secondes ; 30 - 30 secondes ; 60 - (par défaut) 1 minute ; 120 - 2 minutes ; 600 - 10 minutes ; 900 - 15 minutes. |
|
| 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 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 | Au lieu de l’ID du groupe d’hôtes :ABCDE._hostgroupids - définir 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 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 propriété. Pour plusieurs hôtes, le paramètre Groupes d’hôtes ne doit soit pas être configuré du tout, soit être 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 | Au lieu de l’ID de l’hôte :DASHBOARD.hostids - définir le sélecteur d’hôte du tableau de bord comme source de données pour les hôtes ;ABCDE._hostids - définir 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 d’événement du problème (insensible à la casse, nom complet ou partie de celui-ci). | |
| Sévérité | 0 | severities.0 | 0 - Non classé ; 1 - Information ; 2 - Avertissement ; 3 - Moyen ; 4 - Élevé ; 5 - Désastre. Par défaut : vide (tous activés). 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 propriété. |
|
| Balises de problème | ||||
| Type d’évaluation | 0 | evaltype | 0 - (par défaut) Et/Ou ; 2 - Ou. |
|
| Nom de balise | 1 | tags.0.tag | Toute valeur de chaîne. Remarque : le numéro dans le nom de propriété fait référence à l’ordre des balises dans la liste d’évaluation des balises. Comportement du paramètre : - obligatoire lors de la configuration de Balises de problème |
|
| Opérateur | 0 | tags.0.operator | 0 - Contient ; 1 - Égal à ; 2 - Ne contient pas ; 3 - N’est pas égal à ; 4 - Existe ; 5 - N’existe pas. Remarque : le numéro dans le nom de propriété fait référence à l’ordre des balises dans la liste d’évaluation des balises. Comportement du paramètre : - obligatoire lors de la configuration de Balises de problème |
|
| Valeur de balise | 1 | tags.0.value | Toute valeur de chaîne. Remarque : le numéro dans le nom de propriété fait référence à l’ordre des balises dans la liste d’évaluation des balises. Comportement du paramètre : - obligatoire lors de la configuration de Balises de problème |
|
| Afficher les problèmes supprimés | 0 | show_suppressed | 0 - (par défaut) Désactivé ; 1 - Activé. |
|
| Masquer les groupes sans problèmes | 0 | hide_empty_groups | 0 - (par défaut) Désactivé ; 1 - Activé. Ce paramètre n’est pas pris en charge lors de la configuration du widget sur un tableau de bord de modèle. |
|
| Affichage des problèmes | 0 | ext_ack | 0 - (par défaut) Tous ; 1 - Uniquement non acquittés ; 2 - Séparés. |
|
| 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 dans le 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 Hôtes à problèmes.
Pour plus d'informations sur la configuration d'un tableau de bord, consultez dashboard.create.
Configuration d’un widget Hôtes avec problèmes
Configurez un widget Hôtes avec problèmes qui affiche les hôtes des groupes d’hôtes « 2 » et « 4 » ayant des problèmes dont le nom contient la chaîne « CPU » et présentant les niveaux de gravité suivants : « Avertissement », « Moyen », « Élevé », « Désastre ».
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "problemhosts",
"name": "Problem hosts",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 2
},
{
"type": 2,
"name": "groupids.1",
"value": 4
},
{
"type": 1,
"name": "problem",
"value": "cpu"
},
{
"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
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}