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
  • Plataforma

    • Filosofia da Plataforma
    • Visão Geral da Plataforma
    • Recursos da Plataforma
  • Mirox-Cloud

    • Visão Geral da Cloud
    • Microsserviços Ligados
  • Mirox-Agent

    • Mirox-Agent
    • Opções de Implementação do Agente
    • Coletor de Dados
    • Gémeo Digital
  • Detalhes técnicos

    • Recolha de Métricas

Recolha de Métricas

A Mirox reúne dados de desempenho das suas centrais de energia renovável num único vocabulário de métricas padronizado — a base de todas as capacidades de monitorização, análise, relatórios e previsão da plataforma. Esta página é o catálogo de referência do que é medido e de como as medições estão organizadas.

A taxonomia completa abrange 376 nomes de métricas padronizados distribuídos por onze famílias: produção da central (powerplant), armazenamento de baterias, entradas meteorológicas, modelos derivados da meteorologia e várias famílias operacionais que descrevem a própria recolha — monitorização de rede, os agentes, a frota de operadores, a acessibilidade básica de rede e as fontes do scraper. As tabelas abaixo documentam as famílias que irá representar graficamente com mais frequência; as famílias operacionais estão resumidas nas secções Métricas de Rede e Métricas de Agente.

Arquitetura do Data Scraper

No núcleo da recolha de métricas encontra-se o Data Scraper, o componente de edge que recolhe dados de séries temporais das suas centrais. Em vez de um único motor de protocolo genérico, utiliza um adaptador dedicado por família de dispositivos (data loggers, inversores, contadores, sistemas de baterias), cada um construído para a interface desse fornecedor. O Data Scraper pode operar em dois modos de implementação:

Recolha Baseada na Cloud

Quando implementado na cloud:

  • Liga-se aos parques solares através de ligações de internet seguras
  • Agrega dados de vários locais de forma centralizada
  • Gere a ligação e a lógica de repetição
  • Otimiza a utilização de largura de banda através de polling inteligente

Recolha Baseada na Edge

Quando implementado na edge (no local):

  • Faz interface diretamente com o equipamento local para uma latência mínima
  • Opera com buffering local para lidar com falhas de internet
  • Realiza validação e filtragem preliminares dos dados
  • Sincroniza com a cloud quando há conetividade disponível

A arquitetura de modo duplo garante uma recolha de dados fiável, independentemente das condições de conetividade do local ou da escala do sistema.

Métricas Recolhidas

O sistema de recolha de métricas reúne um conjunto abrangente de medições que proporcionam uma visibilidade completa do desempenho das centrais de energia renovável. As métricas estão agrupadas ao longo de três eixos ortogonais:

  • Métricas do Local descrevem o próprio local físico — a sua central, o seu armazenamento de baterias e a meteorologia em seu redor.
  • Métricas de Rede descrevem a conetividade entre o local e a cloud.
  • Métricas de Agente descrevem os próprios agentes de recolha de dados — as fontes do scraper e os serviços de infraestrutura de apoio executados no dispositivo IoT.

Métricas do Local

As métricas do local são as medições brutas de séries temporais recolhidas diretamente do equipamento instalado num local de energia renovável. Estão particionadas por domínio entre a central (inversores PV, ligação à rede, etc.), o sistema de armazenamento de energia em baterias (BESS) e a meteorologia (previsão e modelada).

Métricas da Central

Métricas de Rede Elétrica

Nome da MétricaTipoUnidade
powerplant_energy_grid_totalEnergiaWh
powerplant_energy_grid_out_totalEnergiaWh
powerplant_grid_energy_total_reactiveEnergiaVArh
powerplant_grid_energy_total_apparentEnergiaVAh
powerplant_power_gridPotênciaW
powerplant_grid_power_reactivePotênciaVAr
powerplant_grid_power_apparentPotênciaVA

Nota sobre a Convenção de Nomenclatura

As métricas powerplant_energy_grid_* e powerplant_power_grid não seguem o padrão de nomenclatura habitual (powerplant_grid_energy_* e powerplant_grid_power) por motivos de legado. As restantes métricas de rede elétrica seguem o padrão habitual powerplant_grid_*. Estes nomes de métricas de legado serão atualizados para seguir o padrão habitual numa versão futura.

Métricas de Inversor

