> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/gauge.md).
# Exibição de Medidor
Acompanhe uma leitura em relação a limiares com o Medidor — bandas coloridas mostram zonas segura, de aviso e de violação.
A visualização Gauge desenha cada leitura como um marcador a deslizar ao longo de uma faixa horizontal. A faixa é escalada entre um mínimo e um máximo, e cada condição numérica que definir torna-se numa banda colorida ao longo dela — assim, a posição do marcador mostra o estado operacional, e não apenas um valor. A figura é mostrada completa acima da faixa.
Esta é a visualização para leituras em que a posição face aos limites é o importante: se um valor está dentro da sua banda segura, está a aproximar-se de um limite, ou já o ultrapassou.
## Quando escolher
* Uma leitura que deve permanecer dentro de uma janela operacional — pressão, RPM, uma temperatura controlada — em que as bandas transportam o significado.
* Alerta no extremo inferior — um consumível ou reserva em que o marcador a descer para uma banda vermelha é o aviso.
* Alerta no extremo superior — um nível que deve manter-se baixo, em que o marcador a subir para vermelho sinaliza problemas.
O Gauge não tem uma extremidade fixa "boa"; as bandas de condições é que definem o que cada extremidade da faixa significa. Sempre que uma leitura tenha limites, o Gauge torna visível a ultrapassagem deles — as situações acima são um ponto de partida, não o limite.
## Configurar uma visualização Gauge
Aqui está uma configuração completa para um caso real — monitorizar um poço de bombagem para que uma falha da bomba seja detetada antes de a cave inundar. A bomba mantém a água baixa; o poço tem cerca de 100 cm de profundidade, e um sensor de nível apresenta o nível da água em centímetros — por isso a leitura vai de 0 (o fundo seco do poço) a 100 (a água no ponto de transbordo). Esse 0–100 é a escala da faixa, e cada condição colore um trecho dela. Este é apenas um exemplo: um Gauge adequa-se a qualquer leitura medida face a limites — só mudam o dispositivo e as extremidades das bandas.
1. Abra o painel no modo de edição e clique **Últimos dados** no seletor de widgets. O painel de definições abre no separador **Fonte de dados** sem fontes de dados ainda.
2. Clique **Adicionar fonte de dados**. Uma **Fonte de dados 1** aparece um bloco.
3. No bloco, clique **Escolher dispositivo** e selecione o sensor de nível do poço.
4. Clique **Adicionar métrica**. Surge uma linha de métrica.
5. Na linha, defina **Tipo de dados** para **Telemetria**, escolha a leitura do nível da água em **Métrica do dispositivo**, e escolha um **Ícone**.
> **Esta visualização precisa de um número.** A **Métrica do dispositivo** lista oferece todos os tipos de métrica, mas um gauge preenche-se contra uma escala — escolha aqui uma leitura numérica; um valor de texto não numérico é lido como 0. (Para mostrar texto ou um valor ligado/desligado tal como está, use a [Visualização de valor](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/number.md).) Para alterar a forma como uma métrica é armazenada, abra **Dispositivos → Métricas** — veja [Métricas](/kilo-docs-pt/kilo-iot-server/devices/metric-templates.md).
6. Clique **Condições: N** para abrir a janela modal Condições. Defina uma **Cor predefinida** — a cor para a qual a leitura regressa sempre que nenhuma das suas condições corresponde ao valor atual — depois, para cada banda, clique em **Adicionar condição** e preencha a linha — introduza um **Nome da condição**, defina **Tipo de dados** para **Número** (o próprio Tipo de dados da condição, separado da linha da métrica), porque o poço tem 100 cm de profundidade, introduza **De** 0 (o fundo seco) e **Até** 100 (o ponto de transbordo), e escolha uma **Cor**. Depois pode introduzir os níveis de cor. Por exemplo:
A partir do fundo seco:
* "Normal" — **De** 0, **Até** 30 — verde
* "A subir" — **De** 30, **Até** 60 — amarelo
* "Crítico" — **De** 60, **Até** 100 — vermelho
Num Gauge, estas condições são apresentadas como bandas coloridas ao longo da faixa. Clique **Guardar** para fechar a janela modal.
7. Clique **Seguinte** para abrir o separador **Aparência** .
8. Introduza um **Nome do widget** — por exemplo "Nível do poço de bombagem" — e uma **Descrição**.
9. Em **Tipo de widget**, escolha **Gauge**. Uma **A secção Intervalo de valores** aparece para a métrica.
10. Defina **Valor mínimo** para **0** (um poço seco) e **Valor máximo** para **100** (água no transbordo) — as duas extremidades da faixa, o mesmo 0–100 que as bandas usam — e defina **Marcas de escala** para **10**.
11. Ative **Mostrar legenda dos dados** se for útil, depois clique **Guardar**.
O resultado: uma faixa cujo marcador fica em baixo e verde enquanto a bomba dá conta do recado. Se a bomba falhar, a água sobe e o marcador desloca-se ao longo da faixa e entra na banda vermelha — essa ultrapassagem é o evento que está a monitorizar. Uma nota sobre o sensor: um sensor de nível lê valores mais altos à medida que a água sobe, enquanto um sensor de distância montado no topo lê valores mais baixos — defina a banda vermelha para o valor que signifique água alta no sensor que instalou. O Gauge torna a condição visível no painel; para uma notificação, use um [Alarme](/kilo-docs-pt/kilo-iot-server/alarm.md). A mesma faixa com bandas monitoriza tudo o que é medido face a limites — só a métrica e as extremidades das bandas mudam.
## Exemplos práticos
**Um consumível em baixa** Quando o perigo está na *extremidade inferior* extremidade, pinte as bandas ao contrário. Uma reserva apresentada como percentagem vai de 0 % (vazia) a 100 % (cheia), por isso a faixa toma **Valor mínimo** 0 e **Valor máximo** 100. Um depósito de líquido de refrigeração ou reagente recebe então três condições: "Repor agora" — De 0, Até 15 — vermelho; "A ficar baixo" — De 15, Até 40 — amarelo; "Saudável" — De 40, Até 100 — verde. O marcador fica alto e verde enquanto a reserva está cheia e desce para o vermelho à medida que o processo a vai consumindo.
**Manter-se dentro de uma janela segura** Algumas leituras têm de permanecer *entre* dois limites, e não acima nem abaixo de um. Para um compressor cuja pressão funciona entre 0 e 10 bar, a faixa abrange esse intervalo operacional — defina **Valor mínimo** 0 e **Valor máximo** 10 — depois pinte uma banda verde ao centro com bandas de aviso em ambas as extremidades: "Baixo" — De 0, Até 2 — vermelho; "Aviso de baixo" — De 2, Até 4 — amarelo; "Normal" — De 4, Até 7 — verde; "Aviso de alto" — De 7, Até 9 — amarelo; "Alto" — De 9, Até 10 — vermelho. A posição do marcador mostra num relance se o equipamento está a funcionar onde deve, e o desvio para qualquer uma das extremidades é visível antes de se tornar uma falha.
## Ver também
* [Widget Últimos Dados](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget.md) — referência de configuração completa e os outros tipos de visualização
* [Condições](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/conditions.md) — regras numéricas De/Até que se tornam as bandas da faixa
* Outros tipos de visualização: [Valor](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/number.md) · [Rosca](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/doughnut.md) · [Pizza](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/pie.md) · [Tubo](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/tube.md) · [Medidor radial](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/radial-gauge.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/gauge.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
