Histórico

History mostra o que o hub registou para os seus pontos: energia, potência, tensão, potência reativa e dinheiro, por hora, dia ou mês. Abra-o a partir da navegação à esquerda da aplicação: Monitoring → History.

Tudo nesta página vem dos registos guardados no hub. O hub mantém histórico para até 12 pontos (ver Points); os pontos de nós remotos contam entre eles (ver Remote nodes). Uma entrada trifásica medida por fase são três pontos aqui, cada um com o seu gráfico, tabela e CSV; esta página nunca os soma. A entrada completa, somada, é o que a Visão geral e Economics mostram a partir do firmware v1.1.6.

Períodos e tamanhos de intervalo

Escolha um período com os botões no topo. Não há intervalo de datas personalizado: escolhe um dos períodos predefinidos e depois avança ou recua com as setas ‹ ›, um período completo de cada vez. › fica esmaecido enquanto estiver no período atual. A etiqueta entre as setas mostra o período no ecrã, por exemplo "16 Oct", "10 Oct – 16 Oct", "September 2026" ou "2025".

Depois de recuar com ‹, a comparação é sempre "the period before".

• Os períodos seguem o relógio e o fuso horário do hub, e não os do telemóvel ou do computador (ver Time).
• Today e Yesterday mostram sempre o eixo completo de 0–24 h.
• O History não tem passo semanal. Para uma vista semanal de um ponto, use o cartão de tendência na página do próprio ponto (ver Points).
• A aplicação lembra o seu período, métrica, vista e escolhas de comparação enquanto o separador do navegador estiver aberto.

Métricas

A faixa do fator de potência aparece quando os registos trazem um fator de potência. A sua escala é pelo menos 0.5–1.0 e alarga-se quando os dados saem desse intervalo. A sua legenda: "cos φ (power factor): 1 — all power is useful; below 0.9 — a noticeable reactive load".

O dinheiro é mostrado na moeda do seu plano tarifário (ver Tariffs).

As linhas horárias são desenhadas como degraus; as linhas diárias e mensais, e a tensão, como curvas suaves.

Escolher pontos

Cada ponto é um chip na sua própria cor acima do gráfico. Toque num chip para o acrescentar ao gráfico ou o retirar. Ao abrir a página, o primeiro ponto (por ordem de ID do ponto) fica selecionado.

O gráfico mostra até seis pontos de cada vez. Com mais de seis pontos, os primeiros seis (por ordem de ID do ponto) podem ser selecionados. Os outros ficam na linha de chips, esmaecidos, e não podem ser selecionados.

Os pontos que estão configurados mas que não reportam valores em tempo real neste momento continuam listados, porque os seus registos guardados não precisam de uma ligação em tempo real.

Se vir "No points available.", ainda não foi configurado nenhum ponto. "Select a point." significa que nenhum está selecionado.

Total e partes

Quando seleciona a entrada juntamente com pelo menos outro ponto, e a métrica é Energy ou Money, aparece um botão de alternância:

• Total and parts (a predefinição): uma barra por espaço. As linhas selecionadas são empilhadas nas suas próprias cores, e o restante valor da entrada é desenhado a cinzento como "The rest (not metered)". O total da entrada é impresso acima da barra quando há espaço para isso. A exportação desce a partir de zero.
• Side by side: cada ponto tem a sua própria barra.

"The rest" é a parte do seu fornecimento que nenhum dos pontos selecionados mede.

Comparação com o período anterior

O gráfico pode desenhar o período anterior por trás do atual, para um ponto de cada vez:

• com um ponto selecionado, esse ponto;
• em Total and parts, a entrada;
• com vários pontos side by side, o ponto que escolher em Compare with the previous period (ou No comparison).

Nas linhas, o período anterior tem a mesma cor, mais fina e esbatida. Nas barras, é uma marca escura no valor anterior sobre cada espaço. Com um ponto selecionado, a legenda nomeia os dois períodos, por exemplo "Today" e "Yesterday"; depois de recuar, lêem-se "This period" e "The previous period". Em Total and parts, e com vários pontos lado a lado, a legenda mostra apenas o período anterior; lado a lado, leva o nome do ponto, por exemplo "Yesterday · Kitchen".

O gráfico desenha o período anterior completo. A percentagem no cartão de totais compara apenas a parte correspondente dele (por exemplo, hoje até agora contra ontem até à mesma hora).

O cartão de totais

Com Energy ou Money, um cartão acima do gráfico soma o período para cada ponto selecionado:

