30 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 compatíveis com o widget Principais triggers.
| Parâmetro | tipo | nome | valor | |
|---|---|---|---|---|
| Intervalo de atualização | 0 | rf_rate | 0 - (padrão) Sem atualização; 10 - 10 segundos; 30 - 30 segundos; 60 - 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
|
| Grupos de hosts | 2 | groupids.0 | ID do grupo de hosts. Observação: para configurar vários grupos de hosts, crie um objeto de campo de widget do dashboard para cada grupo de hosts, usando um número incrementado no nome da propriedade. Este parâmetro não é compatível ao configurar o widget em um dashboard de template. |
|
| Hosts | 3 | hostids.0 | ID do host. Observação: para configurar vários hosts, crie um objeto de campo de widget do dashboard para cada host, usando um número incrementado no nome da propriedade. Para vários 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 pertençam. Este parâmetro não é compatível ao configurar o widget em um dashboard de template. |
|
| Problema | 1 | problem | Nome do evento do problema (não diferencia maiúsculas de minúsculas, nome completo ou parte dele). | |
| Severidade | 0 | severities.0 | Severidades do trigger. 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Média; 4 - Alta; 5 - Desastre. Padrão: vazio (todas habilitadas). Observação: para configurar vários valores, crie um objeto de campo de widget do dashboard para cada valor, usando um número incrementado no nome da propriedade. |
|
| Tags do problema | ||||
| Tipo de avaliação | 0 | evaltype | 0 - (padrão) E/OU; 2 - OU. |
|
| Nome da tag | 1 | tags.0.tag | Qualquer valor de string. Observação: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags. Comportamento do parâmetro: - obrigatório ao configurar Tags do problema |
|
| Operador | 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. Observação: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags. Comportamento do parâmetro: - obrigatório ao configurar Tags do problema |
|
| Valor da tag | 1 | tags.0.value | Qualquer valor de string. Observação: o número no nome da propriedade faz referência à ordem da tag na lista de avaliação de tags. Comportamento do parâmetro: - obrigatório ao configurar Tags do problema |
|
| Período | 1 | time_period._reference | DASHBOARD._timeperiod - define o seletor de período do dashboard como a fonte de dados;ABCDE._timeperiod - define um widget compatível (com o parâmetro Referência definido como "ABCDE") como a fonte de dados.Padrão: DASHBOARD._timeperiodComo alternativa, você pode definir o período somente nos parâmetros De e Até. |
|
| De | 1 | time_period.from | String de tempo válida no formato absoluto (YYYY-MM-DD hh:mm:ss) ou na sintaxe de tempo relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - compatível se Período não estiver definido - obrigatório se time_period.to estiver definido |
|
| Até | 1 | time_period.to | String de tempo válida no formato absoluto (YYYY-MM-DD hh:mm:ss) ou na sintaxe de tempo relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - compatível se Período não estiver definido - obrigatório se time_period.from estiver definido |
|
| Limite de triggers | 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
}