Nome da MétricaTipoUnidade
powerplant_inverter_energy_ac_totalEnergiaWh
powerplant_inverter_energy_dc_totalEnergiaWh
powerplant_inverter_energy_consumed_totalEnergiaWh
powerplant_inverter_power_acPotênciaW
powerplant_inverter_power_dcPotênciaW
powerplant_inverter_power_reactivePotênciaVAr
powerplant_inverter_power_maxPotênciaW
powerplant_inverter_setpoint_power_activeSetpointW
powerplant_inverter_setpoint_power_active_percentSetpoint%
powerplant_inverter_setpoint_power_reactiveSetpointVAr
powerplant_inverter_max_powerEncerramento%
powerplant_inverter_voltage_acTensãoV
powerplant_inverter_current_acCorrenteA
powerplant_inverter_voltage_dcTensãoV
powerplant_inverter_current_dcCorrenteA
powerplant_inverter_resistance_isoResistênciaOhm
powerplant_inverter_cosFator de Potência-
powerplant_inverter_frequencyFrequênciaHz
powerplant_inverter_temperatureTemperatura°C
powerplant_inverter_current_ac_phaseCorrenteA
powerplant_inverter_voltage_ac__phase__L1_L2TensãoV
powerplant_inverter_voltage_ac__phase__L2_L3TensãoV
powerplant_inverter_voltage_ac__phase__L3_L1TensãoV
powerplant_inverter_current_ac__phase__L1CorrenteA
powerplant_inverter_current_ac__phase__L2CorrenteA
powerplant_inverter_current_ac__phase__L3CorrenteA

Métricas da Caixa de Junção (GAK)

Nome da MétricaTipoUnidade
powerplant_gak_voltageTensãoV
powerplant_gak_currentCorrenteA
powerplant_gak_powerPotênciaW
powerplant_gak_energy_totalEnergiaWh
powerplant_gak_temperatureTemperatura°C

Métricas de String

Nome da MétricaTipoUnidade
powerplant_string_voltageTensãoV
powerplant_string_currentCorrenteA
powerplant_string_powerPotênciaW
powerplant_string_energy_totalEnergiaWh

Métricas de Controlo

Nome da MétricaTipoUnidade
powerplant_max_power_by_gridEncerramento%
powerplant_max_power_by_externalEncerramento%
powerplant_max_power_by_localEncerramento%
powerplant_control_connection_gridControlobool
powerplant_control_connection_externalControlobool
powerplant_control_interface_readyControlobool
powerplant_power_maxPotênciaW
powerplant_max_power_sourceControlo-

Métricas de Irradiância

Nome da MétricaTipoUnidade
powerplant_solar_radiationIrradiânciaW/m²
powerplant_energy_irradiation_totalEnergiaWh
powerplant_solar_ghi_referenceIrradiânciaW/m²
powerplant_solar_ghi_reference_energyEnergiaWh

Métricas Ambientais

Nome da MétricaTipoUnidade
powerplant_humidityHumidade%
powerplant_ambient_temperatureTemperatura°C
powerplant_module_temperatureTemperatura°C
powerplant_wind_speedVelocidade do Ventom/s
powerplant_wind_directionDireção do Vento°

Métricas de Perda

Nome da MétricaTipoUnidade
powerplant_energy_loss_totalEnergiaWh
powerplant_power_lossPotênciaW

Métricas de Relatório

Nome da MétricaTipoUnidade
powerplant_power_reportPotênciaW
powerplant_energy_report_totalEnergiaWh
powerplant_energy_radiation_totalEnergiaWh

Métricas do Gémeo Digital

Nome da MétricaTipoUnidade
powerplant_grid_power_simulationPotênciaW
powerplant_grid_energy_total_simulationEnergiaWh
powerplant_grid_prrcPRRC-
powerplant_grid_sim_errErro-
powerplant_inverter_power_ac_simulationPotênciaW
powerplant_inverter_energy_ac_total_simulationEnergiaWh
powerplant_inverter_prrcPRRC-
powerplant_inverter_sim_errErro-
powerplant_gak_power_simulationPotênciaW
powerplant_gak_energy_total_simulationEnergiaWh
powerplant_gak_prrcPRRC-
powerplant_gak_sim_errErro-
powerplant_string_power_simulationPotênciaW
powerplant_string_energy_total_simulationEnergiaWh
powerplant_string_shadow_factorFator-
powerplant_string_prrcPRRC-
powerplant_string_sim_errErro-

