27 principais triggers
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 nos métodos dashboard.create e dashboard.update.
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 e criem widgets personalizados, 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.
Parâmetros
Os seguintes parâmetros são suportados para o widget Top triggers.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 0 | rf_rate | 0 - (default) Sem atualização; 10 - 10 segundos; 30 - 30 segundos; 60 - 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
|
| Host groups | 2 | groupids.0 | ID do Host group. Nota: para configurar vários host groups, crie um objeto de campo do widget do dashboard para cada host group com um número incrementado no nome da propriedade. Este parâmetro não é suportado ao configurar o widget em um template dashboard. |
|
| Hosts | 3 | hostids.0 | ID do Host. Nota: para configurar vários hosts, crie um objeto de campo do widget do dashboard para cada host com um número incrementado no nome da propriedade. Para vários hosts, o parâmetro Host groups deve não estar configurado ou deve estar configurado com pelo menos um host group ao qual os hosts configurados pertençam. Este parâmetro não é suportado ao configurar o widget em um template dashboard. |
|
| Problem | 1 | problem | Nome do evento de problema (sem distinção entre maiúsculas e minúsculas, nome completo ou parte dele). | |
| Severity | 0 | severities.0 | Severidades do trigger. 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. Padrão: vazio (todos habilitados). Nota: para configurar vários valores, crie um objeto de campo do widget do dashboard para cada valor com um número incrementado no nome da propriedade. |
|
| Problem tags | ||||
| Evaluation type | 0 | evaltype | 0 - (default) E/OU; 2 - Ou. |
|
| Tag name | 1 | tags.0.tag | Qualquer valor de string. Nota: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags. Comportamento do parâmetro: - required se estiver configurando Problem tags |
|
| Operator | 0 | tags.0.operator | 0 - Contém; 1 - Igual a; 2 - Não contém; 3 - Não é igual a; 4 - Existe; 5 - Não existe. Nota: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags. Comportamento do parâmetro: - required se estiver configurando Problem tags |
|
| Tag value | 1 | tags.0.value | Qualquer valor de string. Nota: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags. Comportamento do parâmetro: - required se estiver configurando Problem tags |
|
| Time period | 1 | time_period._reference | DASHBOARD._timeperiod - define o seletor de Time period como a fonte de dados;ABCDE._timeperiod - define um widget compatível (com o parâmetro Reference definido como "ABCDE") como a fonte de dados.Padrão: DASHBOARD._timeperiodComo alternativa, você pode definir o período de tempo apenas nos parâmetros From e To. |
|
| From | 1 | time_period.from | String de tempo válida em sintaxe absoluta (YYYY-MM-DD hh:mm:ss) ou relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - supported se Time period não estiver definido - required se time_period.to estiver definido |
|
| To | 1 | time_period.to | String de tempo válida em sintaxe absoluta (YYYY-MM-DD hh:mm:ss) ou relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - supported se Time period não estiver definido - required se time_period.from estiver definido |
|
| Trigger limit | 0 | show_lines | Os valores possíveis variam de 1 a 100. Padrão: 10. |
|
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.
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".
{
"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:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}