MiroxMirox
  • Plataforma

    • Filosofia
    • Visão geral da plataforma
    • Recursos da plataforma
  • Mirox-Cloud

    • Visão geral da cloud
    • Microsserviços ligados
  • Mirox-Agent

    • Visão geral do agente
    • Opções de implementação
    • Data Scraper
    • Gémeo digital
  • Detalhes técnicos

    • Recolha de métricas
  • Informações

    • Centrais suportadas
  • Tipos de central

    • Centrais solares
    • Parques eólicos
    • Armazenamento por baterias
  • Monitorização e visualização

    • Monitorização em tempo real
    • Gémeo digital
    • Estados dos componentes
    • Deteção de perdas
    • Deteção de eficiência
    • Painel de KPI
  • Gestão de dados

    • Eventos
    • Tickets
    • Previsões
    • Relatórios
  • Integração e partilha

    • Cooperações
    • Tokens de API
    • VPN
    • Proxy
  • IA

    • Assistente de IA e assistentes
    • Acesso agêntico (MCP)
  • Faturação

    • Mercado e tarifas
    • Contabilidade e faturação
  • Colaboração

    • Convites
  • Segurança

    • Autenticação
    • Sistema de permissões
    • Restrições de cooperação
    • Registo de auditoria de acesso
  • Nós

    • mrxnode
  • Aplicação

    • Controlo de porta
    • Relé genérico
  • Cluster edge

    • Orquestração
  • Primeiros passos

    • Primeiros passos
  • Pessoal

    • Utilizar a VPN
    • Utilizar o proxy
    • Autenticação de dois fatores
    • Sessões
    • Tokens de API
  • Por central

    • Contactos
    • Dispositivos de rede
    • Registadores de dados
    • Componentes
    • VPN direta (por agente)
  • Organização

    • Permissões de membros
    • Cooperações
    • Armazenamento de ficheiros
  • Exportação de dados

    • API de exportação de métricas
    • MiroxQL — linguagem de consulta
    • Geração externa de relatórios
    • Grafana
    • Visão geral da API
  • Suporte

    • Pedir guia de integração
  • mrxnode

    • Visão geral
    • Guias
    • Implementação em contentor
    • Referência de comandos
    • Resolução de problemas
  • Relatórios

    • Gerador de relatórios externo
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Plataforma

    • Filosofia
    • Visão geral da plataforma
    • Recursos da plataforma
  • Mirox-Cloud

    • Visão geral da cloud
    • Microsserviços ligados
  • Mirox-Agent

    • Visão geral do agente
    • Opções de implementação
    • Data Scraper
    • Gémeo digital
  • Detalhes técnicos

    • Recolha de métricas
  • Informações

    • Centrais suportadas
  • Tipos de central

    • Centrais solares
    • Parques eólicos
    • Armazenamento por baterias
  • Monitorização e visualização

    • Monitorização em tempo real
    • Gémeo digital
    • Estados dos componentes
    • Deteção de perdas
    • Deteção de eficiência
    • Painel de KPI
  • Gestão de dados

    • Eventos
    • Tickets
    • Previsões
    • Relatórios
  • Integração e partilha

    • Cooperações
    • Tokens de API
    • VPN
    • Proxy
  • IA

    • Assistente de IA e assistentes
    • Acesso agêntico (MCP)
  • Faturação

    • Mercado e tarifas
    • Contabilidade e faturação
  • Colaboração

    • Convites
  • Segurança

    • Autenticação
    • Sistema de permissões
    • Restrições de cooperação
    • Registo de auditoria de acesso
  • Nós

    • mrxnode
  • Aplicação

    • Controlo de porta
    • Relé genérico
  • Cluster edge

    • Orquestração
  • Primeiros passos

    • Primeiros passos
  • Pessoal

    • Utilizar a VPN
    • Utilizar o proxy
    • Autenticação de dois fatores
    • Sessões
    • Tokens de API
  • Por central

    • Contactos
    • Dispositivos de rede
    • Registadores de dados
    • Componentes
    • VPN direta (por agente)
  • Organização

    • Permissões de membros
    • Cooperações
    • Armazenamento de ficheiros
  • Exportação de dados

    • API de exportação de métricas
    • MiroxQL — linguagem de consulta
    • Geração externa de relatórios
    • Grafana
    • Visão geral da API
  • Suporte

    • Pedir guia de integração
  • mrxnode

    • Visão geral
    • Guias
    • Implementação em contentor
    • Referência de comandos
    • Resolução de problemas
  • Relatórios

    • Gerador de relatórios externo
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Primeiros passos

    • Primeiros Passos
  • Pessoal

    • Utilizar a VPN
    • Utilizar o Proxy
    • Configurar a Autenticação de Dois Fatores
    • Gerir as Suas Sessões
    • Tokens de API
  • Por central

    • Gerir Contactos da Central
    • Gerir dispositivos de rede
    • Configurar Registadores de Dados
    • Configurar os componentes
    • Configurar servidores VPN por agente (VPN direta)
  • Organização

    • Gerir Permissões de Membros
    • Criar Cooperações
    • Utilizar o Armazenamento de Ficheiros
  • Exportação de dados

    • API de Exportação de Métricas
    • Linguagem de Consulta MiroxQL
    • Geração de Relatórios Externos
    • Utilizar o Grafana como Plataforma Externa de Leitura
    • Visão Geral da API
  • Suporte

    • Solicitar guia de integração
  • mrxnode

    • Visão Geral do mrxnode
    • Guia Como Fazer do mrxnode
    • Implementação de contentores
    • Folha de Consulta de Comandos mrxnode
    • Resolução de problemas