Métricas de Bateria

A família battery_* é o vocabulário de métricas independente do fornecedor para qualquer Sistema de Armazenamento de Energia em Baterias (BESS). Segue uma hierarquia de componentes estrita em que a identificação da instância reside nas labels, e não no nome da métrica:

battery_environment_*       sensores ambiente em torno do BESS
battery_box_*               uma caixa / contentor BESS — topo do lado da bateria
└── battery_storage_*       um armário / rack dentro da caixa
    └── battery_module_*    um módulo dentro do armário
        └── battery_cell_*  uma célula individual dentro do módulo

Esta é uma especificação apenas de recolha — os adaptadores publicam os valores brutos exatamente como o fornecedor os expõe, sem agregações, derivações, modificadores _min / _max / _mean, nem indicadores de estado / saúde. Toda a interpretação, agregação e geração de alarmes são responsabilidades a jusante do gémeo digital.

Dois tipos distintos de "tensão"

A especificação separa deliberadamente duas grandezas fisicamente diferentes que, por acaso, são ambas medidas em volts:

  • Tensão de célula (*_cell_voltage) — a tensão terminal química produzida pelas células. Ao nível da célula, é a tensão de uma única célula (~3,2 V para uma célula LFP). Em níveis superiores, é a soma de todas as tensões de célula na mesma string em série. Varia apenas com o estado de carga.
  • Tensão de interface (*_voltage_dc, _dc_in, _dc_out) — o que está a ser injetado ou retirado da bateria nos seus terminais elétricos. Difere da tensão de célula por I·R durante a carga / descarga.

As duas são fisicamente o mesmo número quando a bateria está em repouso; divergem pela queda IR no momento em que qualquer corrente flui.

Variantes DC sensíveis à direção

Para cada grandeza DC (voltage_dc, current_dc, power_dc) aos níveis de caixa, armazenamento e módulo existem três variantes: *_dc (com sinal, registo único do fornecedor), *_dc_in (sempre positivo — valor durante a carga) e *_dc_out (sempre positivo — valor durante a descarga). Os adaptadores publicam a(s) variante(s) que o fornecedor expõe efetivamente.

Ambiente

Sensores ambiente em torno do BESS — distinguidos pela label sensor.

Nome da MétricaTipoUnidade
battery_environment_temperatureTemperatura°C
battery_environment_humidityHumidade%

Nível de Caixa

O topo do lado da bateria — uma caixa / contentor BESS. Label obrigatória: box. Labels opcionais: inverter, phase. As métricas do lado AC só estão presentes quando a conversão AC↔DC reside fisicamente ao nível da caixa.

Fluxo de energia do lado AC
Nome da MétricaTipoUnidade
battery_box_voltage_acTensãoV
battery_box_voltage_ac__phase__L1_L2TensãoV
battery_box_voltage_ac__phase__L2_L3TensãoV
battery_box_voltage_ac__phase__L3_L1TensãoV
battery_box_current_acCorrenteA
battery_box_current_ac__phase__L1CorrenteA
battery_box_current_ac__phase__L2CorrenteA
battery_box_current_ac__phase__L3CorrenteA
battery_box_frequencyFrequênciaHz
battery_box_power_acPotênciaW
battery_box_power_ac_inPotênciaW
battery_box_power_ac_outPotênciaW
battery_box_power_ac_reactivePotência ReativaVAr
battery_box_power_ac_setpointSetpointW
battery_box_power_ac_setpoint_reactiveSetpointVAr
battery_box_energy_ac_in_totalEnergiaWh
battery_box_energy_ac_out_totalEnergiaWh
Interface do lado DC
Nome da MétricaTipoUnidade
battery_box_voltage_dcTensãoV
battery_box_voltage_dc_inTensãoV
battery_box_voltage_dc_outTensãoV
battery_box_current_dcCorrenteA
battery_box_current_dc_inCorrenteA
battery_box_current_dc_outCorrenteA
battery_box_power_dcPotênciaW
battery_box_power_dc_inPotênciaW
battery_box_power_dc_outPotênciaW
battery_box_energy_dc_in_totalEnergiaWh
battery_box_energy_dc_out_totalEnergiaWh
Química & estado
Nome da MétricaTipoUnidadeDescrição
battery_box_cell_voltageTensão (soma)VSoma das tensões de célula no barramento DC da caixa.
battery_box_socEstado de Carga%Estado de carga ao nível da caixa (0–100).
battery_box_sohEstado de Saúde%Estado de saúde ao nível da caixa (0–100).
battery_box_temperatureTemperatura°CTemperatura representativa ao nível da caixa.
battery_box_energy_nominalEnergiaWhEnergia nominal instalada nas células no início de vida. Decresce com o SoH.
battery_box_energy_usableEnergiaWhEnergia utilizável máxima — a capacidade estática permitida pelo BMS a que corresponde SoC = 100 % (tipicamente 85–95 % de _nominal).
battery_box_energy_chargedEnergiaWhEnergia atualmente armazenada na caixa, derivada de soc / 100 × energy_usable.

