[comment]: # ({898d1f65-41e9cb8c})
# 30 wichtigste Auslöser

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

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

Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets [*Top triggers*](/manual/web_interface/frontend_sections/dashboards/widgets/top_triggers) in den Methoden `dashboard.create` und `dashboard.update`.

::: noteimportant
Die Eigenschaften von Widget-`fields` werden bei der Erstellung oder Aktualisierung eines Dashboards nicht validiert.
Dies ermöglicht Benutzern, [integrierte Widgets](/manual/web_interface/frontend_sections/dashboards/widgets) zu ändern und [benutzerdefinierte Widgets](/devel/modules/tutorials/widget) zu erstellen, birgt jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren.
Um die erfolgreiche Erstellung oder Aktualisierung des Widgets *Top triggers* sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.
:::

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

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

Die folgenden Parameter werden für das Widget *Top-Auslöser* unterstützt.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Aktualisierungsintervall*|<|0|rf_rate|0 - *(Standard)* Keine Aktualisierung;<br>10 - 10 Sekunden;<br>30 - 30 Sekunden;<br>60 - 1 Minute;<br>120 - 2 Minuten;<br>600 - 10 Minuten;<br>900 - 15 Minuten.|
|*Host-Gruppen*|<|2|groupids.0|ID der [Host-Gruppe](/manual/api/reference/hostgroup/get).<br><br>Hinweis: Um mehrere Host-Gruppen zu konfigurieren, erstellen Sie für jede Host-Gruppe ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen.<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget in einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|*Hosts*|<|3|hostids.0|ID des [Hosts](/manual/api/reference/host/get).<br><br>Hinweis: Um mehrere Hosts zu konfigurieren, erstellen Sie für jeden Host ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen. Bei mehreren Hosts darf der Parameter *Host-Gruppen* entweder gar nicht konfiguriert sein oder muss mit mindestens einer Host-Gruppe konfiguriert sein, zu der die konfigurierten Hosts gehören.<br><br>Dieser Parameter wird nicht unterstützt, wenn das Widget in einem [Vorlagen-Dashboard](/manual/api/reference/templatedashboard/object) konfiguriert wird.|
|*Problem*|<|1|problem|Problem-[Ereignisname](/manual/config/triggers/trigger#configuration) (Groß-/Kleinschreibung wird nicht beachtet, vollständiger Name oder ein Teil davon).|
|*Schweregrad*|<|0|severities.0|Auslöser-Schweregrade.<br><br>0 - Nicht klassifiziert;<br>1 - Information;<br>2 - Warnung;<br>3 - Durchschnittlich;<br>4 - Hoch;<br>5 - Katastrophe.<br><br>Standard: leer (alle aktiviert).<br><br>Hinweis: Um mehrere Werte zu konfigurieren, erstellen Sie für jeden Wert ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen.|
|*Problem-Tags*|<|<|<|<|
|<|*Auswertungstyp*|0|evaltype|0 - *(Standard)* Und/Oder;<br>2 - Oder.|
|^|*Tag-Name*|1|tags.0.tag|Beliebiger Zeichenfolgenwert.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei der Konfiguration von *Problem-Tags*|
|^|*Operator*|0|tags.0.operator|0 - Enthält;<br>1 - Entspricht;<br>2 - Enthält nicht;<br>3 - Entspricht nicht;<br>4 - Existiert;<br>5 - Existiert nicht.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei der Konfiguration von *Problem-Tags*|
|^|*Tag-Wert*|1|tags.0.value|Beliebiger Zeichenfolgenwert.<br><br>Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* bei der Konfiguration von *Problem-Tags*|
|*Zeitraum*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - den [Zeitraumauswahl](/manual/web_interface/time_period_selector) des Dashboards als Datenquelle festlegen;<br>`ABCDE._timeperiod` - ein [kompatibles Widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (mit dem auf "`ABCDE`" gesetzten Parameter *Referenz*) als Datenquelle festlegen.<br><br>Standard: `DASHBOARD._timeperiod`<br><br>Alternativ können Sie den Zeitraum nur in den Parametern *Von* und *Bis* festlegen.|
|<|*Von*|1|time_period.from|Gültige Zeitangabe in absoluter Syntax (`YYYY-MM-DD hh:mm:ss`) oder [relativer](/manual/web_interface/time_period_selector) Zeitsyntax (`now`, `now/d`, `now/w-1w` usw.).<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Zeitraum* nicht gesetzt ist<br>- *erforderlich*, wenn `time_period.to` gesetzt ist|
|^|*Bis*|1|time_period.to|Gültige Zeitangabe in absoluter Syntax (`YYYY-MM-DD hh:mm:ss`) oder [relativer](/manual/web_interface/time_period_selector) Zeitsyntax (`now`, `now/d`, `now/w-1w` usw.).<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn *Zeitraum* nicht gesetzt ist<br>- *erforderlich*, wenn `time_period.from` gesetzt ist|
|*Auslöser-Limit*|<|0|show_lines|Mögliche Werte liegen im Bereich von 1 bis 100.<br><br>Standard: 10.|

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

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

Die folgenden Beispiele beschreiben nur die Konfiguration der Feldobjekte des Dashboard-Widgets für das *Top Triggers* Widget.
Für weitere Informationen zur Konfiguration eines Dashboards siehe [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({379c5c86-681121e2})
#### Konfigurieren eines Widgets *Top triggers*

Konfigurieren Sie ein Widget *Top triggers*, das die 5 wichtigsten Auslöser für die Host-Gruppe „4“ mit der Anzahl aller Probleme für jeden Auslöser anzeigt.
Das Widget zeigt nur Auslöser an, die die Schweregrade „Warning“, „Average“, „High“ oder „Disaster“ haben, sowie Probleme, die ein Tag mit dem Namen „scope“ besitzen, das die Werte „performance“ oder „availability“ oder „capacity“ enthält.

[Anfrage](/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
}
```

Antwort:

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

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

[comment]: # ({e9d30322-d81fc119})
### Siehe auch

-   [Dashboard Widget Feld](/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})