[comment]: # ({898d1f65-41e9cb8c})
# 30 Déclencheurs principaux

[comment]: # ({/898d1f65-41e9cb8c})

[comment]: # ({7e740a18-30595671})
### 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 [*Top triggers*](/manual/web_interface/frontend_sections/dashboards/widgets/top_triggers) dans les méthodes `dashboard.create` et `dashboard.update`.

::: noteimportant
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](/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é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 *Top triggers*, veuillez vous référer au comportement des paramètres décrit dans les tableaux ci-dessous.
:::

[comment]: # ({/7e740a18-30595671})

[comment]: # ({27da08e4-b5e67e19})
### Paramètres

Les paramètres suivants sont pris en charge pour le widget *Top triggers*.

|Paramètre|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Intervalle d’actualisation*|<|0|rf_rate|0 - *(par défaut)* Pas d’actualisation ;<br>10 - 10 secondes ;<br>30 - 30 secondes ;<br>60 - 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 la 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 la 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).|
|*Problème*|<|1|problem|[Nom d’événement](/manual/config/triggers/trigger#configuration) du problème (insensible à la casse, nom complet ou partie de celui-ci).|
|*Sévérité*|<|0|severities.0|Sévérités du déclencheur.<br><br>0 - Non classé ;<br>1 - Information ;<br>2 - Avertissement ;<br>3 - Moyenne ;<br>4 - Haute ;<br>5 - Désastre.<br><br>Par défaut : vide (toutes activées).<br><br>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é.|
|*Tags de problème*|<|<|<|<|
|<|*Type d’évaluation*|0|evaltype|0 - *(par défaut)* Et/Ou ;<br>2 - Ou.|
|^|*Nom du tag*|1|tags.0.tag|Toute valeur de chaîne.<br><br>Remarque : Le numéro dans le nom de la propriété fait référence à l’ordre du tag dans la liste d’évaluation des tags.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* lors de la configuration de *Tags de problème*|
|^|*Opérateur*|0|tags.0.operator|0 - Contient ;<br>1 - Égal à ;<br>2 - Ne contient pas ;<br>3 - N’est pas égal à ;<br>4 - Existe ;<br>5 - N’existe pas.<br><br>Remarque : Le numéro dans le nom de la propriété fait référence à l’ordre du tag dans la liste d’évaluation des tags.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* lors de la configuration de *Tags de problème*|
|^|*Valeur du tag*|1|tags.0.value|Toute valeur de chaîne.<br><br>Remarque : Le numéro dans le nom de la propriété fait référence à l’ordre du tag dans la liste d’évaluation des tags.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* lors de la configuration de *Tags de problème*|
|*Période*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - définit le [sélecteur de période](/manual/web_interface/time_period_selector) du tableau de bord comme source de données ;<br>`ABCDE._timeperiod` - définit un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (avec son paramètre *Reference* défini sur "`ABCDE`") comme source de données.<br><br>Par défaut : `DASHBOARD._timeperiod`<br><br>Vous pouvez également définir la période uniquement dans les paramètres *From* et *To*.|
|<|*From*|1|time_period.from|Chaîne temporelle valide en syntaxe temporelle absolue (`YYYY-MM-DD hh:mm:ss`) ou [relative](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *pris en charge* si *Période* n’est pas défini<br>- *obligatoire* si `time_period.to` est défini|
|^|*To*|1|time_period.to|Chaîne temporelle valide en syntaxe temporelle absolue (`YYYY-MM-DD hh:mm:ss`) ou [relative](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *pris en charge* si *Période* n’est pas défini<br>- *obligatoire* si `time_period.from` est défini|
|*Limite de déclencheurs*|<|0|show_lines|Les valeurs possibles vont de 1 à 100.<br><br>Par défaut : 10.|

[comment]: # ({/27da08e4-b5e67e19})

[comment]: # ({599fd163-441500f2})
### Exemples

Les exemples suivants visent uniquement à décrire la configuration des objets de champ de widget de tableau de bord pour le widget *Top triggers*.
Pour plus d’informations sur la configuration d’un tableau de bord, consultez [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/599fd163-441500f2})

[comment]: # ({379c5c86-681121e2})
#### Configuration d'un widget *Top triggers*

Configurez un widget *Top triggers* qui affiche les 5 principaux déclencheurs pour le groupe d'hôtes « 4 » avec le nombre de tous les problèmes pour chaque déclencheur.
Le widget affiche uniquement les déclencheurs ayant les sévérités « Warning », « Average », « High » ou « Disaster », ainsi que les problèmes ayant un tag nommé « scope » contenant les valeurs « performance », « availability » ou « capacity ».

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

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "toptriggers",
                        "name": "Top triggers",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "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": 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": "show_lines",
                                "value": 5
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Réponse :

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

[comment]: # ({/379c5c86-681121e2})

[comment]: # ({e9d30322-d81fc119})
### Voir aussi

-   [Champ de widget de 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-d81fc119})