Configurar Registadores de Dados

Os registadores de dados são a ponte entre o equipamento na sua central e a plataforma Mirox: depois de um registador estar configurado, o Mirox-Agent começa a consultar esse dispositivo de forma agendada, normalizando cada leitura num único vocabulário de métricas e transmitindo-a para a plataforma. Este guia orienta-o na adição de um registador, na associação de um dispositivo descoberto a um adaptador, na confirmação de que este responde com uma sondagem ao vivo e na aplicação das suas alterações — além dos limites do que é integrado automaticamente.

Antes de Começar

Um registador é configurado contra um dispositivo de rede que já tenha sido descoberto na rede da central. Se o dispositivo que pretende ainda não estiver lá, execute primeiro uma análise de descoberta — consulte Gerir Dispositivos de Rede. Também precisa de ter a ligação segura à central ativa; o Agent acede aos dispositivos através do túnel VPN.

Onde Vivem os Registadores de Dados

Cada central tem uma página de Fluxo de dados onde gere os seus registadores e acompanha a chegada dos dados.

Abrir no Mirox: Fluxo de dados — ou abra Os seus parques, escolha um parque e mude para o separador Fluxo de dados.

O cabeçalho da página apresenta mosaicos ao vivo para o estado dos registadores (saudáveis vs. total), a disponibilidade do Agent e o tráfego de rede, para que veja num relance se a recolha está a funcionar. O separador Registadores de Dados é onde adiciona e gere os registadores; o botão Aplicar alterações no canto superior direito envia a sua configuração para o Agent.

Como São Integrados os Registadores de Dados

Adicionar um registador é um fluxo guiado construído em torno de uma conversa real com o dispositivo. A plataforma abre uma ligação temporária só de leitura — uma sondagem — para que possa confirmar que o dispositivo responde e ver as suas leituras ao vivo antes de assumir qualquer compromisso. Há duas formas de entrar no fluxo:

  • Registadores Possíveis (detetados automaticamente) — quando o fabricante e o tipo de um dispositivo descoberto correspondem a um adaptador conhecido, este aparece na tabela Registadores Possíveis com o adaptador correspondente pré-preenchido. Este é o caminho rápido.
  • Adicionar Registador (manual) — quando a deteção falha ou classifica incorretamente um dispositivo, o botão Adicionar Registador permite-lhe escolher qualquer dispositivo de rede e um adaptador.

Em qualquer dos casos, executa-se o mesmo assistente e a mesma sondagem ao vivo confirma o dispositivo antes de guardar.

Adicionar um Registador Detetado Automaticamente

  1. Abrir no Mirox: Fluxo de dados (ou escolha o seu parque em Os seus parques e abra o separador Fluxo de dados).
  2. Na tabela Registadores Possíveis, encontre o dispositivo que pretende. Cada linha mostra o nome do dispositivo, o IP, o fabricante/tipo e o adaptador a que a plataforma o associou.
  3. Clique no botão + na linha. O assistente de integração abre com esse dispositivo e adaptador já associados.
  4. Siga os passos do assistente (abaixo) e Guarde o registador.

Adicionar um Registador Manualmente

  1. Na página Fluxo de dados, clique em Adicionar Registador.
  2. No passo Escolher dispositivo, pesquise a lista de dispositivos de rede por nome, IP, fabricante, tipo, modelo ou descrição, e selecione o dispositivo.
  3. Escolha o adaptador a utilizar e, em seguida, clique em Continuar.
  4. Siga os restantes passos do assistente e Guarde o registador.

