13 Cartão de host
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 Host card 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 Host card, consulte o comportamento dos parâmetros descritos nas tabelas abaixo.
Parâmetros
Os seguintes parâmetros são suportados para o widget Host card.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 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. |
|
| Host | 3 | hostid.0 | ID do Host. Comportamento do parâmetro: - obrigatório se Host (Widget/Dashboard) não estiver definido Este parâmetro não é suportado ao configurar o widget em um template dashboard. |
|
| Host (Widget/Dashboard) | 1 | hostid._reference | Em vez do ID do Host:DASHBOARD.hostid - define o seletor Host como a fonte de dados do host;ABCDE._hostid - define um widget compatível (com seu parâmetro Reference definido como "ABCDE") como a fonte de dados do host.Comportamento do parâmetro: - obrigatório se Host não estiver definido Este parâmetro não é suportado ao configurar o widget em um template dashboard. |
|
| Show suppressed problems | 0 | show_suppressed | 0 - (padrão) Desativado; 1 - Ativado. |
|
| Show | 0 | sections.0 | 0 - Grupos de hosts; 1 - Descrição; 2 - Monitoramento; 3 - Disponibilidade; 4 - Monitorado por; 5 - Templates; 6 - Inventário; 7 - Tags. Nota: O número no nome da propriedade faz referência à ordem da seção na lista de seções. Para configurar várias seções, crie um objeto de campo do widget do dashboard para cada seção com um número incrementado no nome da propriedade. |
|
Os seguintes parâmetros são suportados se Show estiver definido como "Inventory".
| Parameter | type | name | value |
|---|---|---|---|
| Inventory fields | 0 | inventory.0 | ID do Inventory. Nota: Para configurar vários campos de inventário, crie um objeto de campo do widget do dashboard para cada campo de inventário com um número incrementado no nome da propriedade. |
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 Host card.
Para obter mais informações sobre como configurar um painel, consulte dashboard.create.
Configurando um widget Host card
Configure um widget Host card que exibe estas seções: "Monitoring", "Availability", "Monitored by", "Inventory" e "Tags".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "hostcard",
"name": "Host card",
"x": 0,
"y": 0,
"width": 14,
"height": 7,
"view_mode": 0,
"fields": [
{
"type": 3,
"name": "hostid.0",
"value": 10084
},
{
"type": 0,
"name": "show_suppressed",
"value": 1
},
{
"type": 0,
"name": "sections.0",
"value": 2
},
{
"type": 0,
"name": "sections.1",
"value": 3
},
{
"type": 0,
"name": "sections.2",
"value": 4
},
{
"type": 0,
"name": "sections.3",
"value": 6
},
{
"type": 0,
"name": "sections.4",
"value": 7
},
{
"type": 0,
"name": "inventory.0",
"value": 25
},
{
"type": 0,
"name": "inventory.1",
"value": 26
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}