O registo de atividade responde a uma pergunta por dispositivo: por que razão está neste estado? Cada comando enviado a um dispositivo e cada alteração de estado reportada são registados com a respetiva origem — o utilizador que clicou na aplicação (e que cliente utilizou), o cenário, a automação, a função Lógica, o horário semanal, o grupo de dispositivos, a gateway KNX, um webhook ou o próprio dispositivo ao reportar uma alteração. Utilize-o para saber quem desligou uma luz, se um cenário alcançou realmente todos os seus dispositivos ou se um comando chegou a ser confirmado pelo dispositivo.
📘 Disponibilidade: O registo de atividade é uma funcionalidade do painel de administração. Grava todos os dispositivos; as aplicações não o apresentam.
O que necessita: o serviço Registo de Atividade dos Dispositivos ativo (está ativo por predefinição — consulte "Configurações e retenção" abaixo).
Abrir o registo
- Aceda a Dispositivos e localize o dispositivo.
- Clique no botão Atividade (ícone de relógio) na linha do dispositivo, à esquerda de Editar dispositivo.
A janela modal intitula-se Atividade, apresentando o nome do dispositivo, a respetiva divisão e o protocolo logo abaixo. À direita, três indicadores mostram o resumo das últimas 24 horas: comandos, alterações e utilizadores.
Filtros
| Controlo | Ação |
|---|---|
| Tudo / Comandos / Alterações de estado | Apresenta tudo, apenas o que foi enviado para o dispositivo ou apenas o que o dispositivo reportou. |
| 24 h / 7 d / 30 d / Tudo | O intervalo de tempo. A predefinição é 7 dias. |
| Todos os objetos | Num dispositivo com vários objetos (um termóstato tem setpoint, modo, temperatura…), filtra a lista para um único objeto. |
| Filtros de origem (Utilizador, Cenário, Automação, Lógica, Horário, Grupo, Gateway KNX, Comando global, Webhook, Boost, Dispositivo, Assumido) | Clique num ou mais para manter apenas essas origens. Clique novamente para desselecionar. |
Ler uma linha
Cada linha apresenta a hora, uma etiqueta COMANDOS ou ALTERAÇÕES DE ESTADO, o objeto (quando o dispositivo tem vários), a alteração do valor no formato anterior → novo nas unidades e descrições do próprio dispositivo, e uma linha que indica a respetiva origem:
| Linha de origem | Significado |
|---|---|
| Utilizador nome via app / via webapp / via admin | Enviado por uma pessoa a partir desse cliente. Um nome sem cliente indica uma versão anterior da aplicação que se identificava apenas pelo nome. |
| Cenário "Noite" ← Utilizador nome via app | O comando foi gerado pelo cenário, e a seta indica o que iniciou o cenário. A sequência pode ser mais longa: um grupo comandado por uma automação iniciada por um telegrama KNX. |
| Automação "…", Lógica "…", Horário "…", Grupo "…" | A automação, função Lógica, programa semanal ou grupo de dispositivos responsável pela escrita. O nome corresponde ao que tinha no momento da execução. |
| Gateway KNX endereço de grupo (emissor) | Um telegrama KNX alcançou este dispositivo não-KNX através da gateway KNX (consulte "Gateway KNX e Triggers"); o emissor é o endereço físico no barramento. |
| Comando global | Um comando de divisão, categoria ou edifício do tipo "ligar tudo / desligar tudo". |
| Dispositivo · protocolo origem | O próprio dispositivo reportou a alteração — um telegrama KNX com o endereço do emissor, uma entidade Home Assistant, um registo polled. |
| Assumido | O HyperVisu assumiu este estado após um comando porque nada o reporta (um dispositivo virtual, um registo só de escrita). |
Um comando só apresenta uma segunda linha quando ocorre uma anomalia — um comando normal e confirmado não apresenta informação adicional:
- Sem confirmação em 5 s — o dispositivo não reportou o valor de retorno; verifique a associação ou o dispositivo.
- Falha acompanhada do texto de erro — não foi possível enviar o comando (por exemplo, a interface KNX não estava ligada).
A indicação se um valor foi medido ou assumido surge nas próprias linhas de estado: uma linha Assumido é uma estimativa do próprio HyperVisu após um comando; uma linha Dispositivo é o valor reportado pelo dispositivo.
Um indicador ×n combinados numa linha de estado significa que n leituras numéricas (temperatura, potência) dentro da janela de agregação foram agrupadas numa única linha; a linha apresenta o valor mais recente e a hora da última leitura (consulte "Configurações e retenção" abaixo para o ajuste da janela).
O que aconteceu
Clique numa linha para a expandir. A secção O que aconteceu lista todas as outras alterações da mesma execução — os outros dispositivos abrangidos por um cenário ou automação, o estado assumido subsequente a um comando — cada um com a respetiva hora, dispositivo e valor. A secção Detalhes apresenta os dados técnicos da linha: as etiquetas de origem e iniciador, o protocolo e o emissor KNX ou entidade Home Assistant — incluindo uma nota caso o cenário ou automação de origem tenha sido entretanto eliminado.
Manutenção e organização
- O rodapé indica a atualização da vista: as linhas chegam ao registo alguns segundos após ocorrerem (o servidor grava em lotes, a cada 20 segundos por predefinição), e a janela modal atualiza-se a cada 10 segundos enquanto estiver aberta.
- Configurações abre a página Registo de Atividade dos Dispositivos (abaixo).
- Limpar atividade deste dispositivo elimina apenas as linhas deste dispositivo. O botão requer um segundo clique para confirmar a eliminação.
📘 Nota: Nem todos os eventos geram uma linha. Um reporte que não altere o valor é ignorado. Os objetos que já gravam as suas leituras na base de dados de histórico (o seletor registo, consulte "Configurações de Objetos, Registo e Notificações") registam apenas comandos, não alterações de estado — a base de dados de histórico já contém as leituras, e o separador Histórico abaixo apresenta-as em gráfico. Um objeto de feedback que apenas transmite um valor ao respetivo objeto principal não é listado; a linha visível é a do objeto principal.
💡 Dica: Utilize o filtro Utilizador com o intervalo de 30 d no dispositivo de alarme para verificar quem armou e desarmou o sistema e em que momento.
O separador Histórico
A janela modal tem dois separadores. Atividade é a cronologia descrita acima. Histórico apresenta os gráficos dos valores gravados dos objetos do dispositivo a partir da base de dados de histórico — a contrapartida para dispositivos que apenas reportam: um contador, um sensor, uma sonda de temperatura. O separador indica quantos objetos do dispositivo estão a ser registados; quando nenhum estiver, informa e direciona para o seletor de registo (consulte "Configurações de Objetos, Registo e Notificações").
- Selecione o objeto no menu suspenso (apenas são listados os objetos registados, com a respetiva unidade).
- Selecione o intervalo: 24 h, 7 d ou 30 d. Cada intervalo tem a sua própria janela de cálculo de média — 5 minutos, 30 minutos e 2 horas — para que um gráfico de 30 dias mantenha poucas centenas de pontos, independentemente da frequência de amostragem. Não existe deliberadamente um intervalo "tudo": consultas ilimitadas causavam tempos limite no gráfico anual de energia da aplicação.
- Para valores numéricos, escolha Valores (a média por janela — uma tendência) ou Variação por intervalo (a diferença entre a última leitura de janelas consecutivas — o consumo por intervalo num contador de energia). Um objeto booleano apresenta ON e OFF sob a forma de gráfico de degrau e a percentagem de tempo em ON nos valores numéricos.
Abaixo do gráfico, os campos Mín, Média, Máx e Último são calculados com base nas janelas apresentadas, na unidade e casas decimais do objeto, com o número de pontos e o tamanho da janela à direita. O gráfico atualiza-se a cada minuto enquanto o separador estiver aberto.
📘 Nota: Um dispositivo cujos objetos estejam todos em registo de histórico não apresenta alterações de estado no separador Atividade. O estado vazio indica essa situação e disponibiliza o separador Histórico diretamente.
Configurações e retenção
A página Registo de Atividade dos Dispositivos (Serviços → Registo de Atividade dos Dispositivos → Configurar) define o que o registo de atividade grava e que volume de dados o servidor mantém. O registo reside na própria base de dados do servidor, pelo que a sua dimensão é deliberadamente limitada: as configurações representam limites de capacidade, não apenas preferências.
O indicador de estado no cabeçalho apresenta A gravar ou Desativado. A linha Registo de Atividade dos Dispositivos na página Serviços (consulte "Serviços e Protocolos") dispõe do mesmo interruptor de ligar/desligar.
Gravação
| Definição | Ação |
|---|---|
| Ativar o registo de atividade | Grava todos os comandos enviados para um dispositivo e todas as alterações de estado reportadas, com a respetiva origem. Desligado: nada é gravado (as linhas existentes mantêm-se). |
| Gravar alterações de estado | Desligado: apenas os comandos são mantidos. Objetos cujas leituras já sejam enviadas para a base de dados de histórico nunca gravam alterações de estado, independentemente desta opção. |
| Combinar leituras analógicas em n s | Leituras consecutivas de um número (temperatura, potência) dentro desta janela são agrupadas numa única linha com a etiqueta ×n combinados. 0 mantém cada leitura como uma linha individual. Predefinição: 300. |
Escrita em disco
As linhas aguardam em memória e são gravadas num único lote assim que qualquer um dos limites for atingido. A predefinição é a cada 20 s ou 200 linhas, o que ocorrer primeiro.
📘 Nota: Um corte de energia perde no máximo um intervalo de histórico. Um reinício ou reinicialização a partir do painel de administração grava primeiro as linhas pendentes e não perde dados. Mantenha o intervalo em 20 s ou superior: o suporte de armazenamento do servidor é o recurso crítico e cada lote corresponde a uma escrita.
Retenção
Os comandos e as alterações de estado têm limites independentes, garantindo que um sensor com envio frequente de dados nunca elimine o registo de quem armou o alarme.
| Definição | Predefinição |
|---|---|
| Manter comandos durante | 90 dias |
| Comandos, no máximo | 20 000 linhas |
| Manter alterações de estado durante | 30 dias |
| Alterações de estado, no máximo | 50 000 linhas |
| Por dispositivo, no máximo | 2 000 linhas de estado |
| Pausar gravação de estados abaixo de | 250 MB livres |
O servidor aplica estes limites a cada dez minutos e no arranque: linhas mais antigas do que o período de retenção, linhas que excedam o limite máximo (as mais antigas primeiro), linhas de estado que excedam o limite por dispositivo e linhas de dispositivos que já não existam. Quando o armazenamento livre desce abaixo do último patamar, a gravação de estados é pausada (os comandos continuam a ser gravados) e é retomada assim que existirem mais 100 MB livres.
Clique em Guardar configurações para aplicar. O servidor assume os novos valores de imediato.
Armazenamento
O cartão do lado direito apresenta o conteúdo atual do registo: o número de Comandos e Alterações de estado com a respetiva entrada mais antiga e a percentagem de ocupação de cada limite, o número de Dispositivos com registos, o Tamanho estimado e o armazenamento livre, as linhas ainda Em fila na memória, as linhas Descartadas (apenas quando a fila de memória satura) e a hora da Última escrita e Última limpeza. Executar limpeza de retenção agora aplica os limites sem aguardar pelo ciclo de dez minutos e reporta quantas linhas foram removidas.
Eliminar o registo
Eliminar toda a atividade na Zona de perigo limpa o registo de todos os dispositivos após confirmação. Para eliminar apenas as linhas de um dispositivo, utilize Limpar atividade deste dispositivo na janela modal Atividade desse mesmo dispositivo.
📘 Nota: O registo faz parte da base de dados do servidor, pelo que é incluído em todas as cópias de segurança (consulte "Cópia de Segurança e Restauro") — até cerca de 15 MB com os limites predefinidos — e apagado numa reposição de fábrica (consulte "Reposição de Fábrica").