21 Top hosts

Descrição

Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget do painel permitem configurar o widget Top hosts nos métodos dashboard.create e dashboard.update .

As propriedades do widget fields não são validadas durante a criação ou atualização de um painel. Isso permite que os usuários modifiquem built-in widgets e criem custom widgets, 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 os requisitos de parâmetros descritos nas tabelas abaixo.

Parâmetros

Os seguintes parâmetros são suportados para o widget Top Hosts.

Parameter type nome valor
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 groups 2 groupids Host group ID.

Note: Para configurar vários host groups, crie um objeto de campo de widget de painel para cada host.
Hosts 3 hostids Host ID.

Note: Para configurar múltiplos hots, crie um objeto de campo de widget de painel para cada host. Para múltiplos hosts, o parâmetro Host groups não deve ser configurado ou configurado com pelo menos um host group ao qual os hosts configurados pertencem.
Host Tags (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)
Evaluation type 0 evaltype 0 - (padrão) E/Ou;
2 - Ou.
Tag name 1 tags.tag.0 Qualquer valor da string.

Parâmetro Nome da Tag é necessário se estiver configurando as Tags.
Operator 0 tags.operator.0 0 - Contém;
1 - Igual;
2 - Não contém;
3 - Não é igual;
4 - Existe;
5 - Não existe.

Parâmetro Operador é necessário se estiver configurando as Tags.
Tag value 1 tags.value.0 Qualquer valor da string.

Parâmetro Valor da tag é necessário se estiver configurando as Tags.
Columns (see below)
Order 0 order 2 - (padrão) Top N;
3 - Botão N.
Order column 0 column Valor númerico da coluna configurada
Host count 0 count Valores válidos variam entre 1-100.

Padrão: 10.

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 a colunas, o número no nome da propriedade (por exemplo, columsn.name.0) refere-se a uma coluna para qual o parâmetro está configurado.

Os seguintes parâmetros são suportados por todas as colunas.

Parameter type nome valor
Name 1 columns.name.0 Qualquer valor da string.
Data
(obrigatório)
0 columns.data.0 1 - Valor do item;
2 - Nome do host;
3 - Texto.
Base color
(obrigatório)
1 columns.base_color.0 Código de cor Hexadecimal (por exemplo, FF0000).
Valor do item

Os seguintes parâmetros são suportados se Data estiver configurado como "Valor do item".

O primeiro número no nome da propriedade Thresholds (por exemplo, columnsthresholds.color.0.0) refere-se à coluna para qual os thresholds estão configurados, enquanto o segundo número faz referência à posição dos thresholds em uma lista, ordenada em ordem crescente. Contudo, se thresholds estiverem 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.threshold.0":"5""threshold.threshold.0":"1"; "threshold.threshold.1":"1""threshold.threshold.1": "5").

Parameter type nome valor
Item 1 columns.item.0 Valide o nome do item.
Time shift
(required)
1 columns.timeshift.0 Valide o valor numérico ou o tempo da string (por exemplo, 3600 ou 1h).
Você pode usar time suffixes. Valores negativos são permitidos.
Aggregation function 0 columns.aggregate_function.0 0 - (padrão) nenhum;
1 - min;
2 - max;
3 - média;
4 - contar;
5 - somar;
6 - primeiro;
7 - último.
Aggregation interval 1 columns.aggregate_interval.0 Valide o tempo da string (por exemplo, 3600, 1h, etc.).
Você pode usar time suffixes.

Parâmetro Intervalo de agregação indisponível se Função da agregação estiver configurado como none.

Padrão: 1h.
Display 0 columns.display.0 1 - (padrão) As is;
2 - Barra;
3 - Indicadores.
Min 1 columns.min.0 Qualquer valor numérico.

Parâmetro Min indisponível se Display estiver configurado como "As is".
Max 1 columns.max.0 Qualquer valor numérico.

Parâmetro Max indisponível se Display estiver configurado como "As is".
History data 0 columns.history.0 1 - (padrão) Automático;
2 - Histórico;
3 - Trends.
Thresholds
Color 1 columnsthresholds.color.0.0 Código de cor Hexadecimal (por exemplo, FF0000).

Padrão: "" (vazio).
Threshold 1 columnsthresholds.threshold.0.0 Qualquer valor da string.
Texto

Os seguintes parâmetros são suportados se Data estiver configurado como "Texto".

Parameter type name valor
Text 1 columns.text.0 Qualquer valor da string, incluindo macros
Macros suportados: {HOST.*}, {INVENTORY.*}.

Parâmetro Texto obrigatório se Data estiver configurado como "Texto".

Exemplos

Os seguintes exemplos têm como objetivo apenas descrever a configuração dos objetos de campo do widget do painel para o Top hosts widget. Para mais informações sobre como configurar um painel, consulte dashboard.create.

Configurando um widget Top hosts

Configure um widget Top hosts que exibe os principais hosts por utilização da CPU no grupo de hosts "4" Além disso, configure as colunas personalizadas a seguir: "Nome do host", "Utilização", "1m avg", "5m avg", "15m avg", "Processos".

Requisição:

{
           "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": 12,
                               "height": 5,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 2,
                                       "name": "groupids",
                                       "value": 4
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.0",
                                       "value": ""
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.0",
                                       "value": 2
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.0",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.0",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.1",
                                       "value": "Utilization"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.1",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.1",
                                       "value": "4CAF50"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.1",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.1",
                                       "value": "CPU utilization"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.display.1",
                                       "value": 3
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.min.1",
                                       "value": "0"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.max.1",
                                       "value": "100"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.color.1.0",
                                       "value": "FFFF00"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.threshold.1.0",
                                       "value": "50"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.color.1.1",
                                       "value": "FF8000"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.threshold.1.1",
                                       "value": "80"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.color.1.2",
                                       "value": "FF4000"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.threshold.1.2",
                                       "value": "90"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.2",
                                       "value": "1m avg"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.2",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.2",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.2",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.2",
                                       "value": "Load average (1m avg)"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.3",
                                       "value": "5m avg"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.3",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.3",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.3",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.3",
                                       "value": "Load average (5m avg)"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.4",
                                       "value": "15m avg"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.4",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.4",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.4",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.4",
                                       "value": "Load average (15m avg)"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.5",
                                       "value": "Processes"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.5",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.5",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.5",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.5",
                                       "value": "Number of processes"
                                   },
                                   {
                                       "type": 0,
                                       "name": "column",
                                       "value": 1
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Veja também

-Campo widget do dashboard -dashboard.create -dashboard.update