Nesta página
8 Gráfico
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 Graph nos métodos dashboard.create e dashboard.update .
As propriedades dos campos Widget fields properties não são validadas durante a criação ou atualização de um dashboard. Isso permite aos usuários modificar built-in widgets e criar 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 Graph, consulte os requisitos de parâmetro descritos nas tabelas abaixo.
Parâmetros
The following parameters are supported for the Graph widget.
| Parâmetro | type | 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. |
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.hosts.0.0, ds.items.0.0) representa o conjunto de dados específico, enquanto o segundo número, se presente, representa o host ou item configurado.
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Padrão de host (obrigatório) |
1 | ds.hosts.0.0 | Nome ou padrão de Host (por exemplo Zabbix*). |
| Padrão e item (obrigatório) |
1 | ds.items.0.0 | Nome ou padão de Item (por exemplo *: Number of processed *values per second). |
| Cor | 1 | ds.color.0 | Código de cor hexadecimal (por exemplo, FF0000).Padrão: FF465C. |
| Desenhar | 0 | ds.type.0 | 0 - (padrão) Linha; 1 - Pontos; 2 - Escada; 3 - Barra. |
| Largura | 0 | ds.width.0 | Valores válidos variam entre 1-10. Padrão: 1. Parâmetro Largura não disponível se o Desenhar estiver configurado como "Pontos" ou "Barra". |
| Tamanho do ponto | 0 | ds.pointsize.0 | Valores válidos variam entre 1-10. Padrão: 3. Parâmetro Tamanho do ponto não disponível se Desenhar estiver definido como "Linha", "Escada" or "Barra". |
| Transparência | 0 | ds.transparency.0 | Valores válidos variam entre 1-10. Padrão: 5. |
| Preenchimento | 0 | ds.fill.0 | Valores válidos variam entre 1-10. Padrão: 3. Parâmetro Preenchimento não disponível se Desenhar estiver configurado como "Pontos" ou "Barra". |
| Missing data | 0 | ds.missingdatafunc.0 | 0 - (padrão) Nenhum; 1 - Conectado; 2 - Tratar como 0. Parâmetro Dados ausentes não disponível se Desenhar estiver configurado como "Pontos" ou "Barra". |
| Eixo Y | 0 | ds.axisy.0 | 0 - (padrão) Esquerda; 1 - Direita. |
| Deslocamento de tempo | 1 | ds.timeshift.0 | String de tempo válida (e.g. 3600, 1h, etc.).Você pode usar time suffixes. Valores negativos também são permitidos. Padrão: "" (vazio). |
| Função de agregação | 0 | ds.aggregate_function.0 | 0 - (padrão) nenhuma; 1 - minuto; 2 - máximo; 3 - média; 4 - contagem; 5 - somar; 6 - primeiro; 7 - último. |
| Intervalo da agregação | 1 | ds.aggregate_interval.0 | String de tempo válida (por exemplo 3600, 1h, etc.).You may use time suffixes. Padrão: 1h. |
| Agregado | 0 | ds.aggregate_grouping.0 | 0 - (padrão) Cada item; 1 - Conjunto de dados. Parâmetro Agregado não válido se Função da agregação estiver configurada como "none". |
Opções de exibição
Os seguintes parâmetros são suportados para configurar Opções de exibição.
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Seleção de dados de histórico | 0 | source | 0 - (padrão) Automático; 1 - Histórico; 2 - Trends. |
Período de tempo
Os seguintes parâmetros são suportados para configurar Período de tempo.
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Definir período de tempo personalizado | 0 | graph_time | 0 - (padrão) Desativado; 1 - Ativado. |
| De | 1 | time_from | String de tempo válida no formato YYYY-MM-DD hh:mm:ss.Relative time period valores de ( now, now/d, now/w-1w, etc.) também são suportados.Padrão: now-1h. |
| Para | 1 | time_to | String de tempo válida no formato YYYY-MM-DD hh:mm:ss.Relative time period Valores de ( now, now/d, now/w-1w, etc.)também são suportados.Padrão: now. |
Axes (Eixos)
Os seguintes parâmetros são suportados para configurar Axes (eixos).
| Parâmetro | type | nome | valor | |
|---|---|---|---|---|
| Eixo Y esquerdo | 0 | lefty | 0 - Desativado; 1 - (padrão) Ativado. Parâmetro disponível se o Eixo Y (na configuração do Conjunto de Dados) estiver definido como "Left". |
|
| Eixo Y direito | 0 | righty | 0 - (padrão) Desativado; 1 - Ativado. Parâmetro disponível se o Eixo Y (na configuração do Conjunto de Dados) estiver definido como "Right". |
|
| Min | 1 | lefty_min | Qualquer valor numérico. Padrão: "" (vazio). |
|
| ^ | ^ | righty_min | ^ | |
| Max | 1 | lefty_max | Qualquer valor numérico. Padrão: "" (vazio). |
|
| ^ | ^ | righty_max | ^ | |
| Unidades (tipo) | 0 | lefty_units | 0 - (padrão) Auto; 1 - Estático. |
|
| ^ | ^ | righty_units | ^ | |
| Unidades (valor) | 1 | lefty_static_units | Qualquer valor de string. Padrão: "" (vazio). |
|
| ^ | ^ | righty_static_units | ^ | |
| X-Axis | 0 | xaxis | 0 - Desativado; 1 - (padrão) Ativado. |
. |
Legenda
Os seguintes parâmetros são suportados para configurar a Legenda.
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Mostrar legenda | 0 | legend | 0 - Desativado; 1 - (padrão) Ativado. |
| Mostrar linhas | 0 | legend_lines | Valores válidos variam entre 1-5. Padrão: 1. |
Problemas
The following parameters are supported for configuring Problems.
| Parâmetro | type | nome | valor | |
|---|---|---|---|---|
| Mostrar problemas | 0 | show_problems | 0 - (padrão) Desativado; 1 -Ativado. |
|
| Apenas itens selecionados | 0 | graph_item_problems | 0 - Desativado; 1 - (padrão) Ativado. |
|
| Hosts de problema | 1 | problemhosts.0 | Nome do Host. Nota: O número no nome da propriedade se refere ao host configurado. Para configurar múltiplos hosts, crie um objeto de campo de widget de painel para cada host. |
|
| Gravidade | 0 | severities | 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. Padrão: vazio (todos habilitados). Note: Para configurar múltiplos valores, crie um objeto de campo de widget de painel para cada valor. |
|
| Problema | 1 | problem_name | Nome do problema event name (insensível a maiúsculas, nome completo ou parte dele). | |
| Tags o número no nome da propriedade (por exemplo, tags.tag.0) refere-se à ordem da tag na lista de avaliação de tags) | ||||
| Tipo de avaliação | 0 | evaltype | 0 - (padrão) E/Ou; 2 - Ou. |
|
| Nome da tag | 1 | tags.tag.0 | Qualquer valor de string. Parâmetro Tag name obrigatório se estiver configurando Tags. |
|
| Operador | 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 obrigatório se estiver configurando Tags. |
|
| Valor da tag | 1 | tags.value.0 | Qualquer valor de string. Parâmetro Valor da tag obrigatório se estiver configurando Tags. |
|
Substituições
Os seguintes parâmetros são suportados para configurar Substituições.
O primeiro número no nome da propriedade (por exemplo, or.hosts.0.0, or.items.0.0) representa o conjunto de dados específico, enquanto o segundo número, se presente, representa o host ou item configurado.
| Parâmetro | type | nome | valor |
|---|---|---|---|
| Host pattern (obrigatório) |
1 | or.hosts.0.0 | Nome ou padrão do Host (por exemplo, Zabbix*). |
| Item pattern (obrigatório) |
1 | or.items.0.0 | Nome ou padrão do Item (por exemplo, *: Number of processed *values per second). |
| Cor base | 1 | or.color.0 | Código de cor hexadecimal (por exemplo, FF0000). |
| Largura | 0 | or.width.0 | Valores válidos variam de 1 a 10. |
| Desenhar | 0 | or.type.0 | 0 - Linha; 1 - Pontos; 2 - Escada; 3 - Barra. |
| Transparência | 0 | or.transparency.0 | Valores válidos variam de 1 a 10. |
| Preenchimento | 0 | or.fill.0 | Valores válidos variam de 1 a 10. |
| Tamanho do ponto | 0 | or.pointsize.0 | Valores válidos variam de 1 a 10. |
| Dados ausentes | 0 | or.missingdatafunc.0 | 0 - Nenhum; 1 - Conectado; 2 - Tratar como 0. |
| Eixo-Y | 0 | or.axisy.0 | 0 - Esquerdo; 1 - Direito. |
| Deslocamento de tempo | 1 | or.timeshift.0 | String de tempo válida (por exemplo, 3600, 1h, etc.).Você pode usar time suffixes. Valores negativos são permitidos. |
Exemplos
Os exemplos a seguir têm o objetivo de descrever apenas a configuração dos objetos de campo do widget do Gráfico. Para obter mais informações sobre como configurar um painel, consulte dashboard.create.
Configurando um widget Graph
Configure um widget Gráfico da seguinte forma:
- 4 conjuntos de dados para um total de 9 itens em 1 host.
- Cada conjunto de dados consiste em uma linha que possui uma cor personalizada, largura, transparência e preenchimento.
- O conjunto de dados 4 tem uma agregação configurada.
- Os dados no gráfico são exibidos para um período de tempo das últimas 3 horas.
- Problemas no gráfico são exibidos apenas para os itens configurados.
- O gráfico possui dois eixos Y, dos quais o eixo Y direito exibe valores apenas para o conjunto de dados 4..
- A legenda do gráfico exibe os itens configurados em 2 linhas.
Requisição:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "svggraph",
"name": "Graph",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "ds.hosts.0.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.0.0",
"value": "Zabbix server: Utilization of poller data collector processes, in %"
},
{
"type": 1,
"name": "ds.color.0",
"value": "FF0000"
},
{
"type": 0,
"name": "ds.width.0",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.0",
"value": 3
},
{
"type": 0,
"name": "ds.fill.0",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.1.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.1.0",
"value": "Zabbix server: Utilization of trapper data collector processes, in %"
},
{
"type": 1,
"name": "ds.color.1",
"value": "BF00FF"
},
{
"type": 0,
"name": "ds.width.1",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.1",
"value": 3
},
{
"type": 0,
"name": "ds.fill.1",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.2.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.2.0",
"value": "Zabbix server: Utilization of history syncer internal processes, in %"
},
{
"type": 1,
"name": "ds.color.2",
"value": "0040FF"
},
{
"type": 0,
"name": "ds.width.2",
"value": 3
},
{
"type": 0,
"name": "ds.transparency.2",
"value": 3
},
{
"type": 0,
"name": "ds.fill.2",
"value": 1
},
{
"type": 1,
"name": "ds.hosts.3.0",
"value": "Zabbix server"
},
{
"type": 1,
"name": "ds.items.3.0",
"value": "*: Number of processed *values per second"
},
{
"type": 1,
"name": "ds.color.3",
"value": "000000"
},
{
"type": 0,
"name": "ds.transparency.3",
"value": 0
},
{
"type": 0,
"name": "ds.fill.3",
"value": 0
},
{
"type": 0,
"name": "ds.axisy.3",
"value": 1
},
{
"type": 0,
"name": "ds.aggregate_function.3",
"value": 3
},
{
"type": 1,
"name": "ds.aggregate_interval.3",
"value": "1m"
},
{
"type": 0,
"name": "ds.aggregate_grouping.3",
"value": 1
},
{
"type": 0,
"name": "graph_time",
"value": 1
},
{
"type": 1,
"name": "time_from",
"value": "now-3h"
},
{
"type": 0,
"name": "legend_lines",
"value": 2
},
{
"type": 0,
"name": "show_problems",
"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
}