• Imported in the period (Energy) ou Cost of the period (Money), com "exported …" ou "earned …" numa segunda linha;
• para um ponto de geração com Energy: Produced in the period, sem linha "exported …" (com Money mostra Cost of the period);
• uma linha de variação: "… % more than …", "… % less than …", "about the same as …" (uma variação abaixo de 0.5 %), ou "nothing to compare with — no data for the previous period".

A variação compara apenas registos fechados, e só quando o período anterior tem pelo menos tantos registos como o atual.

Nos períodos em curso (Today, 7 days, This month, This year), o valor inclui hoje a partir dos contadores do próprio hub, pelo que coincide com a Visão geral. Uma nota por baixo do valor di-lo. Em Today, as barras mostram apenas as horas fechadas, enquanto o valor inclui a hora atual. Numa semana ou mês em curso, a barra de hoje é acrescentada a partir dos contadores em tempo real e desenhada como dia parcial.

Gráfico ou tabela

Alterne entre Chart e Table. A tabela lista os mesmos registos, do mais recente para o mais antigo. Uma linha de hora lê-se como um intervalo, como "16:00–17:00".

Num telemóvel, o terceiro valor e a coluna Quality ficam ocultos, e o texto da qualidade passa para debaixo da hora.

Os pontos de um módulo BASIC contam apenas o consumo, sem direção. Para Energy e Money, a tabela mostra apenas a primeira coluna, com uma nota de que estes registos não trazem exportação.

Quality

A coluna Quality indica o grau de completude de cada registo:

• complete;
• partial: 20 min of 1 h (quanto do período foi registado);
• longer than the period: {duration}, por exemplo "longer than the period: 1 h 15 min";
• recomputed from the hour records (um dia reconstruído a partir das suas horas).

Lista também qualquer uma destas notas:

⚠️ A nota de interrupção é a que altera o dinheiro, e não apenas a completude. Esses kWh são reais, mas não foram usados nessa hora, pelo que o hub os tarifa à zona predefinida do plano e não à zona em vigor durante a interrupção. Se a interrupção atravessou uma janela barata, o custo aparece mais alto do que seria. → How cost is calculated

As linhas parciais têm um fundo vermelho suave. Os registos feitos antes de o relógio do hub ser definido mostram "before sync" e ficam fora dos gráficos.

Períodos incompletos, reinícios e pontos apenas em tempo real

Períodos incompletos. Um registo é parcial quando cobre menos do que a sua hora, dia ou mês completo, normalmente porque o hub esteve desligado ou a reiniciar. O seu valor está correto para o tempo em que o hub esteve a funcionar. Quando a janela contém tais registos, o cabeçalho mostra incomplete periods present. Nas barras, um espaço parcial é hachurado; nas linhas, um ponto parcial é um anel vazio. A legenda chama-lhe "Incomplete period".

Falhas. Uma hora ou dia em falta fica como espaço vazio ou como uma quebra na linha. O gráfico nunca liga uma falha à seguinte.

Falha por reinício. Se o hub esteve em baixo durante pelo menos um minuto dentro da janela, uma nota indica quando, por exemplo "The hub was down 16 Oct, 03:12 – 03:20 (restart): no records for that time.". Só é reportado o reinício mais recente do hub. "Today" na Visão geral continua a contar essa energia a partir dos contadores do hub.

Pontos apenas em tempo real. Um ponto que não guarda histórico mostra uma nota: "name shows live values only — it has no stored history." Segue-se uma destas:

• "The hub keeps history for 12 points." — todos os 12 espaços de histórico estão ocupados;
• "Restart the hub to start its history." — o ponto foi associado enquanto o hub estava a funcionar; o seu histórico começa após o próximo reinício.

Ligação lenta ou perdida. Se os registos demorarem mais de 12 segundos a carregar, a página diz "The hub is slow to answer — still waiting for the archive…". Sem ligação, diz "No connection to the hub — the archive will load when it's back."

Se o carregamento falhar, a página mostra "Couldn't load history."; um período sem registos mostra "No data for the selected period."

Transferências

As duas transferências são geradas no seu navegador; o hub não cria nenhum ficheiro. Download CSV usa os registos no ecrã. Summary by point pede de novo ao hub os registos de energia e dinheiro de cada ponto para o período, independentemente da métrica no ecrã.

Download CSV

Download CSV guarda um ficheiro com todos os pontos selecionados, para o período e a métrica no ecrã. O botão mostra uma estimativa aproximada do tamanho, e fica esmaecido quando não há dados.

Colunas: Interval start (relógio do hub, com o seu desvio UTC), Point, as colunas da métrica, Duration, min e Status.

