[comment]: # ({91ac7f4b-7df23091})
# 33 Surveillance Web

[comment]: # ({/91ac7f4b-7df23091})

[comment]: # ({559931b4-b0a71456})
### 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 [*Surveillance Web*](/manual/web_interface/frontend_sections/dashboards/widgets/web_monitoring) dans les méthodes `dashboard.create` et `dashboard.update`.

::: noteimportant
Les propriétés des « champs » 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](/manual/web_interface/frontend_sections/dashboards/widgets) et de créer des [widgets personnalisés](/devel/modules/tutorials/widget), mais introduit également le risque de création ou de mise à jour de widgets. incorrectement.
Pour garantir la création ou la mise à jour réussie du widget *Surveillance Web*, veuillez vous référer au comportement des paramètres décrit dans les tableaux ci-dessous.
:::

[comment]: # ({/559931b4-b0a71456})

[comment]: # ({1fb4bda0-e5dda4bf})
### Paramètres

Les paramètres suivants sont pris en charge pour le widget de *supervision Web*.

|Paramètre|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Intervalle d'actualisation*|<|0|rf_rate|0 - Aucune actualisation;<br>10 - 10 secondes;<br>30 - 30 secondes;<br>60 - *(par défaut)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.|
|*Groupes d'hôtes*|<|2|groupids.0|ID du [groupe d'hôtes](/manual/api/reference/hostgroup/get).<br><br>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é.<br><br>Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un [tableau de bord de modèle](/manual/api/reference/templatedashboard/object).|
|<|*Groupes d'hôtes (widget)*|1|groupids.\_reference|Au lieu de l'ID du [groupe d'hôtes](/manual/api/reference/hostgroup/get) :<br>`ABCDE._hostgroupids` - définir un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (avec son paramètre *Référence* défini sur "`ABCDE`") comme source de données pour les groupes d'hôtes.<br><br>Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un [tableau de bord de modèle](/manual/api/reference/templatedashboard/object).|
|*Exclure les groupes d'hôtes*|<|2|exclude_groupids.0|ID du [groupe d'hôtes](/manual/api/reference/hostgroup/get).<br><br>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é.<br><br>Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un [tableau de bord de modèle](/manual/api/reference/templatedashboard/object).|
|*Hôtes*|<|3|hostids.0|ID de l'[hôte](/manual/api/reference/host/get).<br><br>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.<br><br>Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un [tableau de bord de modèle](/manual/api/reference/templatedashboard/object).|
|<|*Hôtes (widget/tableau de bord)*|1|hostids.\_reference|Au lieu de l'ID de l'[hôte](/manual/api/reference/host/get) :<br>`DASHBOARD.hostids` - définir le [sélecteur d'hôte](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) du tableau de bord comme source de données pour les hôtes ;<br>`ABCDE._hostids` - définir un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (avec son paramètre *Référence* défini sur "`ABCDE`") comme source de données pour les hôtes.<br><br>Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un [tableau de bord de modèle](/manual/api/reference/templatedashboard/object).|
|*Balises de scénario*|<|<|<|<|
|<|*Type d'évaluation*|0|evaltype|0 - *(par défaut)* Et/Ou;<br>2 - Ou.|
|^|*Nom de balise*|1|tags.0.tag|Toute valeur de chaîne.<br><br>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.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* lors de la configuration de *Balises de scénario*|
|^|*Opérateur*|0|tags.0.operator|0 - Contient;<br>1 - Égal à;<br>2 - Ne contient pas;<br>3 - Différent de;<br>4 - Existe;<br>5 - N'existe pas.<br><br>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.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* lors de la configuration de *Balises de scénario*|
|^|*Valeur de balise*|1|tags.0.value|Toute valeur de chaîne.<br><br>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.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* lors de la configuration de *Balises de scénario*|
|*Afficher les hôtes en maintenance*|<|0|maintenance|0 - Désactivé;<br>1 - *(par défaut)* Activé.|
|*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.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire*|

[comment]: # ({/1fb4bda0-e5dda4bf})

[comment]: # ({d3cc817a-e86e46ba})
### Exemples

Les exemples suivants ont pour objectif de décrire uniquement la configuration des objets champs du widget de tableau de bord pour le widget *Surveillance Web*.
Pour plus d'informations sur la configuration d'un tableau de bord, consultez [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/d3cc817a-e86e46ba})

[comment]: # ({8832ffb5-01a76e6e})
#### Configurer un widget *Surveillance Web*

Configurez un widget *Surveillance Web* qui affiche un résumé de l'état des scénarios de surveillance Web actifs pour le groupe d'hôtes « 4 ».

[Requête](/manual/api#performing-requests) :

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "Mon tableau de bord",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "web",
                        "name": "Web monitoring",
                        "x": 0,
                        "o": 0,
                        "width": 18,
                        "height": 3,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type 2,
                                "name": "groupids.0",
                                "valueuserGroups": 4
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Réponse :

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

[comment]: # ({/8832ffb5-01a76e6e})

[comment]: # ({e9d30322-79381d10})
### Voir également

- [Champ du widget du tableau de bord](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-79381d10})