Nível de Armazenamento

Um armário / rack dentro de uma caixa. Labels obrigatórias: box, storage. As métricas AC são raras neste nível.

Interface do lado DC
Nome da MétricaTipoUnidade
battery_storage_voltage_dcTensãoV
battery_storage_voltage_dc_inTensãoV
battery_storage_voltage_dc_outTensãoV
battery_storage_current_dcCorrenteA
battery_storage_current_dc_inCorrenteA
battery_storage_current_dc_outCorrenteA
battery_storage_power_dcPotênciaW
battery_storage_power_dc_inPotênciaW
battery_storage_power_dc_outPotênciaW
battery_storage_energy_dc_in_totalEnergiaWh
battery_storage_energy_dc_out_totalEnergiaWh
Química & estado
Nome da MétricaTipoUnidadeDescrição
battery_storage_cell_voltageTensão (soma)VSoma de todas as tensões de célula na string em série do armazenamento.
battery_storage_socEstado de Carga%Estado de carga deste armazenamento (0–100).
battery_storage_sohEstado de Saúde%Estado de saúde deste armazenamento (0–100).
battery_storage_temperatureTemperatura°CTemperatura representativa ao nível do armazenamento.
battery_storage_energy_nominalEnergiaWhEnergia nominal instalada nas células deste armazenamento (início de vida).
battery_storage_energy_usableEnergiaWhEnergia utilizável máxima — a capacidade estática permitida pelo BMS a que corresponde SoC = 100 % (tipicamente 85–95 % de _nominal).
battery_storage_energy_chargedEnergiaWhEnergia atualmente armazenada, derivada de soc / 100 × energy_usable.
battery_storage_comm_qualityQualidade%Qualidade da ligação de comunicação ao nível do armazenamento (0–100).

Nível de Módulo

Um módulo dentro de um armário — a unidade mais pequena que possui o seu próprio chip BMS. Labels obrigatórias: box, storage, module. As métricas AC praticamente nunca estão presentes aqui.

Interface do lado DC
Nome da MétricaTipoUnidade
battery_module_voltage_dcTensãoV
battery_module_voltage_dc_inTensãoV
battery_module_voltage_dc_outTensãoV
battery_module_current_dcCorrenteA
battery_module_current_dc_inCorrenteA
battery_module_current_dc_outCorrenteA
battery_module_power_dcPotênciaW
battery_module_power_dc_inPotênciaW
battery_module_power_dc_outPotênciaW
battery_module_energy_dc_in_totalEnergiaWh
battery_module_energy_dc_out_totalEnergiaWh
Química & estado
Nome da MétricaTipoUnidadeDescrição
battery_module_cell_voltageTensão (soma)VSoma das tensões de célula na string em série deste módulo.
battery_module_socEstado de Carga%Estado de carga do módulo (0–100).
battery_module_sohEstado de Saúde%Estado de saúde do módulo (0–100).
battery_module_temperatureTemperatura°CTemperatura representativa do módulo.
battery_module_energy_nominalEnergiaWhEnergia máxima armazenável deste módulo.
battery_module_energy_usableEnergiaWhEnergia utilizável máxima — a capacidade estática permitida pelo BMS a que corresponde SoC = 100 %.
battery_module_energy_chargedEnergiaWhEnergia atualmente armazenada, derivada de soc / 100 × energy_usable.
battery_module_comm_qualityQualidade%Qualidade das comunicações BMS entre este módulo e o seu controlador de armazenamento (0–100).

