[comment]: # ({364afe17-6fe0d1f1})
# 6 Gauge
[comment]: # ({/364afe17-6fe0d1f1})
[comment]: # ({4c03826a-822e017f})
#### Visão geral
O widget *Gauge* exibe o valor de um único item numérico como um medidor.
Ele é útil para acompanhar métricas importantes, visualizar limites e detectar mudanças repentinas.
{width="600"}
Você pode configurar o widget para exibir o seguinte:
- Descrição do item (Espaço usado: {ITEM.LASTVALUE}, Temperatura)
- Valor e unidades do item (21 %, 18.7 °C, 1.2 bar)
- Escala do medidor (1GB/24GB/28GB/32GB, -50/-40/-30/etc.)
- Arco do medidor (arco do valor do medidor e arco dos limites do medidor)
- Ponteiro do medidor
Ao clicar no widget, é aberto um [gráfico simples](/manual/config/visualization/graphs/simple) para o item.
As informações exibidas no widget *Gauge* podem ser baixadas como uma imagem PNG ao selecionar a opção *Download image* no [menu do widget](/manual/web_interface/frontend_sections/dashboards#widget-menu).
[comment]: # ({/4c03826a-822e017f})
[comment]: # ({30857b45-3aa15745})
#### Configuração
Para configurar, selecione *Gauge* como tipo:
{width="600"}
Além dos parâmetros que são [comuns](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) para todos os widgets, você pode definir as seguintes opções específicas:
| | |
|--|--------|
|*Item*|Selecione o item.
Como alternativa, selecione um widget compatível como [fonte de dados](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) para itens.
Este campo tem preenchimento automático, portanto, ao começar a digitar o nome de um item, será exibida uma lista suspensa com os itens correspondentes.
Observe que você pode selecionar apenas itens que retornam dados [numéricos](/manual/config/items/item#configuration) (exceto dados binários).|
|*Min*|Insira o valor mínimo do medidor.
[Sufixos](/manual/appendix/suffixes) (por exemplo, "1d", "2w", "4K", "8G") são suportados. [Mapeamentos de valor](/manual/config/items/mapping) são suportados.|
|*Max*|Insira o valor máximo do medidor.
[Sufixos](/manual/appendix/suffixes) (por exemplo, "1d", "2w", "4K", "8G") são suportados. [Mapeamentos de valor](/manual/config/items/mapping) são suportados.|
|*Colors*|Selecione a cor no seletor de cores:
**Arco do valor** - selecione a cor do arco do valor do medidor;
**Fundo do arco** - selecione a cor de fundo do arco do valor do medidor e do arco dos limites do medidor;
**Fundo** - selecione a cor de fundo do widget.
"D" representa a cor padrão, que depende do tema do frontend. Se [*Thresholds*](#advanced-configuration) estiver configurado, a cor padrão de **Arco do valor** dependerá da cor do limite. Para retornar à cor padrão, clique no botão *Use default* no seletor de cores.|
|*Show*|Marque a caixa de seleção para exibir o respectivo elemento do medidor: descrição, valor, arco do valor, ponteiro, escala (o valor mínimo e máximo do medidor no início e no fim do arco do medidor). Desmarque para ocultar. Pelo menos um elemento deve ser selecionado.
Observe que o ponteiro e a escala do medidor podem ser exibidos se o arco do valor do medidor ou o arco dos limites do medidor (consulte as opções de [configuração avançada](#advanced-configuration)) estiverem exibidos. Observe também que, se o ponteiro do medidor estiver exibido, o valor será posicionado abaixo do ponteiro; se o ponteiro estiver oculto, o valor será alinhado com a parte inferior do arco do medidor.|
|*Override host*|Selecione um widget compatível ou o [seletor de host](/manual/web_interface/time_period_selector#host-selector) do dashboard como [fonte de dados](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) para hosts.
Este parâmetro não está disponível ao configurar o widget em um [dashboard de template](/manual/config/templates/template#adding-dashboards).|
|*Advanced configuration*|Clique no cabeçalho *Advanced configuration* para exibir as opções de [configuração avançada](#advanced-configuration). É também aqui que você poderá ajustar os elementos do medidor selecionados no campo *Show*.|
[comment]: # ({/30857b45-3aa15745})
[comment]: # ({0ace07fa-139a1aaa})
##### Configuração avançada
As opções de configuração avançada estão disponíveis na seção recolhível *Configuração avançada*:
{width="600"}
| | |
|--|--------|
|*Ângulo*|Selecione o ângulo do gauge (180° ou 270°).|
|***Descrição***|<|
|*Descrição*|Insira a descrição do item. Esta descrição pode substituir o nome padrão do item.
Descrições multilinha são suportadas. É possível uma combinação de texto e macros suportadas.
{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} e macros de usuário são suportadas.|
|*Tamanho*|Insira a altura do tamanho da fonte para a descrição do item (em porcentagem, relativa à altura total do widget).|
|*Posição vertical*|Selecione a posição vertical da descrição do item (superior ou inferior, em relação ao arco do gauge).|
|*Negrito*|Marque a caixa de seleção para exibir a descrição do item em negrito.|
|*Cor*|Selecione a cor da descrição do item no seletor de cores.
"D" significa a cor padrão, que depende do tema do frontend. Para retornar à cor padrão, clique no botão *Usar padrão* no seletor de cores.|
|***Valor***|<|
|*Casas decimais*|Insira o número de casas decimais a serem exibidas com o valor.
Esta opção afeta apenas itens que retornam dados [numéricos (float)](/manual/config/items/item#configuration).|
|*Tamanho*|Insira a altura do tamanho da fonte para o valor (em porcentagem, relativa à altura do arco do gauge).|
|*Negrito*|Marque a caixa de seleção para exibir o valor em negrito.|
|*Cor*|Selecione a cor do valor no seletor de cores.
"D" significa a cor padrão, que depende do tema do frontend. Para retornar à cor padrão, clique no botão *Usar padrão* no seletor de cores.|
|***Unidades***|<|
|*Unidades*|Marque a caixa de seleção para exibir as unidades com o valor do item.
Se você inserir um nome de unidade, ele substituirá as unidades definidas na [configuração do item](/manual/config/items/item#configuration).|
|*Tamanho*|Insira a altura do tamanho da fonte para as unidades do item (em porcentagem, relativa à altura do arco do gauge).|
|*Negrito*|Marque a caixa de seleção para exibir as unidades do item em negrito.|
|*Posição*|Selecione a posição das unidades do item (acima, abaixo, antes ou depois, em relação ao valor do item).
Esta opção é ignorada para as seguintes [unidades relacionadas ao tempo](/manual/config/items/item#configuration): unixtime, uptime, s.|
|*Cor*|Selecione a cor das unidades do item no seletor de cores.
"D" significa a cor padrão, que depende do tema do frontend. Para retornar à cor padrão, clique no botão *Usar padrão* no seletor de cores.|
|***Arco de valor***|<|
|*Tamanho do arco*|Insira a altura do tamanho do arco de valor do gauge (em porcentagem, relativa ao raio do arco do gauge).|
|***Agulha***|<|
|*Cor*|Selecione a cor da agulha do gauge no seletor de cores.
"D" significa a cor padrão, que depende do tema do frontend. Se *Limiares* estiverem definidos, a cor padrão da agulha depende da cor do limiar. Para retornar à cor padrão, clique no botão *Usar padrão* no seletor de cores.|
|***Escala***|<|
|*Exibir unidades*|Marque a caixa de seleção para exibir as unidades com o valor mínimo e máximo do gauge.|
|*Tamanho*|Insira a altura do tamanho da fonte para o valor mínimo e máximo do gauge (em porcentagem, relativa à altura do arco do gauge).|
|*Casas decimais*|Insira o número de casas decimais a serem exibidas com o valor mínimo e máximo do gauge.
Esta opção afeta apenas itens que retornam dados [numéricos (float)](/manual/config/items/item#configuration).|
|***Limiares***|<|
|*Limiares*|Clique em *Adicionar* para adicionar um limiar, selecione uma cor de limiar no seletor de cores e especifique um valor numérico.
A lista de limiares será classificada em ordem crescente ao salvar.
Observe que as cores configuradas como limiares serão exibidas corretamente apenas para itens numéricos.
[Sufixos](/manual/appendix/suffixes) (por exemplo, "1d", "2w", "4K", "8G") são suportados. [Mapeamentos de valor](/manual/config/items/mapping) são suportados.|
|*Exibir rótulos*|Marque a caixa de seleção para exibir os valores dos limiares como rótulos na escala do gauge.|
|*Exibir arco*|Marque a caixa de seleção para exibir o arco de limiares do gauge.|
|*Tamanho do arco*|Insira a altura do tamanho do arco de limiares do gauge (em porcentagem, relativa ao raio do arco do gauge).|
[comment]: # ({/0ace07fa-139a1aaa})