• Duration, min é em minutos inteiros.
• Status diz "partial" quando um registo está a mais de um minuto de completar a sua hora ou dia.
• Os ficheiros de Energy e Money terminam com uma linha "Sum of the period's records" por ponto.
• Um registo que está dentro de um registo mais longo do mesmo ponto fica de fora, para que a mesma energia não seja contada duas vezes.
• Os números seguem o formato numérico escolhido em Settings → Interface (com "as the language", o idioma da sua aplicação). Com vírgula decimal, o ficheiro usa ; como separador e começa com uma marca UTF-8, para abrir diretamente em aplicações de folhas de cálculo configuradas para esse formato; caso contrário, ,.

Summary by point

Summary by point (CSV) guarda uma linha por ponto selecionado para o período no ecrã: kWh importados, custo, kWh exportados e valor da exportação. A primeira linha indica o período.

• A linha da entrada é rotulada "(input, includes the lines)".
• A última linha é Total of the lines quando a entrada e pelo menos uma linha estão selecionadas (a entrada não é somada por cima delas). Caso contrário, é Sum of the period's records, somada pelos pontos selecionados.
• Nos períodos em curso, usa os mesmos valores do cartão de totais.

Se um ficheiro não puder ser gerado, a aplicação diz "Could not build the file."

Ligações para uma vista

Pode abrir o History numa vista escolhida através de uma ligação:

http://<hub address>/#/history?point=<point ID>&win=<period>&metric=<metric>&view=<chart|table>

Na aplicação em webapp.rbgrid.io a mesma ligação começa com https://webapp.rbgrid.io/#/history?….

Os valores desconhecidos são ignorados. A aplicação aplica os parâmetros uma vez e depois remove-os do endereço, pelo que voltar atrás ou atualizar mantém as suas escolhas posteriores.

A ligação As a table numa página de ponto usa isto: uma tendência horária abre Today, uma tendência diária ou semanal abre This month, com a métrica da tendência e a vista de tabela. O gráfico de energia da Visão geral também tem uma ligação As a table: abre Today, Energy (ou Money na vista de dinheiro), como tabela.

O que verificar quando um registo parece errado

Uma hora tem energia que não foi usada nessa altura

• Leia a sua Quality: "includes energy from a break in measurement" diz-lhe que o hub o indica de propósito. Essa energia é tarifada à zona predefinida do plano. → How cost is calculated
• Um nó remoto que esteve fora de alcance entrega os seus períodos com atraso, e eles caem nas horas a que pertencem — por isso uma hora pode ganhar energia depois de a ter visto pela primeira vez. Isso é o desenho, não uma avaria. → Remote nodes

Faltam horas, ou o dia é curto

• Os registos parciais estão marcados e hachurados: o valor está correto para o tempo em que o hub esteve a funcionar. O cabeçalho diz incomplete periods present quando a janela contém algum.
• Os registos feitos antes de o relógio do hub ser definido mostram before sync e ficam fora dos gráficos. → Time

Um dia não é igual à soma das suas horas

• Um dia reconstruído depois de um reinício fica marcado recomputed from the hour records: é a soma dos registos que sobreviveram, e o hub di-lo em vez de suavizar a falha.

Um ponto não tem histórico nenhum, apenas valores em tempo real

• O hub mantém histórico para 12 pontos no total, os seus e os dos seus nós em conjunto. Um ponto além desse número mostra apenas valores em tempo real. → Points

O History abre num ponto de um nó, e não encontro a entrada

• Num hub com nós remotos, o firmware v1.1.8 ordena os chips de pontos por chave, o que coloca os pontos dos nós à frente da entrada — por isso o History abre num nó, e com muitos pontos a entrada pode ficar fora dos seis que pode escolher. Retire um chip que não precise para lhe abrir espaço. Corrigido numa versão posterior da aplicação web; os registos em si não são afetados, apenas o ponto em que a página abre. → Remote nodes

A energia aparece numa só fase

• Uma entrada trifásica medida por fase é lida como uma série somada a partir do firmware v1.1.6; na v1.1.5 as páginas leem apenas o ponto L1. Verifique o firmware antes de suspeitar das pinças. → Sensors and modules

O dinheiro é 0 enquanto a energia não é

• As zonas não têm preço de compra, ou o período caiu numa zona predefinida sem um. → Tariffs

O CSV tem menos linhas do que a tabela

• Um registo que está dentro de um registo mais longo do mesmo ponto fica de fora de propósito, para que a mesma energia não seja contada duas vezes.

Onde continuar

• How cost is calculated — porque é que um período custa o que custa, e o que significa um período assinalado para o dinheiro.
• Economics — os mesmos registos como totais, por zona e face à entrada.
• Events — o que o hub reportou na altura em que um registo parece estranho.