[comment]: # ({167707a1-efa63679})
# 8 Gráfico
[comment]: # ({/167707a1-efa63679})
[comment]: # ({c2d12536-4bb44173})
### 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*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph) nos métodos `dashboard.create` e `dashboard.update` .
::: noteimportant
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](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) e criar [custom widgets](/manual/modules#developing-modules), 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.
:::
[comment]: # ({/c2d12536-4bb44173})
[comment]: # ({86c426f8-153fd258})
### Parâmetros
The following parameters are supported for the *Graph* widget.
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|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.|
[comment]: # ({/86c426f8-153fd258})
[comment]: # ({84088409-7bb6f7c8})
#### Conjunto de dados
Os seguintes parâmetros são suportados para configurar um *Conjunto de dados*.
::: noteclassic
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](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|***Padrão de host***
(obrigatório)|1|ds.hosts.0.0|Nome ou padrão de [Host](/manual/api/reference/host/get) (por exemplo `Zabbix*`).|
|***Padrão e item***
(obrigatório)|1|ds.items.0.0|Nome ou padão de [Item](/manual/api/reference/item/get) (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](/manual/appendix/suffixes#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](/manual/appendix/suffixes#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".|
[comment]: # ({/84088409-7bb6f7c8})
[comment]: # ({54acedd8-065c780b})
#### Opções de exibição
Os seguintes parâmetros são suportados para configurar *Opções de exibição*.
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|*Seleção de dados de histórico*|0|source|0 - *(padrão)* Automático;
1 - Histórico;
2 - Trends.|
[comment]: # ({/54acedd8-065c780b})
[comment]: # ({36354072-3919b8dd})
#### Período de tempo
Os seguintes parâmetros são suportados para configurar *Período de tempo*.
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|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](/manual/config/visualization/graphs/simple#time-period-selector) 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](/manual/config/visualization/graphs/simple#time-period-selector) Valores de (`now`, `now/d`, `now/w-1w`, etc.)também são suportados.
Padrão: `now`.|
[comment]: # ({/36354072-3919b8dd})
[comment]: # ({a0674fde-5b9b0680})
#### Axes (Eixos)
Os seguintes parâmetros são suportados para configurar *Axes (eixos)*.
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|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.|.
[comment]: # ({/a0674fde-5b9b0680})
[comment]: # ({07ca4559-12287620})
#### Legenda
Os seguintes parâmetros são suportados para configurar a *Legenda*.
|Parâmetro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|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.|
[comment]: # ({/07ca4559-12287620})
[comment]: # ({64d6609b-e89fa375})
#### Problemas
The following parameters are supported for configuring *Problems*.
|Parâmetro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|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](/manual/api/reference/host/get).
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](/manual/config/triggers/trigger#configuration) (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*.|
[comment]: # ({/64d6609b-e89fa375})
[comment]: # ({7f3903f6-f2e36a05})
#### Substituições
Os seguintes parâmetros são suportados para configurar *Substituições*.
::: noteclassic
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](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|***Host pattern***
(obrigatório)|1|or.hosts.0.0|Nome ou padrão do [Host](/manual/api/reference/host/get) (por exemplo, `Zabbix*`).|
|***Item pattern***
(obrigatório)|1|or.items.0.0|Nome ou padrão do [Item](/manual/api/reference/item/get) (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](/manual/appendix/suffixes#time-suffixes). Valores negativos são permitidos.|
[comment]: # ({/7f3903f6-f2e36a05})
[comment]: # ({0d773487-0a1ab554})
### 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`](/manual/api/reference/dashboard/create).
[comment]: # ({/0d773487-0a1ab554})
[comment]: # ({f11b369f-6c20191c})
#### 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:
```json
{
"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:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/f11b369f-6c20191c})
[comment]: # ({e9d30322-1a6bfc6f})
### Consulte também
- [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-1a6bfc6f})