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étrica | Tipo | Unidade |
|---|---|---|
| powerplant_energy_grid_total | Energia | Wh |
| powerplant_energy_grid_out_total | Energia | Wh |
| powerplant_grid_energy_total_reactive | Energia | VArh |
| powerplant_grid_energy_total_apparent | Energia | VAh |
| powerplant_power_grid | Potência | W |
| powerplant_grid_power_reactive | Potência | VAr |
| powerplant_grid_power_apparent | Potência | VA |
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étrica | Tipo | Unidade |
|---|---|---|
| powerplant_inverter_energy_ac_total | Energia | Wh |
| powerplant_inverter_energy_dc_total | Energia | Wh |
| powerplant_inverter_energy_consumed_total | Energia | Wh |
| powerplant_inverter_power_ac | Potência | W |
| powerplant_inverter_power_dc | Potência | W |
| powerplant_inverter_power_reactive | Potência | VAr |
| powerplant_inverter_power_max | Potência | W |
| powerplant_inverter_setpoint_power_active | Setpoint | W |
| powerplant_inverter_setpoint_power_active_percent | Setpoint | % |
| powerplant_inverter_setpoint_power_reactive | Setpoint | VAr |
| powerplant_inverter_max_power | Encerramento | % |
| powerplant_inverter_voltage_ac | Tensão | V |
| powerplant_inverter_current_ac | Corrente | A |
| powerplant_inverter_voltage_dc | Tensão | V |
| powerplant_inverter_current_dc | Corrente | A |
| powerplant_inverter_resistance_iso | Resistência | Ohm |
| powerplant_inverter_cos | Fator de Potência | - |
| powerplant_inverter_frequency | Frequência | Hz |
| powerplant_inverter_temperature | Temperatura | °C |
| powerplant_inverter_current_ac_phase | Corrente | A |
| powerplant_inverter_voltage_ac__phase__L1_L2 | Tensão | V |
| powerplant_inverter_voltage_ac__phase__L2_L3 | Tensão | V |
| powerplant_inverter_voltage_ac__phase__L3_L1 | Tensão | V |
| powerplant_inverter_current_ac__phase__L1 | Corrente | A |
| powerplant_inverter_current_ac__phase__L2 | Corrente | A |
| powerplant_inverter_current_ac__phase__L3 | Corrente | A |
Métricas da Caixa de Junção (GAK)
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_gak_voltage | Tensão | V |
| powerplant_gak_current | Corrente | A |
| powerplant_gak_power | Potência | W |
| powerplant_gak_energy_total | Energia | Wh |
| powerplant_gak_temperature | Temperatura | °C |
Métricas de String
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_string_voltage | Tensão | V |
| powerplant_string_current | Corrente | A |
| powerplant_string_power | Potência | W |
| powerplant_string_energy_total | Energia | Wh |
Métricas de Controlo
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_max_power_by_grid | Encerramento | % |
| powerplant_max_power_by_external | Encerramento | % |
| powerplant_max_power_by_local | Encerramento | % |
| powerplant_control_connection_grid | Controlo | bool |
| powerplant_control_connection_external | Controlo | bool |
| powerplant_control_interface_ready | Controlo | bool |
| powerplant_power_max | Potência | W |
| powerplant_max_power_source | Controlo | - |
Métricas de Irradiância
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_solar_radiation | Irradiância | W/m² |
| powerplant_energy_irradiation_total | Energia | Wh |
| powerplant_solar_ghi_reference | Irradiância | W/m² |
| powerplant_solar_ghi_reference_energy | Energia | Wh |
Métricas Ambientais
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_humidity | Humidade | % |
| powerplant_ambient_temperature | Temperatura | °C |
| powerplant_module_temperature | Temperatura | °C |
| powerplant_wind_speed | Velocidade do Vento | m/s |
| powerplant_wind_direction | Direção do Vento | ° |
Métricas de Perda
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_energy_loss_total | Energia | Wh |
| powerplant_power_loss | Potência | W |
Métricas de Relatório
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_power_report | Potência | W |
| powerplant_energy_report_total | Energia | Wh |
| powerplant_energy_radiation_total | Energia | Wh |
Métricas do Gémeo Digital
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_grid_power_simulation | Potência | W |
| powerplant_grid_energy_total_simulation | Energia | Wh |
| powerplant_grid_prrc | PRRC | - |
| powerplant_grid_sim_err | Erro | - |
| powerplant_inverter_power_ac_simulation | Potência | W |
| powerplant_inverter_energy_ac_total_simulation | Energia | Wh |
| powerplant_inverter_prrc | PRRC | - |
| powerplant_inverter_sim_err | Erro | - |
| powerplant_gak_power_simulation | Potência | W |
| powerplant_gak_energy_total_simulation | Energia | Wh |
| powerplant_gak_prrc | PRRC | - |
| powerplant_gak_sim_err | Erro | - |
| powerplant_string_power_simulation | Potência | W |
| powerplant_string_energy_total_simulation | Energia | Wh |
| powerplant_string_shadow_factor | Fator | - |
| powerplant_string_prrc | PRRC | - |
| powerplant_string_sim_err | Erro | - |
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étrica | Tipo | Unidade |
|---|---|---|
| battery_environment_temperature | Temperatura | °C |
| battery_environment_humidity | Humidade | % |
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étrica | Tipo | Unidade |
|---|---|---|
| battery_box_voltage_ac | Tensão | V |
| battery_box_voltage_ac__phase__L1_L2 | Tensão | V |
| battery_box_voltage_ac__phase__L2_L3 | Tensão | V |
| battery_box_voltage_ac__phase__L3_L1 | Tensão | V |
| battery_box_current_ac | Corrente | A |
| battery_box_current_ac__phase__L1 | Corrente | A |
| battery_box_current_ac__phase__L2 | Corrente | A |
| battery_box_current_ac__phase__L3 | Corrente | A |
| battery_box_frequency | Frequência | Hz |
| battery_box_power_ac | Potência | W |
| battery_box_power_ac_in | Potência | W |
| battery_box_power_ac_out | Potência | W |
| battery_box_power_ac_reactive | Potência Reativa | VAr |
| battery_box_power_ac_setpoint | Setpoint | W |
| battery_box_power_ac_setpoint_reactive | Setpoint | VAr |
| battery_box_energy_ac_in_total | Energia | Wh |
| battery_box_energy_ac_out_total | Energia | Wh |
Interface do lado DC
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| battery_box_voltage_dc | Tensão | V |
| battery_box_voltage_dc_in | Tensão | V |
| battery_box_voltage_dc_out | Tensão | V |
| battery_box_current_dc | Corrente | A |
| battery_box_current_dc_in | Corrente | A |
| battery_box_current_dc_out | Corrente | A |
| battery_box_power_dc | Potência | W |
| battery_box_power_dc_in | Potência | W |
| battery_box_power_dc_out | Potência | W |
| battery_box_energy_dc_in_total | Energia | Wh |
| battery_box_energy_dc_out_total | Energia | Wh |
Química & estado
| Nome da Métrica | Tipo | Unidade | Descrição |
|---|---|---|---|
| battery_box_cell_voltage | Tensão (soma) | V | Soma das tensões de célula no barramento DC da caixa. |
| battery_box_soc | Estado de Carga | % | Estado de carga ao nível da caixa (0–100). |
| battery_box_soh | Estado de Saúde | % | Estado de saúde ao nível da caixa (0–100). |
| battery_box_temperature | Temperatura | °C | Temperatura representativa ao nível da caixa. |
| battery_box_energy_nominal | Energia | Wh | Energia nominal instalada nas células no início de vida. Decresce com o SoH. |
| battery_box_energy_usable | Energia | Wh | Energia utilizável máxima — a capacidade estática permitida pelo BMS a que corresponde SoC = 100 % (tipicamente 85–95 % de _nominal). |
| battery_box_energy_charged | Energia | Wh | Energia 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étrica | Tipo | Unidade |
|---|---|---|
| battery_storage_voltage_dc | Tensão | V |
| battery_storage_voltage_dc_in | Tensão | V |
| battery_storage_voltage_dc_out | Tensão | V |
| battery_storage_current_dc | Corrente | A |
| battery_storage_current_dc_in | Corrente | A |
| battery_storage_current_dc_out | Corrente | A |
| battery_storage_power_dc | Potência | W |
| battery_storage_power_dc_in | Potência | W |
| battery_storage_power_dc_out | Potência | W |
| battery_storage_energy_dc_in_total | Energia | Wh |
| battery_storage_energy_dc_out_total | Energia | Wh |
Química & estado
| Nome da Métrica | Tipo | Unidade | Descrição |
|---|---|---|---|
| battery_storage_cell_voltage | Tensão (soma) | V | Soma de todas as tensões de célula na string em série do armazenamento. |
| battery_storage_soc | Estado de Carga | % | Estado de carga deste armazenamento (0–100). |
| battery_storage_soh | Estado de Saúde | % | Estado de saúde deste armazenamento (0–100). |
| battery_storage_temperature | Temperatura | °C | Temperatura representativa ao nível do armazenamento. |
| battery_storage_energy_nominal | Energia | Wh | Energia nominal instalada nas células deste armazenamento (início de vida). |
| battery_storage_energy_usable | Energia | Wh | Energia utilizável máxima — a capacidade estática permitida pelo BMS a que corresponde SoC = 100 % (tipicamente 85–95 % de _nominal). |
| battery_storage_energy_charged | Energia | Wh | Energia atualmente armazenada, derivada de soc / 100 × energy_usable. |
| battery_storage_comm_quality | Qualidade | % | 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étrica | Tipo | Unidade |
|---|---|---|
| battery_module_voltage_dc | Tensão | V |
| battery_module_voltage_dc_in | Tensão | V |
| battery_module_voltage_dc_out | Tensão | V |
| battery_module_current_dc | Corrente | A |
| battery_module_current_dc_in | Corrente | A |
| battery_module_current_dc_out | Corrente | A |
| battery_module_power_dc | Potência | W |
| battery_module_power_dc_in | Potência | W |
| battery_module_power_dc_out | Potência | W |
| battery_module_energy_dc_in_total | Energia | Wh |
| battery_module_energy_dc_out_total | Energia | Wh |
Química & estado
| Nome da Métrica | Tipo | Unidade | Descrição |
|---|---|---|---|
| battery_module_cell_voltage | Tensão (soma) | V | Soma das tensões de célula na string em série deste módulo. |
| battery_module_soc | Estado de Carga | % | Estado de carga do módulo (0–100). |
| battery_module_soh | Estado de Saúde | % | Estado de saúde do módulo (0–100). |
| battery_module_temperature | Temperatura | °C | Temperatura representativa do módulo. |
| battery_module_energy_nominal | Energia | Wh | Energia máxima armazenável deste módulo. |
| battery_module_energy_usable | Energia | Wh | Energia utilizável máxima — a capacidade estática permitida pelo BMS a que corresponde SoC = 100 %. |
| battery_module_energy_charged | Energia | Wh | Energia atualmente armazenada, derivada de soc / 100 × energy_usable. |
| battery_module_comm_quality | Qualidade | % | 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étrica | Tipo | Unidade |
|---|---|---|
| battery_cell_voltage | Tensão | V |
| battery_cell_temperature | Temperatura | °C |
Métricas de Previsão Meteorológica
Métricas Meteorológicas Diárias
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| weather_forecast_daily_shortwave_radiation_sum | Radiação | Wh/m² |
| weather_forecast_daily_precipitation_sum | Precipitação | mm |
| weather_forecast_daily_rain_sum | Chuva | mm |
| weather_forecast_daily_showers_sum | Aguaceiros | mm |
| weather_forecast_daily_snowfall_sum | Queda de Neve | cm |
| weather_forecast_daily_precipitation_hours | Duração | h |
| weather_forecast_daily_weather_code | Código | - |
| weather_forecast_daily_temperature_2m_max | Temperatura | °C |
| weather_forecast_daily_wind_speed_10m_max | Velocidade do Vento | m/s |
| weather_forecast_daily_wind_gusts_10m_max | Rajadas de Vento | m/s |
| weather_forecast_daily_wind_direction_10m_dominant | Direção do Vento | ° |
Métricas Meteorológicas de 15 Minutos
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| weather_forecast_minutely_15_terrestrial_radiation | Radiação | W/m² |
| weather_forecast_minutely_15_shortwave_radiation | Radiação | W/m² |
| weather_forecast_minutely_15_diffuse_radiation | Radiação | W/m² |
| weather_forecast_minutely_15_direct_normal_irradiance | Irradiância | W/m² |
| weather_forecast_minutely_15_lightning_potential | Potencial | - |
| weather_forecast_minutely_15_precipitation | Precipitação | mm |
| weather_forecast_minutely_15_snowfall | Queda de Neve | cm |
| weather_forecast_minutely_15_rain | Chuva | mm |
| weather_forecast_minutely_15_weather_code | Código | - |
| weather_forecast_minutely_15_relative_humidity_2m | Humidade | % |
| weather_forecast_minutely_15_dew_point_2m | Temperatura | °C |
| weather_forecast_minutely_15_apparent_temperature | Temperatura | °C |
| weather_forecast_minutely_15_cloud_cover | Nebulosidade | % |
| weather_forecast_minutely_15_temperature_2m | Temperatura | °C |
| weather_forecast_minutely_15_temperature_80m | Temperatura | °C |
| weather_forecast_minutely_15_temperature_120m | Temperatura | °C |
| weather_forecast_minutely_15_temperature_180m | Temperatura | °C |
| weather_forecast_minutely_15_wind_speed_10m | Velocidade do Vento | m/s |
| weather_forecast_minutely_15_wind_speed_80m | Velocidade do Vento | m/s |
| weather_forecast_minutely_15_wind_speed_120m | Velocidade do Vento | m/s |
| weather_forecast_minutely_15_wind_speed_180m | Velocidade do Vento | m/s |
| weather_forecast_minutely_15_wind_direction_10m | Direção do Vento | ° |
| weather_forecast_minutely_15_wind_direction_80m | Direção do Vento | ° |
| weather_forecast_minutely_15_wind_direction_120m | Direção do Vento | ° |
| weather_forecast_minutely_15_wind_direction_180m | Direção do Vento | ° |
| weather_forecast_minutely_15_wind_gusts_10m | Rajadas de Vento | m/s |
| weather_forecast_minutely_15_snow_depth | Espessura de Neve | m |
| weather_forecast_minutely_15_visibility | Visibilidade | m |
Métricas de Cálculo Meteorológico
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| weather_forecast_minutely_15_gti | Irradiância | W/m² |
| weather_forecast_minutely_15_gti_direct | Irradiância | W/m² |
| weather_forecast_minutely_15_gti_clearsky | Irradiância | W/m² |
| weather_forecast_minutely_15_ghi_direct | Irradiância | W/m² |
| weather_forecast_minutely_15_ghi_direct_clearsky | Irradiância | W/m² |
| weather_forecast_minutely_15_gti_direct_clearsky | Irradiância | W/m² |
| weather_forecast_minutely_15_gti_energy | Energia | Wh |
Métricas de Modelo Meteorológico
Métricas de Potência do Modelo Meteorológico
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_power_model_dc | Potência | W |
| powerplant_energy_model_dc_total | Energia | Wh |
| powerplant_power_model_ac | Potência | W |
| powerplant_energy_model_ac_total | Energia | Wh |
| powerplant_power_model_grid | Potência | W |
| powerplant_energy_model_grid_total | Energia | Wh |
| powerplant_energy_model_grid_in_total | Energia | Wh |
| powerplant_energy_model_grid_out_total | Energia | Wh |
Métricas de Potência do Modelo Clearsky
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| powerplant_power_clearsky_dc | Potência | W |
| powerplant_energy_clearsky_dc_total | Energia | Wh |
| powerplant_power_clearsky_ac | Potência | W |
| powerplant_energy_clearsky_ac_total | Energia | Wh |
| powerplant_power_clearsky_grid | Potência | W |
| powerplant_energy_clearsky_grid_total | Energia | Wh |
| powerplant_energy_clearsky_grid_in_total | Energia | Wh |
| powerplant_energy_clearsky_grid_out_total | Energia | Wh |
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étrica | Tipo | Unidade |
|---|---|---|
| network_ping_latency_ms | Latência | ms |
| network_ping_packet_loss_percent | Perda de Pacotes | % |
| network_ping_success | Sucesso | bool |
| network_connection_status | Estado | - |
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étrica | Tipo | Unidade | Labels |
|---|---|---|---|
| scraper_health_state | Estado | código | source, source_num, name |
| scraper_cycles_total | Contador | - | source, source_num, name |
| scraper_errors_total | Contador | - | source, source_num, name |
| scraper_last_success_timestamp | Timestamp | s | source, 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étrica | Tipo | Unidade |
|---|---|---|
| agent_network_rx_bytes | Contador | bytes |
| agent_network_tx_bytes | Contador | bytes |
Saúde do Agente
| Nome da Métrica | Tipo | Unidade |
|---|---|---|
| agent_health | Estado | bool |
| agent_uptime_seconds | Duração | s |
| agent_boottime | Timestamp | s |
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étrica | Tipo | Unidade |
|---|---|---|
| agent_organization_vpn_connected | Estado | bool |
| agent_organization_vpn_rx_bytes | Contador | bytes |
| agent_organization_vpn_tx_bytes | Contador | bytes |
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étrica | Tipo | Unidade |
|---|---|---|
| agent_direct_vpn_connected | Estado | bool |
| agent_direct_vpn_rx_bytes | Contador | bytes |
| agent_direct_vpn_tx_bytes | Contador | bytes |
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étrica | Tipo | Unidade | Labels |
|---|---|---|---|
| operator_vpn_connected | Estado | bool | vpn_service, organization, cluster, region |
| operator_vpn_rx_bytes | Tráfego | bytes | vpn_service, organization, cluster, region |
| operator_vpn_tx_bytes | Tráfego | bytes | vpn_service, organization, cluster, region |
- operator_vpn_connected:
1se o túnel VPN tiver um handshake recente (nos últimos 3 minutos),0caso 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étrica | Tipo | Unidade | Labels |
|---|---|---|---|
| operator_health | Estado | bool | operator, cluster, region |
| operator_uptime_seconds | Duração | s | operator, cluster, region |
| operator_cloud_response_age_seconds | Duração | s | operator, cluster, region |
- operator_health:
1se o operador tiver uma ligação ativa à cloud,0se 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:
- Descoberta: O sistema identifica todos os componentes a monitorizar com base na configuração do parque
- Agendamento: Os agendamentos de recolha são otimizados com base na importância e variabilidade das métricas
- Obtenção: O data scraper liga-se aos dispositivos e recolhe as medições brutas
- Validação: Os dados recolhidos são validados quanto à exatidão e ao cumprimento dos intervalos
- Enriquecimento: É adicionada informação contextual (timestamps, identificadores de componentes, etc.)
- Transmissão: Os dados são transmitidos de forma segura para a Base de Dados de Séries Temporais
- 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