Table of Contents
23 Problemas
Descrição
Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget de dashboard permitem configurar o widget Problemas 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 Problemas, consulte o comportamento dos parâmetros descritos nas tabelas abaixo.
Parâmetros
Os seguintes parâmetros são suportados para o widget Problemas.
| Parâmetro | tipo | nome | valor | |
|---|---|---|---|---|
| Intervalo de atualização | 0 | rf_rate | 0 - Sem atualização; 10 - 10 segundos; 30 - 30 segundos; 60 - (padrão) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
|
| Mostrar | 0 | show | 1 - (padrão) Problemas recentes; 2 - Histórico; 3 - Problemas. |
|
| Grupos de hosts | 2 | groupids.0 | ID do Grupo de hosts. Nota: Para configurar múltiplos 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. Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Grupos de hosts (Widget) | 1 | groupids._reference | Em vez do ID do Grupo de hosts:ABCDE._hostgroupids - defina um widget compatível (com seu parâmetro Referência definido como "ABCDE") como a fonte de dados para grupos de hosts.Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Excluir grupos de hosts | 2 | exclude_groupids.0 | ID do Grupo de hosts. Nota: Para excluir múltiplos 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. Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Hosts | 3 | hostids.0 | ID do Host. Nota: Para configurar múltiplos 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. Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Hosts (Widget/Dashboard) | 1 | hostids._reference | Em vez do ID do Host:DASHBOARD.hostids - defina o seletor de host do dashboard como a fonte de dados para hosts;ABCDE._hostids - defina um widget compatível (com seu parâmetro Referência definido como "ABCDE") como a fonte de dados para hosts.Este parâmetro não é suportado se o widget estiver sendo configurado 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). | |
| Gravidade | 0 | severities.0 | 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. Padrão: vazio (todos habilitados). Nota: Para configurar múltiplos 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; 2 - Ou. |
|
| Nome da tag | 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: - obrigatório se estiver configurando Tags do problema |
|
| Operador | 0 | tags.0.operator | 0 - Contém; 1 - Igual; 2 - Não contém; 3 - Diferente; 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: - obrigatório se estiver configurando Tags do problema |
|
| Valor da tag | 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: - obrigatório se estiver configurando Tags do problema |
|
| Mostrar tags | 0 | show_tags | 0 - (padrão) Nenhuma; 1 - 1; 2 - 2; 3 - 3. |
|
| Nome da tag (formato) | 0 | tag_name_format | 0 - (padrão) Completo; 1 - Abreviado; 2 - Nenhum. Comportamento do parâmetro: - suportado se Mostrar tags estiver definido como "1", "2" ou "3" |
|
| Prioridade de exibição da tag | 1 | tag_priority | Lista de tags separadas por vírgula. Comportamento do parâmetro: - suportado se Mostrar tags estiver definido como "1", "2" ou "3" |
|
| Mostrar dados operacionais | 0 | show_opdata | 0 - (padrão) Nenhum; 1 - Separadamente; 2 - Com o nome do problema. |
|
| Mostrar problemas suprimidos | 0 | show_suppressed | 0 - (padrão) Desabilitado; 1 - Habilitado. |
|
| Status de reconhecimento | 0 | acknowledgement_status | 0 - (padrão) todos; 1 - Não reconhecido; 2 - Reconhecido. |
|
| Por mim | 0 | acknowledged_by_me | 0 - (padrão) Desabilitado; 1 - Habilitado. |
|
| Ordenar entradas por | 0 | sort_triggers | 1 - Gravidade (decrescente); 2 - Host (crescente); 3 - Hora (crescente); 4 - (padrão) Hora (decrescente); 13 - Gravidade (crescente); 14 - Host (decrescente); 15 - Problema (crescente); 16 - Problema (decrescente). Para todos os valores, exceto "Hora (decrescente)" e "Hora (crescente)", o parâmetro Mostrar linha do tempo deve ser definido como "Desabilitado". Os valores "Host (crescente)" e "Host (decrescente)" não são suportados se o widget estiver sendo configurado em um dashboard de template. |
|
| Mostrar linha do tempo | 0 | show_timeline | 0 - Desabilitado; 1 - (padrão) Habilitado. Comportamento do parâmetro: - suportado se Ordenar entradas por estiver definido como "Hora (decrescente)" ou "Hora (crescente)" |
|
| Mostrar linhas | 0 | show_lines | Os valores possíveis variam de 1-100. Padrão: 25. |
|
| Referência | 1 | reference | Qualquer valor de string consistindo de 5 caracteres (por exemplo, ABCDE ou JBPNL). Este valor deve ser exclusivo dentro do dashboard ao qual o widget pertence.Comportamento do parâmetro: - obrigatório |
|
Exemplos
Os exemplos a seguir têm como objetivo apenas descrever a configuração dos objetos de campo do widget de dashboard para o widget Problemas. Para mais informações sobre como configurar um dashboard, consulte dashboard.create.
Configurando um widget Problemas
Configure um widget Problemas que exiba problemas para o grupo de hosts "4" que satisfaçam as seguintes condições:
- Problemas que tenham uma tag com o nome "scope" que contenha os valores "performance" ou "availability", ou "capacity".
- Problemas que tenham as seguintes severidades: "Aviso", "Média", "Alta", "Desastre".
Além disso, configure o widget para mostrar tags e dados operacionais.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "problems",
"name": "Problems",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"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": "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": 0,
"name": "show_tags",
"value": 1
},
{
"type": 0,
"name": "show_opdata",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Resposta: