> 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/real-time-data.md).
# Dados em Tempo Real
Como o Kilo IoT entrega dados de sensores em tempo real para os painéis e a Visão Geral — e o que verificar quando as atualizações param.
O Kilo IoT Server entrega dados dos dispositivos aos seus painéis e à página de visão geral em tempo real. Quando um sensor reporta uma nova leitura, essa leitura aparece no ecrã sem exigir uma atualização da página ou uma ação manual. Esta página explica as duas superfícies de Dados em tempo real, como funciona a entrega em tempo real e o que verificar quando os dados não aparecem como esperado.
## Duas superfícies de Dados em tempo real
A plataforma mostra o estado em tempo real em dois locais, cada um com um comportamento diferente:
### Página de visão geral: botão de Dados em tempo real
No [página de vista geral](/kilo-docs-pt/kilo-iot-server/overview.md), o cabeçalho mostra um **"Dados em tempo real"** etiqueta com um botão de ícone clicável. Ao passar o cursor sobre o botão, é apresentada a dica de ferramenta **"Novos dados são apresentados automaticamente"**.
**Este é um botão interativo.** Ao clicar, é acionada uma atualização manual dos dados — a visão geral consulta as informações mais recentes do dispositivo e do gateway e atualiza os cartões de resumo. Isto é útil quando acabou de registar um novo dispositivo ou fez uma alteração de configuração e quer ver o resultado imediatamente, em vez de esperar pelo ciclo automático de atualização.
### Cabeçalho do painel: indicador de Dados em tempo real
Em qualquer [painel](/kilo-docs-pt/kilo-iot-server/dashboards.md), o cabeçalho mostra um **"Dados em tempo real"** etiqueta com um pequeno ícone. Ao contrário do botão da visão geral, **este é um indicador de estado, não um botão** — não tem ação de clique, dica de ferramenta nem efeito ao passar o cursor.
O indicador confirma que o painel está a receber atualizações de dados em tempo real. Os valores dos widgets são atualizados automaticamente à medida que novas leituras chegam dos dispositivos. O indicador desaparece quando entra no modo de edição (sendo substituído pelo ícone de edição dos metadados do painel).
## Como funciona a entrega em tempo real
O servidor usa uma ligação persistente entre o seu navegador e a plataforma para enviar atualizações de dados à medida que acontecem:
1. **O dispositivo envia dados** — Um sensor transmite uma nova leitura através do seu conetor (LoRaWAN, rastreador ou outro protocolo).
2. **O servidor processa a leitura** — Os dados passam por normalização e são armazenados para consultas históricas.
3. **Enviar para o navegador** — Simultaneamente, a leitura é enviada para qualquer sessão ativa do navegador que esteja a visualizar um painel ou widget relevante.
4. **Atualizações dos widgets** — Os widgets do painel que exibem a métrica afetada atualizam o valor apresentado sem recarregar a página.
Esta arquitetura significa que um sensor de temperatura que reporte de 60 em 60 segundos atualizará o widget do seu painel de 60 em 60 segundos — a latência é determinada pelo intervalo de reporte do dispositivo, não pelo mecanismo de entrega da plataforma.
Para integradores que constroem sistemas externos que consomem dados em tempo real, a plataforma suporta **SSE (Eventos Enviados pelo Servidor)** e **WebSocket** protocolos. Os widgets do painel utilizam internamente estes mesmos mecanismos. Se estiver a desenvolver integrações personalizadas que necessitem de fluxos de dados em tempo real, estes protocolos fornecem a base.
## O estado "A aguardar dados em tempo real"
Quando um painel ou widget está ligado ao fluxo em tempo real, mas ainda não chegaram dados, a interface pode apresentar **"A aguardar dados em tempo real"**. Este é um estado normal que ocorre quando:
* Um dispositivo foi registado, mas ainda não enviou a sua primeira leitura.
* O intervalo de reporte do dispositivo ainda não decorreu desde que o painel foi aberto.
* O dispositivo está offline ou o seu conetor não está ativo.
## Resolução de problemas de atrasos nos dados
Se os dados não estiverem a aparecer em tempo real:
1. **Verifique o estado do dispositivo** — Abra a página de detalhes do dispositivo e confirme que está online e a enviar dados. Verifique a marca temporal de última atividade.
2. **Verifique o conetor** — Certifique-se de que o conetor associado ao dispositivo está ativo e ligado.
3. **Verifique o gateway** *(dispositivos LoRaWAN)* — Se o dispositivo usar um gateway LoRaWAN, verifique se o gateway está online e dentro do alcance.
4. **Atualize o navegador** — Em casos raros, a ligação persistente entre o navegador e o servidor pode precisar de ser restabelecida. Uma atualização da página resolve isto.
5. **Clique no botão Dados em tempo real** *(apenas na visão geral)* — Na página de visão geral, clicar no botão Dados em tempo real força uma atualização manual dos dados.
## Páginas relacionadas
* [Página de visão geral](/kilo-docs-pt/kilo-iot-server/overview.md) — É onde se encontra o botão clicável Dados em tempo real.
* [Adicionar widgets](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets.md) — Configure widgets que apresentem dados em tempo real.
* [Criar dashboards](/kilo-docs-pt/kilo-iot-server/dashboards/creating-dashboards.md) — Crie os painéis que recebem atualizações em tempo real.
---
# 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/real-time-data.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.