O Assistente de Integração, Passo a Passo

O assistente é uma única caixa de diálogo com uma barra lateral de passos e uma faixa de registo do agent ao vivo ao longo da parte inferior, para que possa observar o Agent a comunicar com o dispositivo o tempo todo. Um distintivo de ligação junto ao nome do dispositivo indica o estado da sondagem (A ligar, A sondar, Inativo, Erro, Concluído). Os passos que aparecem dependem do adaptador:

PassoQuando apareceO que faz
Escolher dispositivoApenas na adição manualEscolher o dispositivo de rede e o adaptador
IdentidadeDispositivos que precisam de configuraçãoConfirmar que o dispositivo e o adaptador estão corretos
CredenciaisAdaptadores que requerem início de sessãoIntroduzir o nome de utilizador e a palavra-passe do dispositivo
SondagemDispositivos sem configuraçãoObservar as leituras ao vivo que o dispositivo expõe
Mapear valoresRegistadores genéricosPercorrer todos os valores em bruto que o dispositivo expõe e mapear cada um para uma métrica conhecida
Execução de testeRegistadores genéricosRever as métricas exatas que o seu mapeamento produziria
ConfiguraçãoDispositivos que precisam de associação manualEscolher quais as leituras a recolher e o intervalo de consulta
ResumoDispositivos que precisam de configuraçãoRever e guardar

Credenciais e o Cofre

Se o adaptador precisar de iniciar sessão no dispositivo, o passo Credenciais pede um nome de utilizador e uma palavra-passe. As credenciais que já tiver guardado para esse dispositivo no cofre de credenciais são oferecidas aqui para que não as tenha de voltar a escrever, e o que introduzir pode ser reutilizado mais tarde para acesso por proxy.

Janitza Não Precisa de Credenciais

Os contadores Janitza são integrados sem quaisquer credenciais. Os controladores Huawei SmartLogger e Phoenix Contact precisam de início de sessão no dispositivo, pelo que o passo Credenciais aparece para eles, mesmo que de resto sejam sem configuração.

Executar a Sondagem ao Vivo

O passo Sondagem abre uma execução de teste de curta duração contra o dispositivo. O Agent lê o que o dispositivo expõe e transmite amostras ao vivo de volta — atualizam-se a cada segundo, e a faixa de registo inferior mostra a troca subjacente.

  • Aguarde até que apareçam amostras. O distintivo de ligação passa para A sondar e depois estabiliza quando as leituras começam a fluir.
  • Se nada chegar, o assistente tenta novamente de forma automática algumas vezes. Se mesmo assim não conseguir alcançar o dispositivo, receberá uma mensagem clara e um botão Voltar a ligar para tentar de novo.
  • Uma sondagem bloqueada significa quase sempre que o dispositivo não está acessível a partir do Agent — verifique se a descoberta ainda o vê e se o túnel VPN está ativo.

A Sondagem É Só de Leitura

A sondagem nunca altera o dispositivo nem guarda nada por si própria. Existe para que possa confirmar que o dispositivo responde e ver os seus valores reais antes de assumir o compromisso do registador.

Mapear os Valores de um Registador Genérico

Alguns registadores são genéricos — expõem uma longa lista de valores em bruto que a plataforma não consegue interpretar por si só (um contador de energia, um piranómetro e uma dúzia de outros canais por trás de um único dispositivo, cada um nomeado no vocabulário próprio do dispositivo). Para estes, o assistente executa um fluxo de mapeamento interativo em vez de uma pré-visualização só de leitura:

  1. No passo Mapear valores, o Agent enumera todos os valores em bruto que o dispositivo expõe e transmite-os de volta com o seu grupo, nome, unidade e uma amostra ao vivo. Obtém uma tabela pesquisável.
  2. Para cada valor em bruto que lhe interessa, escolha na lista pendente a métrica conhecida que ele representa. Deixe os restantes por mapear. Pode inverter um sinal por valor sempre que necessário; os prefixos de unidade (kW, kWh, …) são reescalados automaticamente para SI base.
  3. O passo Execução de teste volta a passar o dispositivo pelo seu mapeamento e mostra as métricas exatas que seriam produzidas — o seu ponto de verificação para aceitar/recusar.
  4. O Resumo confirma o que será guardado.

Apenas os valores que mapear são recolhidos, e cada valor em bruto é mapeado para exatamente uma métrica.

Associar Leituras (Adaptadores com Substituição Manual)