Nível de Célula

A unidade física mais pequena. As células estão ligadas em série dentro de um módulo e partilham a corrente do módulo, pelo que a corrente e a potência por célula não são significativas. Labels obrigatórias: box, storage, module, cell.

Nome da MétricaTipoUnidade
battery_cell_voltageTensãoV
battery_cell_temperatureTemperatura°C

Métricas de Previsão Meteorológica

Métricas Meteorológicas Diárias

Nome da MétricaTipoUnidade
weather_forecast_daily_shortwave_radiation_sumRadiaçãoWh/m²
weather_forecast_daily_precipitation_sumPrecipitaçãomm
weather_forecast_daily_rain_sumChuvamm
weather_forecast_daily_showers_sumAguaceirosmm
weather_forecast_daily_snowfall_sumQueda de Nevecm
weather_forecast_daily_precipitation_hoursDuraçãoh
weather_forecast_daily_weather_codeCódigo-
weather_forecast_daily_temperature_2m_maxTemperatura°C
weather_forecast_daily_wind_speed_10m_maxVelocidade do Ventom/s
weather_forecast_daily_wind_gusts_10m_maxRajadas de Ventom/s
weather_forecast_daily_wind_direction_10m_dominantDireção do Vento°

Métricas Meteorológicas de 15 Minutos

Nome da MétricaTipoUnidade
weather_forecast_minutely_15_terrestrial_radiationRadiaçãoW/m²
weather_forecast_minutely_15_shortwave_radiationRadiaçãoW/m²
weather_forecast_minutely_15_diffuse_radiationRadiaçãoW/m²
weather_forecast_minutely_15_direct_normal_irradianceIrradiânciaW/m²
weather_forecast_minutely_15_lightning_potentialPotencial-
weather_forecast_minutely_15_precipitationPrecipitaçãomm
weather_forecast_minutely_15_snowfallQueda de Nevecm
weather_forecast_minutely_15_rainChuvamm
weather_forecast_minutely_15_weather_codeCódigo-
weather_forecast_minutely_15_relative_humidity_2mHumidade%
weather_forecast_minutely_15_dew_point_2mTemperatura°C
weather_forecast_minutely_15_apparent_temperatureTemperatura°C
weather_forecast_minutely_15_cloud_coverNebulosidade%
weather_forecast_minutely_15_temperature_2mTemperatura°C
weather_forecast_minutely_15_temperature_80mTemperatura°C
weather_forecast_minutely_15_temperature_120mTemperatura°C
weather_forecast_minutely_15_temperature_180mTemperatura°C
weather_forecast_minutely_15_wind_speed_10mVelocidade do Ventom/s
weather_forecast_minutely_15_wind_speed_80mVelocidade do Ventom/s
weather_forecast_minutely_15_wind_speed_120mVelocidade do Ventom/s
weather_forecast_minutely_15_wind_speed_180mVelocidade do Ventom/s
weather_forecast_minutely_15_wind_direction_10mDireção do Vento°
weather_forecast_minutely_15_wind_direction_80mDireção do Vento°
weather_forecast_minutely_15_wind_direction_120mDireção do Vento°
weather_forecast_minutely_15_wind_direction_180mDireção do Vento°
weather_forecast_minutely_15_wind_gusts_10mRajadas de Ventom/s
weather_forecast_minutely_15_snow_depthEspessura de Nevem
weather_forecast_minutely_15_visibilityVisibilidadem

Métricas de Cálculo Meteorológico

Nome da MétricaTipoUnidade
weather_forecast_minutely_15_gtiIrradiânciaW/m²
weather_forecast_minutely_15_gti_directIrradiânciaW/m²
weather_forecast_minutely_15_gti_clearskyIrradiânciaW/m²
weather_forecast_minutely_15_ghi_directIrradiânciaW/m²
weather_forecast_minutely_15_ghi_direct_clearskyIrradiânciaW/m²
weather_forecast_minutely_15_gti_direct_clearskyIrradiânciaW/m²
weather_forecast_minutely_15_gti_energyEnergiaWh

Métricas de Modelo Meteorológico

Métricas de Potência do Modelo Meteorológico

Nome da MétricaTipoUnidade
powerplant_power_model_dcPotênciaW
powerplant_energy_model_dc_totalEnergiaWh
powerplant_power_model_acPotênciaW
powerplant_energy_model_ac_totalEnergiaWh
powerplant_power_model_gridPotênciaW
powerplant_energy_model_grid_totalEnergiaWh
powerplant_energy_model_grid_in_totalEnergiaWh
powerplant_energy_model_grid_out_totalEnergiaWh

Métricas de Potência do Modelo Clearsky

Nome da MétricaTipoUnidade
powerplant_power_clearsky_dcPotênciaW
powerplant_energy_clearsky_dc_totalEnergiaWh
powerplant_power_clearsky_acPotênciaW
powerplant_energy_clearsky_ac_totalEnergiaWh
powerplant_power_clearsky_gridPotênciaW
powerplant_energy_clearsky_grid_totalEnergiaWh
powerplant_energy_clearsky_grid_in_totalEnergiaWh
powerplant_energy_clearsky_grid_out_totalEnergiaWh

Métricas de Rede

As métricas de rede descrevem a conetividade entre o dispositivo IoT e a cloud, independentemente de qualquer scraper ou serviço específico.

Nome da MétricaTipoUnidade
network_ping_latency_msLatênciams
network_ping_packet_loss_percentPerda de Pacotes%
network_ping_successSucessobool
network_connection_statusEstado-

Métricas de Agente

As métricas de agente descrevem os próprios agentes de recolha de dados — tanto o estado por fonte de cada adaptador individual do scraper, como a saúde global e o tráfego dos agentes e da conetividade de apoio. Estas métricas permitem que os seus dashboards correlacionem lacunas de dados com falhas de adaptadores ou de conetividade, em vez de com o equipamento em medição.

Métricas das Fontes do Scraper

O Data Scraper emite um conjunto destas métricas por cada fonte de adaptador ativa. As séries são distinguidas pelas labels source, source_num e name, de forma a que as lacunas de dados possam ser correlacionadas diretamente com a saúde do adaptador, em vez de com o equipamento em medição.

Nome da MétricaTipoUnidadeLabels
scraper_health_stateEstadocódigosource, source_num, name
scraper_cycles_totalContador-source, source_num, name
scraper_errors_totalContador-source, source_num, name
scraper_last_success_timestampTimestampssource, source_num, name
  • scraper_health_state: Estado atual do adaptador, codificado como um inteiro: 0 = a inicializar, 1 = saudável, 2 = não saudável, 3 = a reconectar, 4 = congelado (o logger devolve valores obsoletos/bloqueados), 5 = em pausa.
  • scraper_cycles_total: Número de ciclos de recolha que o adaptador executou desde o arranque do processo (reinicia ao reiniciar).
  • scraper_errors_total: Número de ciclos de recolha que terminaram numa exceção desde o arranque do processo (reinicia ao reiniciar).
  • scraper_last_success_timestamp: Segundos da época Unix do último ciclo de recolha bem-sucedido. Apenas emitido após o primeiro sucesso.

Métricas dos Serviços de Agente

Estas métricas acompanham a saúde e a utilização de rede dos serviços de agente individuais (Data Scraper, Digital Twin e serviços de apoio) em execução num dispositivo, para que possa perceber se uma lacuna de dados se deve ao equipamento ou ao próprio agente.

Tráfego de Rede

Nome da MétricaTipoUnidade
agent_network_rx_bytesContadorbytes
agent_network_tx_bytesContadorbytes

Saúde do Agente

Nome da MétricaTipoUnidade
agent_healthEstadobool
agent_uptime_secondsDuraçãos
agent_boottimeTimestamps

VPN da Organização

Conetividade e tráfego da ligação VPN ao nível da organização entre a central e a cloud.

Nome da MétricaTipoUnidade
agent_organization_vpn_connectedEstadobool
agent_organization_vpn_rx_bytesContadorbytes
agent_organization_vpn_tx_bytesContadorbytes

VPN Direta

Conetividade e tráfego de cada túnel VPN direto (por central). As séries incluem uma label vpn_name para que cada túnel seja identificado individualmente.

Nome da MétricaTipoUnidade
agent_direct_vpn_connectedEstadobool
agent_direct_vpn_rx_bytesContadorbytes
agent_direct_vpn_tx_bytesContadorbytes

Métricas do Operador

A frota de operadores envia métricas de infraestrutura para a monitorização de túneis VPN e para a saúde do operador, permitindo-lhe ver o estado da conetividade do lado da cloud que liga as suas centrais à plataforma.

