Nesta página
28 Principais 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 Top 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 Top hosts, consulte o comportamento dos parâmetros descrito nas tabelas abaixo.
Parâmetros
Os seguintes parâmetros são compatíveis com o widget Top hosts.
| Parâmetro | type | name | value | |
|---|---|---|---|---|
| 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. 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. |
|
| Grupos de hosts (Widget) | 1 | groupids._reference | Em vez do ID do grupo de hosts:ABCDE._hostgroupids - defina um widget compatível (com o parâmetro Reference definido como "ABCDE") como fonte de dados para grupos de hosts.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. |
|
| Hosts (Widget/Dashboard) | 1 | hostids._reference | Em vez do ID do host:DASHBOARD.hostids - defina o seletor de hosts do dashboard como fonte de dados para hosts;ABCDE._hostids - defina um widget compatível (com o parâmetro Reference definido como "ABCDE") como fonte de dados para hosts.Este parâmetro não é compatível ao configurar o widget em um dashboard de template. |
|
| Tags de host | ||||
| Tipo de avaliação | 0 | evaltype | 0 - (padrão) E/OU; 2 - OU. Este parâmetro não é compatível ao configurar o widget em um dashboard de template. |
|
| 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 de host Este parâmetro não é compatível ao configurar o widget em um dashboard de template. |
|
| 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 de host Este parâmetro não é compatível ao configurar o widget em um dashboard de template. |
|
| 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 de host Este parâmetro não é compatível ao configurar o widget em um dashboard de template. |
|
| Mostrar hosts em manutenção | 0 | maintenance | 0 - (padrão) Desabilitado; 1 - Habilitado. |
|
| Colunas (veja abaixo) | ||||
| Ordenar por | 0 | column | Valor numérico da coluna entre as colunas configuradas. | |
| Ordem | 0 | order | 2 - (padrão) N primeiros; 3 - N últimos. |
|
| Limite de hosts | 0 | show_lines | Os valores possíveis variam de 1 a 1000. Padrão: 10. Este parâmetro não é compatível ao configurar o widget em um dashboard de template. |
|
Colunas
As colunas possuem parâmetros comuns e parâmetros adicionais dependendo da configuração do parâmetro Data.
Para todos os parâmetros relacionados às colunas, o número no nome da propriedade (por exemplo, columns.0.name) faz referência a uma coluna para a qual o parâmetro está configurado.
Os seguintes parâmetros são suportados para todas as colunas.
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Nome | 1 | columns.0.name | Qualquer valor de string. Comportamento do parâmetro: - obrigatório |
| Dados | 0 | columns.0.data | 1 - Valor do item; 2 - Nome do host; 3 - Texto. Comportamento do parâmetro: - obrigatório |
| Cor base | 1 | columns.0.base_color | Código de cor hexadecimal (por exemplo, FF0000).Comportamento do parâmetro: - obrigatório |
Valor do item
Os seguintes parâmetros são compatíveis quando Dados está definido como "Valor do item".
O primeiro número no nome da propriedade Limites (por exemplo, columnsthresholds.0.color.0) faz referência à coluna para a qual os limites estão configurados, enquanto o segundo número faz referência à posição do limite em uma lista ordenada em ordem crescente.
No entanto, se os limites forem configurados em uma ordem diferente, os valores serão ordenados em ordem crescente após a atualização da configuração do widget no frontend do Zabbix (por exemplo, "threshold.0.threshold":"5" → "threshold.0.threshold":"1"; "threshold.1.threshold":"1" → "threshold.1.threshold": "5").
| Parâmetro | tipo | nome | valor | |
|---|---|---|---|---|
| Item | 1 | columns.0.item | Nome de item válido. Ao configurar o widget em um dashboard de template, somente os itens configurados no template devem ser definidos. |
|
| Exibir valor do item como | 0 | columns.0.display_value_as | 0 - (padrão) Numérico; 1 - Texto; 2 - Binário. |
|
| Exibição | 0 | columns.0.display | 1 - (padrão) Como está; 2 - Barra; 3 - Indicadores; 6 - Sparkline. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" |
|
| Mín. | 1 | columns.0.min | Qualquer valor numérico. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Barra" ou "Indicadores" |
|
| Máx. | 1 | columns.0.max | Qualquer valor numérico. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Barra" ou "Indicadores" |
|
| Casas decimais | 0 | columns.0.decimal_places | Os valores possíveis variam de 0 a 10. Padrão: 2. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" |
|
| Sparkline | ||||
| Largura | 0 | columns.0.sparkline.width | Os valores possíveis variam de 0 a 10. Padrão: 1. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Sparkline" |
|
| Preenchimento | 0 | columns.0.sparkline.fill | Os valores possíveis variam de 0 a 10. Padrão: 3. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Sparkline" |
|
| Cor | 1 | columns.0.sparkline.color | Código de cor hexadecimal (por exemplo, FF0000).Padrão: 42A5F5.Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Sparkline" |
|
| Período de tempo | 1 | columns.0.sparkline.time_period._reference | DASHBOARD._timeperiod - define o seletor de período de tempo do dashboard como fonte de dados;ABCDE._timeperiod - define um widget compatível (com o parâmetro reference igual a ABCDE) como fonte de dados.Padrão: DASHBOARD._timeperiodComo alternativa, você pode definir o período de tempo somente nos parâmetros De e Até. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Sparkline" |
|
| De | 1 | columns.0.sparkline.time_period.from | String de tempo válida na sintaxe de tempo absoluta (YYYY-MM-DD hh:mm:ss) ou relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Sparkline" - obrigatório se columns.0.sparkline.time_period.to estiver definido |
|
| Até | 1 | columns.0.sparkline.time_period.to | String de tempo válida na sintaxe de tempo absoluta (YYYY-MM-DD hh:mm:ss) ou relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Sparkline" - obrigatório se columns.0.sparkline.time_period.from estiver definido |
|
| Dados históricos | 0 | columns.0.sparkline.history | 0 - (padrão) Automático; 1 - Histórico; 2 - Tendências. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" e Exibição estiver definida como "Sparkline" |
|
| Limites | ||||
| Cor | 1 | columnsthresholds.0.color.0 | Código de cor hexadecimal (por exemplo, FF0000).Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" |
|
| Limite | 1 | columnsthresholds.0.threshold.0 | Qualquer valor de string. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" |
|
| Destaques | ||||
| Cor | 1 | columns.0.highlights.0.color | Código de cor hexadecimal (por exemplo, FF0000).Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Texto" |
|
| Padrão | 1 | columns.0.highlights.0.pattern | Qualquer valor de string. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Texto" |
|
| Mostrar miniatura | 0 | columns.0.show_thumbnail | 0 - (padrão) Desabilitado; 1 - Habilitado. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Binário" |
|
| Função de agregação | 0 | columns.0.aggregate_function | 0 - (padrão) não utilizada; 1 - mín.; 2 - máx.; 3 - média; 4 - contagem; 5 - soma; 6 - primeiro; 7 - último. |
|
| Período de tempo | 1 | columns.0.time_period._reference | DASHBOARD._timeperiod - define o seletor de período de tempo do dashboard como fonte de dados;ABCDE._timeperiod - define um widget compatível (com o parâmetro reference igual a ABCDE) como fonte de dados.Padrão: DASHBOARD._timeperiodComo alternativa, você pode definir o período de tempo somente nos parâmetros De e Até. Comportamento do parâmetro: - compatível se Função de agregação estiver definida como "mín.", "máx.", "média", "contagem", "soma", "primeiro" ou "último" |
|
| De | 1 | columns.0.time_period.from | String de tempo válida na sintaxe de tempo absoluta (YYYY-MM-DD hh:mm:ss) ou relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - compatível se Período de tempo não estiver definido e Função de agregação estiver definida como "mín.", "máx.", "média", "contagem", "soma", "primeiro" ou "último" - obrigatório se columns.0.time_period.to estiver definido |
|
| Até | 1 | columns.0.time_period.to | String de tempo válida na sintaxe de tempo absoluta (YYYY-MM-DD hh:mm:ss) ou relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - compatível se Período de tempo não estiver definido e Função de agregação estiver definida como "mín.", "máx.", "média", "contagem", "soma", "primeiro" ou "último" - obrigatório se columns.0.time_period.from estiver definido |
|
| Dados históricos | 0 | columns.0.history | 0 - (padrão) Automático; 1 - Histórico; 2 - Tendências. Comportamento do parâmetro: - compatível se Exibir valor do item como estiver definido como "Numérico" |
|
| Referência | 1 | reference | Qualquer valor de string composto por 5 caracteres (por exemplo, ABCDE ou JBPNL). Esse valor deve ser exclusivo no dashboard ao qual o widget pertence.Comportamento do parâmetro: - obrigatório |
|
Texto
Os seguintes parâmetros são suportados se Data estiver definido como "Text".
| Parameter | type | name | value |
|---|---|---|---|
| Text | 1 | columns.0.text | Qualquer valor de string, incluindo macros. Macros suportadas: {HOST.*}, {INVENTORY.*}.Comportamento do parâmetro: - obrigatório se Data estiver definido como "Text" |
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 Top hosts.
Para mais informações sobre como configurar um dashboard, consulte dashboard.create.
Configurando um widget Top hosts
Configure um widget Top hosts que exibe os principais hosts por utilização de CPU no grupo de hosts "4". Além disso, configure as seguintes colunas personalizadas: "Nome do host", "Utilização da CPU em %", "1m avg", "5m avg", "15m avg", "Processos".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "tophosts",
"name": "Top hosts",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 1,
"name": "columns.0.name",
"value": "Host"
},
{
"type": 0,
"name": "columns.0.data",
"value": 2
},
{
"type": 1,
"name": "columns.0.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.1.name",
"value": "CPU utilization in %"
},
{
"type": 0,
"name": "columns.1.data",
"value": 1
},
{
"type": 1,
"name": "columns.1.base_color",
"value": "4CAF50"
},
{
"type": 1,
"name": "columns.1.item",
"value": "CPU utilization"
},
{
"type": 0,
"name": "columns.1.display",
"value": 3
},
{
"type": 1,
"name": "columns.1.min",
"value": "0"
},
{
"type": 1,
"name": "columns.1.max",
"value": "100"
},
{
"type": 1,
"name": "columnsthresholds.1.color.0",
"value": "FFFF00"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.0",
"value": "50"
},
{
"type": 1,
"name": "columnsthresholds.1.color.1",
"value": "FF8000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.1",
"value": "80"
},
{
"type": 1,
"name": "columnsthresholds.1.color.2",
"value": "FF4000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.2",
"value": "90"
},
{
"type": 1,
"name": "columns.2.name",
"value": "1m avg"
},
{
"type": 0,
"name": "columns.2.data",
"value": 1
},
{
"type": 1,
"name": "columns.2.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.2.item",
"value": "Load average (1m avg)"
},
{
"type": 1,
"name": "columns.3.name",
"value": "5m avg"
},
{
"type": 0,
"name": "columns.3.data",
"value": 1
},
{
"type": 1,
"name": "columns.3.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.3.item",
"value": "Load average (5m avg)"
},
{
"type": 1,
"name": "columns.4.name",
"value": "15m avg"
},
{
"type": 0,
"name": "columns.4.data",
"value": 1
},
{
"type": 1,
"name": "columns.4.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.4.item",
"value": "Load average (15m avg)"
},
{
"type": 1,
"name": "columns.5.name",
"value": "Processes"
},
{
"type": 0,
"name": "columns.5.data",
"value": 1
},
{
"type": 1,
"name": "columns.5.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.5.item",
"value": "Number of processes"
},
{
"type": 0,
"name": "columns.5.decimal_places",
"value": 0
},
{
"type": 0,
"name": "column",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}