Para dispositivos que não são sem configuração, o passo Configuração mostra todas as leituras que a sondagem encontrou e permite-lhe escolher quais recolher, definir o intervalo de consulta e aplicar correções por leitura (por exemplo, inverter um sinal). Quando continua, a plataforma volta a sondar com a sua configuração para que o passo Resumo mostre os valores exatamente como serão armazenados.

Guardar

No passo final — Resumo para adaptadores manuais, ou o próprio passo Sondagem para dispositivos sem configuração — clique em Guardar registador (ou Adicionar para dispositivos sem configuração). O registador é guardado como uma alteração pendente. Ainda nada chega ao Agent.

Aplicar as Suas Alterações

Novos registadores, edições e remoções ficam em fila até os publicar no Agent num único lote.

  1. Faça todas as alterações de registadores que pretende.
  2. Clique em Aplicar alterações no topo da página Fluxo de dados (lê-se Aplicar N alteração(ões) pendente(s) quando colocou algumas em fila nesta sessão).
  3. O Agent é reimplementado com a nova configuração e começa a recolher pouco depois.

Aplicar É Sempre Seguro

Pode premir Aplicar alterações a qualquer momento — se não houver nada de novo para publicar, não faz nada. Após uma atualização da página, o contador de pendentes é reposto a zero, por isso use Aplicar alterações para se certificar de que a configuração mais recente está ativa.

Gerir Registadores Existentes

A tabela Registadores de Dados lista tudo o que está configurado para a central, com pesquisa, ordenação e estado por registador. O menu de ações ⋮ em cada linha permite-lhe:

  • Editar registador — ajustar a configuração do registador.
  • Editar dispositivo de rede — saltar para o dispositivo na página de Rede para alterar o seu IP, credenciais, SNMP ou definições de proxy (estas vivem num único lugar, não estão duplicadas aqui).
  • Pausar / Retomar — parar temporariamente a recolha durante uma janela escolhida (15 minutos até 24 horas) e retomá-la. Útil durante a manutenção, para que uma interrupção conhecida não gere eventos.
  • Remover registador — eliminar um registador que adicionou através do assistente.

Remover ou pausar um registador é também uma alteração pendente — lembre-se de Aplicar alterações depois.

O Que Pode Ser Integrado Através do Assistente

Dois tipos de dispositivo são integrados através do assistente:

  • Famílias sem configuração — o adaptador já conhece o conjunto completo de leituras do dispositivo, pelo que só tem de confirmar a sondagem ao vivo e guardar. Hoje, são os contadores Janitza (não são necessárias credenciais), o Huawei SmartLogger e os controladores Phoenix Contact.
  • Registadores genéricos — dispositivos que expõem valores em bruto arbitrários que a plataforma não consegue interpretar por si só. Estes são integrados através do fluxo interativo Mapear valores → Execução de teste descrito acima, em que associa cada valor em bruto a uma métrica conhecida. O QReader é o primeiro registador genérico suportado desta forma.

As famílias de dispositivos fora destes dois grupos continuam a funcionar, mas hoje não são integráveis através do assistente: precisam de uma configuração por dispositivo que o Mirox prepara e fornece com o Agent. Trate a automatização da integração como específica do dispositivo, não universal.

O Seu Dispositivo Não Está Listado?

Se o seu equipamento não estiver coberto por um adaptador existente, o Mirox cria um — muitas vezes mesmo para equipamento antigo ou interfaces sem documentação, desde que o dispositivo exponha os seus dados de alguma forma. O seletor de adaptadores no assistente liga diretamente a um pedido de suporte, ou pode iniciar um você mesmo.

Como pedi-lo: Solicitar uma Integração.

Para perceber como os adaptadores falam o protocolo de cada dispositivo, normalizam unidades e descobrem componentes, consulte a página de arquitetura Data Scraper — este guia, deliberadamente, não a repete.

Guias Relacionados

  • Gerir Dispositivos de Rede — descobrir e classificar os dispositivos contra os quais um registador é configurado
  • Configurar Componentes — associar as métricas recolhidas a inversores, strings e caixas de junção
  • Data Scraper — como os adaptadores recolhem, normalizam e encaminham os seus dados
  • Solicitar uma Integração — pedir ao Mirox para adicionar um adaptador para um dispositivo não suportado
  • Utilizar o Proxy — abrir a interface web do próprio dispositivo no navegador usando credenciais guardadas
Prev
Gerir dispositivos de rede
Next
Configurar os componentes
MIT Licensed | Copyright 2026 Mirox Verwaltungs GmbH