Table of Contents
14 Navegador de hosts
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 Navegador de hosts 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 Navegador de hosts, consulte o comportamento dos parâmetros descritos nas tabelas abaixo.
Parâmetros
Os seguintes parâmetros são suportados para o widget Navegador de hosts.
| 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. |
|
| 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. |
|
| Padrões de hosts | 1 | hosts.0 | Nome ou padrão do Host. Nota: Para configurar múltiplos padrões de hosts, crie um objeto de campo de widget de dashboard para cada padrão de host com um número incrementado no nome da propriedade. Para múltiplos padrões de 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 correspondentes aos padrões configurados pertençam. Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Status do host | 0 | status | -1 - (padrão) Qualquer; 0 - Habilitado; 1 - Desabilitado. Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Tags do host | ||||
| Tipo de avaliação | 0 | host_tags_evaltype | 0 - (padrão) E/Ou; 2 - Ou. Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Nome da tag | 1 | host_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 host Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Operador | 0 | host_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 host Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Valor da tag | 1 | host_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 host Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Severidade | 0 | severities.0 | 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. Padrão: vazio (todas habilitadas). 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. |
|
| Exibir hosts em manutenção | 0 | maintenance | 0 - (padrão) Desabilitado; 1 - Habilitado. |
|
| Exibir problemas | 0 | show_problems | 0 - Todos; 1 - (padrão) Não suprimidos; 2 - Nenhum. |
|
| Agrupar por | ||||
| Atributo | 0 | group_by.0.attribute | 0 - Grupo de hosts; 1 - Valor da tag; 2 - Severidade. Nota: O número no nome da propriedade faz referência à ordem do atributo na lista de atributos de agrupamento. Comportamento do parâmetro: - obrigatório se estiver configurando Agrupar por |
|
| Valor | 1 | group_by.0.tag_name | Qualquer valor de string. Nota: O número no nome da propriedade faz referência ao atributo de agrupamento definido no parâmetro Atributo. Comportamento do parâmetro: - obrigatório se estiver configurando Agrupar por e Atributo estiver definido como "Valor da tag" |
|
| Limite de hosts | 0 | show_lines | Os valores possíveis variam de 1-9999. Padrão: 100. Este parâmetro não é suportado se o widget estiver sendo configurado em um dashboard de template. |
|
| Referência | 1 | reference | Qualquer valor de string com 5 caracteres (por exemplo, ABCDE ou JBPNL). Este valor deve ser único 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 do painel para o widget Navegador de hosts. Para obter mais informações sobre como configurar um painel, consulte dashboard.create.
Configurando um widget Navegador de hosts
Configure um widget Navegador de hosts que exibe hosts agrupados por seu grupo de hosts e, em seguida, pelo valor da tag "city".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "hostnavigator",
"name": "Host navigator",
"x": "0",
"y": "0",
"width": "12",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 2
},
{
"type": 2,
"name": "groupids.1",
"value": 4
},
{
"type": 0,
"name": "group_by.0.attribute",
"value": 0
},
{
"type": 0,
"name": "group_by.1.attribute",
"value": 1
},
{
"type": 1,
"name": "group_by.1.tag_name",
"value": "city"
},
{
"type": 1,
"name": "reference",
"value": "SWKLB"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Resposta: