Table of Contents
25 Gráfico de dispersão
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 Gráfico de dispersão 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 Gráfico de dispersão, consulte o comportamento dos parâmetros descritos nas tabelas abaixo.
Parâmetros
Os seguintes parâmetros são suportados para o widget Gráfico de dispersão.
| 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. |
| 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 |
Conjunto de dados
Os seguintes parâmetros são suportados para configurar um Conjunto de dados.
O primeiro número no nome da propriedade (por exemplo, ds.0.hosts.0, ds.0.items.0) representa o conjunto de dados em particular, enquanto o segundo número, se presente, representa o host ou item configurado.
| Parâmetro | tipo | nome | valor | |
|---|---|---|---|---|
| Tipo de conjunto de dados | 0 | ds.0.dataset_type | 0 - Lista de items; 1 - (padrão) Padrões de items. |
|
| Conjunto de dados: Lista de items | ||||
| Cor | 1 | ds.0.color.0 | Código de cor hexadecimal (por exemplo, FF0000).Comportamento do parâmetro: - obrigatório se o Tipo de conjunto de dados estiver definido como "Lista de items" |
|
| Eixo X | 4 | ds.0.x_axis_itemids.0 | ID do Item. Ao configurar o widget em um dashboard de template, apenas os items configurados no template devem ser definidos. Nota: Para configurar múltiplos items, crie um objeto de campo de widget de dashboard para cada item com um número incrementado no nome da propriedade. Comportamento do parâmetro: - obrigatório se o Tipo de conjunto de dados estiver definido como "Lista de items" e Eixo X (Widget) não estiver definido |
|
| Eixo X (Widget) | 1 | ds.0.x_axis_itemids.0._reference | Em vez do ID do Item:ABCDE._itemid - defina um widget compatível (com seu parâmetro Referência definido como "ABCDE") como a fonte de dados para items.Nota: Para configurar múltiplos widgets, crie um objeto de campo de widget de dashboard para cada widget com um número incrementado no nome da propriedade. Comportamento do parâmetro: - obrigatório se o Tipo de conjunto de dados estiver definido como "Lista de items" e Eixo X não estiver definido |
|
| Eixo Y | 4 | ds.0.y_axis_itemids.0 | ID do Item. Ao configurar o widget em um dashboard de template, apenas os items configurados no template devem ser definidos. Nota: Para configurar múltiplos items, crie um objeto de campo de widget de dashboard para cada item com um número incrementado no nome da propriedade. Comportamento do parâmetro: - obrigatório se o Tipo de conjunto de dados estiver definido como "Lista de items" e Eixo Y (Widget) não estiver definido |
|
| Eixo Y (Widget) | 1 | ds.0.y_axis_itemids.0._reference | Em vez do ID do Item:ABCDE._itemid - defina um widget compatível (com seu parâmetro Referência definido como "ABCDE") como a fonte de dados para items.Nota: Para configurar múltiplos widgets, crie um objeto de campo de widget de dashboard para cada widget com um número incrementado no nome da propriedade. Comportamento do parâmetro: - obrigatório se o Tipo de conjunto de dados estiver definido como "Lista de items" e Eixo Y não estiver definido |
|
| Sobrescrever host | 1 | ds.0.override_hostid._reference | ABCDE._hostid- defina um widget compatível (com seu parâmetro "Referência" definido como "ABCDE") como a fonte de dados para hosts;DASHBOARD._hostid - defina o seletor de host do dashboard como a fonte de dados para hosts.Este parâmetro não é suportado ao configurar o widget em um dashboard de template. |
|
| Conjunto de dados: Padrões de items | ||||
| Cor | 1 | ds.0.color | Código de cor hexadecimal (por exemplo, FF0000).Comportamento do parâmetro: - suportado se o Tipo de conjunto de dados estiver definido como "Padrões de items" e Paleta de cores não estiver definida |
|
| Paleta de cores | 0 | ds.0.color_palette | Índice da paleta de cores. Valores possíveis: 0-11. Padrão: 0. Comportamento do parâmetro: - suportado se o Tipo de conjunto de dados estiver definido como "Padrões de items" e Cor não estiver definida |
|
| Padrões de host | 1 | ds.0.hosts.0 | Nome ou padrão do Host (por exemplo, "Zabbix*"). Comportamento do parâmetro: - obrigatório se o Tipo de conjunto de dados estiver definido como "Padrões de items" Este parâmetro não é suportado ao configurar o widget em um dashboard de template. |
|
| Padrões de item do eixo X | 1 | ds.0.x_axis_items.0 | Nome ou padrão do Item (por exemplo, "*: Número de valores processados por segundo"). Ao configurar o widget em um dashboard de template, apenas os padrões para items configurados no template devem ser definidos. Comportamento do parâmetro: - obrigatório se o Tipo de conjunto de dados estiver definido como "Padrões de items" |
|
| Padrões de item do eixo Y | 1 | ds.0.y_axis_items.0 | Nome ou padrão do Item (por exemplo, "*: Número de valores processados por segundo"). Ao configurar o widget em um dashboard de template, apenas os padrões para items configurados no template devem ser definidos. Comportamento do parâmetro: - obrigatório se o Tipo de conjunto de dados estiver definido como "Padrões de items" |
|
| 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 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 seu parâmetro Referência definido como "ABCDE") como a fonte de dados para grupos de hosts.Este parâmetro não é suportado ao configurar o widget em um dashboard de template. |
|
| Sobrescrever host | 1 | ds.0.override_hostid._reference | ABCDE._hostid- defina um widget compatível (com seu parâmetro "Referência" definido como "ABCDE") como a fonte de dados para hosts;DASHBOARD._hostid - defina o seletor de host do dashboard como a fonte de dados para hosts.Este parâmetro não é suportado ao configurar o widget em um dashboard de template. |
|
| Tags de host | ||||
| Tipo de avaliação | 0 | evaltype_host | 0 - (padrão) E/OU; 2 - OU. Este parâmetro não é suportado ao configurar o widget 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 de host Este parâmetro não é suportado ao configurar o widget 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 de host Este parâmetro não é suportado ao configurar o widget 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 de host Este parâmetro não é suportado ao configurar o widget em um dashboard de template. |
|
| Marcador | 0 | ds.0.marker | 0 - (padrão) Elipse; 1 - Quadrado; 2 - Triângulo; 3 - Losango; 4 - Estrela; 5 - Cruz. |
|
| Tamanho do marcador | 0 | ds.0.marker_size | 0 - (padrão) Pequeno (6px); 1 - Médio (9px); 2 - Grande (15px). |
|
| Deslocamento de tempo | 1 | ds.0.timeshift | String de tempo válida (por exemplo, 3600, 1h, etc.).Você pode usar sufixos de tempo. Valores negativos também são permitidos. Padrão: "" (vazio). |
|
| Intervalo de agregação | 1 | ds.0.aggregate_interval | String de tempo válida (por exemplo, 3600, 1h, etc.).Você pode usar sufixos de tempo. Padrão: 15m. |
|
| Função de agregação | 0 | ds.0.aggregate_function | 0 - não usado; 1 - min; 2 - max; 3 - (padrão) avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
Opções de exibição
Os seguintes parâmetros são suportados para configurar as Opções de exibição.
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Seleção de dados históricos | 0 | source | 0 - (padrão) Automático; 1 - Histórico; 2 - Tendências. |
Período de tempo
Os seguintes parâmetros são suportados para configurar o Período de tempo.
| Parâmetro | tipo | nome | valor | |
|---|---|---|---|---|
| Período de tempo | 1 | time_period._reference | DASHBOARD._timeperiod - define o seletor de período de tempo do dashboard como a fonte de dados;ABCDE._timeperiod - define um widget compatível (com seu parâmetro Referência definido como "ABCDE") como a fonte de dados.Padrão: DASHBOARD._timeperiodAlternativamente, você pode definir o período de tempo apenas nos parâmetros De e Até. |
|
| De | 1 | time_period.from | String de tempo válida na sintaxe absoluta (YYYY-MM-DD hh:mm:ss) ou relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - suportado se Período de tempo não estiver definido |
|
| Até | 1 | time_period.to | String de tempo válida na sintaxe absoluta (YYYY-MM-DD hh:mm:ss) ou relativa (now, now/d, now/w-1w, etc.).Comportamento do parâmetro: - suportado se Período de tempo não estiver definido |
|
Eixos
Os seguintes parâmetros são suportados para configurar Eixos.
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Eixo X | 0 | x_axis | 0 - Desabilitado; 1 - (padrão) Habilitado. |
| Eixo Y | 0 | y_axis | 0 - (padrão) Desabilitado; 1 - Habilitado. |
| Mín | 1 | x_axis_min | Qualquer valor numérico. Padrão: "" (vazio). |
| y_axis_min | |||
| Máx | 1 | x_axis_max | Qualquer valor numérico. Padrão: "" (vazio). |
| y_axis_max | |||
| Unidades (tipo) | 0 | x_axis_units | 0 - (padrão) Automático; 1 - Estático. |
| y_axis_units | |||
| Unidades (valor) | 1 | x_axis_static_units | Qualquer valor de string. Padrão: "" (vazio). |
| y_axis_static_units |
Legenda
Os seguintes parâmetros são suportados para configurar a Legenda.
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Exibir legenda | 0 | legend | 0 - Desabilitado; 1 - (padrão) Habilitado. |
| Exibir função de agregação | 0 | legend_aggregation | 0 - (padrão) Desabilitado; 1 - Habilitado. Comportamento do parâmetro: - suportado se Exibir legenda estiver definido como "Habilitado" |
| Linhas | 0 | legend_lines_mode | 0 - (padrão) Fixo; 1 - Variável. Comportamento do parâmetro: - suportado se Exibir legenda estiver definido como "Habilitado" |
| Número de linhas/ Número máximo de linhas |
0 | legend_lines | Faixa de valores possíveis: 1-10. Padrão: 1. Comportamento do parâmetro: - suportado se Exibir legenda estiver definido como "Habilitado" |
| Número de colunas | 0 | legend_columns | Faixa de valores possíveis: 1-4. Padrão: 4. Comportamento do parâmetro: - suportado se Exibir legenda estiver definido como "Habilitado" |
Limiares
Os seguintes parâmetros são suportados para configurar Limiares.
O número no nome da propriedade Limiares (por exemplo, thresholds.0.color) faz referência à posição do limiar em uma lista, ordenada em ordem crescente. No entanto, se os limiares 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, "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Interpolação de cor | 0 | interpolation | 0 - (padrão) Desabilitado; 1 - Habilitado. |
| Cor | 1 | thresholds.0.color | Código de cor hexadecimal (por exemplo, FF0000). |
| Eixo X | 1 | thresholds.0.x_axis_threshold | Qualquer valor numérico. Sufixos (por exemplo, "1d", "2w", "4K", "8G") são suportados. |
| Eixo Y | 1 | thresholds.0.y_axis_threshold | Qualquer valor numérico. Sufixos (por exemplo, "1d", "2w", "4K", "8G") são suportados. |
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 Gráfico de dispersão. Para obter mais informações sobre como configurar um painel, consulte dashboard.create.
Configurando um widget Scatter plot
Configure um widget Scatter plot da seguinte forma:
- 5 conjuntos de dados do tipo "Padrões de item", cada um com agregação padrão (avg, 15m) e marcadores diferentes.
- A legenda exibe os itens configurados em uma única linha e duas colunas.
- Os thresholds são configurados para colorir um marcador de vermelho quando seu valor atingir 80 em qualquer eixo.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "scatterplot",
"name": "Scatter plot",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "ds.0.color",
"value": "0C5A87"
},
{
"type": 1,
"name": "ds.0.hosts.0",
"value": "de-frankfurt*"
},
{
"type": 1,
"name": "ds.0.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.0.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.0.marker",
"value": 0
},
{
"type": 0,
"name": "ds.0.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.1.color",
"value": "66B0D9"
},
{
"type": 1,
"name": "ds.1.hosts.0",
"value": "fr-paris*"
},
{
"type": 1,
"name": "ds.1.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.1.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.1.marker",
"value": 1
},
{
"type": 0,
"name": "ds.1.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.2.color",
"value": "0A466A"
},
{
"type": 1,
"name": "ds.2.hosts.0",
"value": "lv-riga*"
},
{
"type": 1,
"name": "ds.2.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.2.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.2.marker",
"value": 2
},
{
"type": 0,
"name": "ds.2.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.3.color",
"value": "3394C3"
},
{
"type": 1,
"name": "ds.3.hosts.0",
"value": "pl-warsaw*"
},
{
"type": 1,
"name": "ds.3.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.3.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.3.marker",
"value": 3
},
{
"type": 0,
"name": "ds.3.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.4.color",
"value": "1492C8"
},
{
"type": 1,
"name": "ds.4.hosts.0",
"value": "se-stockholm*"
},
{
"type": 1,
"name": "ds.4.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.4.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.4.marker",
"value": 4
},
{
"type": 0,
"name": "ds.4.marker_size",
"value": 1
},
{
"type": 0,
"name": "legend_columns",
"value": 2
},
{
"type": 0,
"name": "interpolation",
"value": 1
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.0.x_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "thresholds.0.y_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.1.x_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.y_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "reference",
"value": "JQISY"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Resposta: