[comment]: # ({898d1f65-41e9cb8c})
# 30 principais triggers

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

[comment]: # ({7e740a18-30595671})
### Descrição

Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget do dashboard permitem configurar o widget [*Top triggers*](/manual/web_interface/frontend_sections/dashboards/widgets/top_triggers) nos métodos `dashboard.create` e `dashboard.update`.

::: noteimportant
As propriedades `fields` do widget não são validadas durante a criação ou atualização de um dashboard.
Isso permite que os usuários modifiquem [widgets internos](/manual/web_interface/frontend_sections/dashboards/widgets) e criem [widgets personalizados](/devel/modules/tutorials/widget), mas também introduz o risco de criar ou atualizar widgets incorretamente.
Para garantir a criação ou atualização bem-sucedida do widget *Top triggers*, consulte o comportamento dos parâmetros descritos nas tabelas abaixo.
:::

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

[comment]: # ({27da08e4-b5e67e19})
### Parâmetros

Os seguintes parâmetros são suportados para o widget *Top triggers*.

|Parâmetro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Intervalo de atualização*|<|0|rf_rate|0 - *(padrão)* Sem atualização;<br>10 - 10 segundos;<br>30 - 30 segundos;<br>60 - 1 minuto;<br>120 - 2 minutos;<br>600 - 10 minutos;<br>900 - 15 minutos.|
|*Grupos de hosts*|<|2|groupids.0|ID do [grupo de hosts](/manual/api/reference/hostgroup/get).<br><br>Nota: Para configurar vários grupos de hosts, crie um objeto de campo de widget de dashboard para cada grupo de hosts com um número incrementado no nome da propriedade.<br><br>Este parâmetro não é suportado se o widget estiver sendo configurado em um [dashboard de template](/manual/api/reference/templatedashboard/object).|
|*Hosts*|<|3|hostids.0|ID do [host](/manual/api/reference/host/get).<br><br>Nota: Para configurar vários hosts, crie um objeto de campo de widget de dashboard para cada host com um número incrementado no nome da propriedade. Para múltiplos hosts, o parâmetro *Grupos de hosts* deve não estar configurado ou estar configurado com pelo menos um grupo de hosts ao qual os hosts configurados pertencem.<br><br>Este parâmetro não é suportado se o widget estiver sendo configurado em um [dashboard de template](/manual/api/reference/templatedashboard/object).|
|*Problema*|<|1|problem|[Nome do evento](/manual/config/triggers/trigger#configuration) do problema (não diferencia maiúsculas de minúsculas, nome completo ou parte dele).|
|*Severidade*|<|0|severities.0|Severidades do trigger.<br><br>0 - Não classificado;<br>1 - Informação;<br>2 - Aviso;<br>3 - Médio;<br>4 - Alto;<br>5 - Desastre.<br><br>Padrão: vazio (todas habilitadas).<br><br>Nota: Para configurar vários valores, crie um objeto de campo de widget de dashboard para cada valor com um número incrementado no nome da propriedade.|
|*Tags do problema*|<|<|<|<|
|<|*Tipo de avaliação*|0|evaltype|0 - *(padrão)* E/Ou;<br>2 - Ou.|
|^|*Nome da tag*|1|tags.0.tag|Qualquer valor de string.<br><br>Nota: O número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se estiver configurando *Tags do problema*|
|^|*Operador*|0|tags.0.operator|0 - Contém;<br>1 - Igual;<br>2 - Não contém;<br>3 - Diferente;<br>4 - Existe;<br>5 - Não existe.<br><br>Nota: O número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se estiver configurando *Tags do problema*|
|^|*Valor da tag*|1|tags.0.value|Qualquer valor de string.<br><br>Nota: O número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se estiver configurando *Tags do problema*|
|*Período de tempo*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - define o [seletor de período de tempo](/manual/web_interface/time_period_selector) do dashboard como fonte de dados;<br>`ABCDE._timeperiod` - define um [widget compatível](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (com seu parâmetro *Referência* definido como "`ABCDE`") como fonte de dados.<br><br>Padrão: `DASHBOARD._timeperiod`<br><br>Alternativamente, você pode definir o período de tempo apenas nos parâmetros *De* e *Até*.|
|<|*De*|1|time_period.from|String de tempo válida na sintaxe absoluta (`YYYY-MM-DD hh:mm:ss`) ou [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *suportado* se *Período de tempo* não estiver definido<br>- *obrigatório* se `time_period.to` estiver definido|
|^|*Até*|1|time_period.to|String de tempo válida na sintaxe absoluta (`YYYY-MM-DD hh:mm:ss`) ou [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *suportado* se *Período de tempo* não estiver definido<br>- *obrigatório* se `time_period.from` estiver definido|
|*Limite de triggers*|<|0|show_lines|Os valores possíveis variam de 1 a 100.<br><br>Padrão: 10.|

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

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

Os exemplos a seguir têm como objetivo apenas descrever a configuração dos objetos de campo do widget do dashboard para o widget *Top triggers*.
Para mais informações sobre como configurar um dashboard, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({379c5c86-681121e2})
#### Configurando um widget *Top triggers*

Configure um widget *Top triggers* que exibe os 5 principais triggers para o grupo de hosts "4" com a contagem de todos os problemas para cada trigger.
O widget exibe apenas triggers que possuem severidades "Warning", "Average", "High" ou "Disaster", e problemas que possuem uma tag com o nome "scope" que contenha os valores "performance" ou "availability" ou "capacity".

[Requisição](/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
}
```

Resposta:

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

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

[comment]: # ({e9d30322-d81fc119})
### Veja também

-   [Campo de widget de dashboard](/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})