Saltar para o conteúdo
Elausys

HyperVisu / Serviços e Dados

Histórico e registo de dados

Definições do InfluxDB, escolha do que é registado e exportação do histórico em CSV.

elausys · 08 agosto 2026
Nesta página

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.

CampoO que introduzir
URLO endereço da instância InfluxDB (p. ex. http://localhost:8086).
API TokenUm token com permissões de leitura e escrita. Utilize o botão do olho para o mostrar ou ocultar.
OrganizationO nome da organização na sua instância InfluxDB.
BucketO 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.

Navegador de ambiente de trabalho, página InfluxDB Configuration com o formulário de ligação preenchido e o cartão Database Status a mostrar Connected.

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:

  1. Abra Devices, expanda o dispositivo e clique no botão Edit Object (a roda dentada) do objeto.
  2. Ative Log historical values.
  3. 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.

  1. 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»).
  2. Em Time Period, defina Start e End, ou utilize um atalho: Last 24h, Last 7 days, Last 30 days, Last year.
  3. Em Format, escolha o Separator: Comma, Semicolon ou Tab.
  4. 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.
  5. Clique em Export CSV. O botão indica Generating... enquanto o servidor prepara o ficheiro.
  6. 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.

Navegador de ambiente de trabalho, página CSV Export.

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».

Perguntas frequentes

O HyperVisu regista todos os objetos automaticamente?

Não. 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, e é você que o ativa para qualquer outro objeto. O serviço InfluxDB também tem de estar ativado.

Porque está vazia a lista de objetos da exportação CSV?

Ainda não há objetos com o registo ativado. Ative o registo nos objetos que pretende gravar e exportar.

Posso escolher o separador CSV e o fuso horário?

Sim. O CSV Data Export oferece separadores vírgula, ponto e vírgula ou tabulação e uma seleção de fuso horário para as marcas temporais.

Durante quanto tempo está disponível uma transferência gerada?

A ligação de transferência dura uma hora. Depois, gere uma nova exportação.

Em que difere o registo de atividade do dispositivo do histórico?

O histórico armazena medições para gráficos e exportações. O registo de atividade grava comandos e alterações de estado, as suas origens e as confirmações dos dispositivos.

Continuar a explorar

Encontre os outros guias deste produto na documentação.

Voltar a Serviços e Dados