Métricas de Túnel VPN

Nome da MétricaTipoUnidadeLabels
operator_vpn_connectedEstadoboolvpn_service, organization, cluster, region
operator_vpn_rx_bytesTráfegobytesvpn_service, organization, cluster, region
operator_vpn_tx_bytesTráfegobytesvpn_service, organization, cluster, region
  • operator_vpn_connected: 1 se o túnel VPN tiver um handshake recente (nos últimos 3 minutos), 0 caso contrário
  • operator_vpn_rx_bytes: Total de bytes recebidos através do túnel VPN (contador)
  • operator_vpn_tx_bytes: Total de bytes transmitidos através do túnel VPN (contador)

Métricas de Saúde do Operador

Nome da MétricaTipoUnidadeLabels
operator_healthEstadobooloperator, cluster, region
operator_uptime_secondsDuraçãosoperator, cluster, region
operator_cloud_response_age_secondsDuraçãosoperator, cluster, region
  • operator_health: 1 se o operador tiver uma ligação ativa à cloud, 0 se estiver em estado de timeout
  • operator_uptime_seconds: Segundos desde o arranque do processo do operador
  • operator_cloud_response_age_seconds: Segundos desde a última resposta bem-sucedida da API da cloud

Processo de Recolha

O processo de recolha de dados segue um fluxo de trabalho estruturado:

  1. Descoberta: O sistema identifica todos os componentes a monitorizar com base na configuração do parque
  2. Agendamento: Os agendamentos de recolha são otimizados com base na importância e variabilidade das métricas
  3. Obtenção: O data scraper liga-se aos dispositivos e recolhe as medições brutas
  4. Validação: Os dados recolhidos são validados quanto à exatidão e ao cumprimento dos intervalos
  5. Enriquecimento: É adicionada informação contextual (timestamps, identificadores de componentes, etc.)
  6. Transmissão: Os dados são transmitidos de forma segura para a Base de Dados de Séries Temporais
  7. Verificação: O sistema confirma o armazenamento bem-sucedido e a disponibilidade

Pontos de Integração

O sistema de recolha de métricas integra-se com outros componentes da plataforma:

  • Dashboard de Monitorização: Proporciona a visualização de dados em tempo real
  • Deteção de Eventos: Fornece dados para a identificação de anomalias e problemas
  • Motor de Relatórios: Fornece medições para os relatórios de desempenho
  • Sistema de Análise: Alimenta os dados em cálculos avançados de desempenho
  • Módulo de Previsão: Fornece dados históricos para os modelos de previsão

Segurança dos Dados

Todas as métricas recolhidas são protegidas através de várias medidas de segurança:

  • Encriptação: Os dados são encriptados tanto em trânsito como em repouso
  • Controlo de Acesso: As métricas estão sujeitas ao mesmo modelo de permissões que os restantes recursos
  • Auditoria: Todos os acessos aos dados das métricas são registados para fins de conformidade
  • Anonimização: Os dados agregados utilizados para benchmarking são anonimizados

Extensibilidade

O sistema de recolha de métricas foi concebido para a extensibilidade:

  • Novas Famílias de Dispositivos: Construímos um adaptador dedicado para cada família de dispositivos mediante pedido — se a sua central utilizar um logger, inversor, contador ou sistema de baterias que ainda não suportamos, pode ser adicionado sem recorrer a uma solução genérica universal.
  • Métricas Personalizadas: Suporte para medições específicas do local ou do equipamento.
  • Fontes de Dados Externas: As séries de meteorologia e de irradiância de referência são integradas em conjunto com os dados da sua central para alimentar a análise e a previsão.

Funcionalidades Relacionadas

  • Data Scraper — o agente de edge que recolhe estas métricas com um adaptador dedicado por família de dispositivos
  • Digital Twin — transforma as métricas brutas em produção simulada, rácio de desempenho e deteção de perdas
  • API de Exportação de Métricas — consulte e descarregue estas métricas para utilização própria
  • MiroxQL — o formato de consulta para acesso programático e bruto às métricas recolhidas
  • Monitorização em Tempo Real — dashboards ao vivo construídos sobre as métricas recolhidas
MIT Licensed | Copyright 2026 Mirox Verwaltungs GmbH