O HyperVisu armazena o histórico de séries temporais na base de dados de histórico integrada no equipamento (InfluxDB). Este capítulo explica como a ligar, exportar dados de medição em CSV, criar painéis do Grafana e mover tabelas de configuração completas para dentro e para fora do servidor como ficheiros CSV.
Ligação ao InfluxDB
O histórico necessita do serviço InfluxDB. Abra Services e verifique se a linha InfluxDB está ativada. Se a ativar agora, surge uma faixa Pending Changes: clique em Restart Server e aguarde que o servidor volte a ficar disponível.
A página InfluxDB Configuration (Services → InfluxDB → Configure) contém uma ligação a uma base de dados de histórico à sua escolha. Numa instalação padrão, os campos podem estar vazios: o servidor escreve e lê então o histórico através da sua ligação integrada e não há nada a preencher.
| Campo | O que introduzir |
|---|---|
| URL | O endereço da instância InfluxDB (p. ex. http://localhost:8086). |
| API Token | Um token com permissões de leitura e escrita. Utilize o botão do olho para o mostrar ou ocultar. |
| Organization | O nome da organização na sua instância InfluxDB. |
| Bucket | O bucket onde os dados são armazenados. |
Clique em Test Connection para verificar a ligação apresentada no formulário e, em seguida, em Save para a guardar. O cartão Database Status passa de Not Tested para Connected e mostra a hora de Last tested. Test Connection precisa dos quatro campos: quando a página está vazia, não há nada a testar aqui e o resultado verifica-se numa página de tendências da aplicação. Por segurança, um token guardado nunca volta a ser apresentado; deixe o campo vazio para o manter. Se o próprio serviço InfluxDB estiver desativado, um alerta na página indica que deve ativá-lo primeiro a partir da página Services.
Depois de guardada uma ligação, a página mostra também o armazenamento utilizado e uma definição Data retention. Reduzir o período de retenção elimina permanentemente os dados mais antigos.

O que é registado. O registo é um interruptor em cada objeto de comunicação. Os objetos de um contador e de uma entrada analógica com tendência são registados automaticamente; para qualquer outro objeto, é você que o ativa:
- Abra Devices, expanda o dispositivo e clique no botão Edit Object (a roda dentada) do objeto.
- Ative Log historical values.
- Clique em Save object. A linha do objeto mostra agora um ícone de base de dados e um ícone de gráfico. Não é necessário Apply changes.
Cada valor que o objeto recebe é registado a partir desse momento, tenha ou não mudado; nada anterior é reconstruído (ver «Object Settings, Logging & Notifications»). Os objetos registados alimentam os gráficos de tendência e o histórico dos contadores na aplicação, os painéis do Grafana, os gráficos do monitor de bus KNX e a exportação CSV descrita abaixo.
Exportação de dados CSV
A página CSV Data Export transforma o histórico registado num ficheiro adequado para folhas de cálculo. Não tem entrada própria na barra lateral: abra Services e clique em Export na linha InfluxDB.
- Em Object Selection, assinale os objetos a exportar. Estão agrupados por divisão; utilize a caixa de pesquisa ou Select all. Se a lista estiver vazia, ainda não há objetos com o registo ativado — ative-o primeiro (ver «Object Settings, Logging & Notifications»).
- Em Time Period, defina Start e End, ou utilize um atalho: Last 24h, Last 7 days, Last 30 days, Last year.
- Em Format, escolha o Separator: Comma, Semicolon ou Tab.
- Escolha a Timezone em que as marcas temporais são escritas. O campo abre em
Europe/Paris, seja qual for o fuso horário do próprio servidor, por isso verifique-o. - Clique em Export CSV. O botão indica Generating... enquanto o servidor prepara o ficheiro.
- Quando aparecer File ready, clique em Download file.
📘 Nota: A ligação de transferência é válida durante 1 hora; depois, inicie uma nova exportação. O ficheiro está em UTF-8 com BOM, pelo que abre corretamente no Excel.

Registo de atividade do dispositivo
À parte da base de dados de histórico, o servidor mantém também um activity log por dispositivo: cada comando enviado a um dispositivo e cada alteração de estado que este comunica, com a sua origem — o residente e o cliente que utilizou, o cenário, a automatização, a função Logic, o agendamento, o grupo, a ponte KNX ou o webhook que a causou — e se o dispositivo confirmou o comando. Abre-se a partir do botão Activity em cada linha de dispositivo, e as suas definições de gravação e retenção encontram-se na página Services → Device Activity Log. Ambos são descritos em «Device Activity Log».