Esportazione dati & API (CSV and API) (it)

Panoramica

Questo articolo di riferimento descrive tutte le metriche disponibili tramite l'esportazione dati (CSV) e l'API. Le metriche sono suddivise in due categorie:

Metriche universali — restituite per tutti i dispositivi elettrici, compresi i sensori di corrente e i misuratori di potenza.
Metriche dei misuratori di potenza — restituite esclusivamente per i dispositivi misuratori di potenza, fornendo misurazioni elettriche estese.

Suggerimento: Se una colonna appare nell'esportazione ma mostra valori NULL, verificare che il dispositivo sia un misuratore di potenza e che il tipo di misurazione pertinente sia supportato dalla configurazione hardware.

Metriche universali

Le seguenti metriche vengono restituite per tutti i dispositivi elettrici, sia nelle esportazioni CSV sia nelle risposte API.

Nome colonna	Descrizione
`external_id`	Un identificatore univoco assegnato all'asset selezionato. Utilizzato per fare riferimento al dispositivo in sistemi esterni e integrazioni.
`asset_name`	Il nome dell'asset così come configurato nella piattaforma.
`Customer`	Il nome del sito cliente a cui appartiene l'asset.
`time_zone`	Il fuso orario in cui si trova l'asset. Vedere qui per un elenco completo degli identificatori di fuso orario supportati e delle relative descrizioni.
`measured_at`	Il timestamp della misurazione in ora locale (basato sul fuso orario configurato dell'asset).
`utc_time`	Il timestamp della misurazione in Tempo Coordinato Universale (UTC).
`power`	Potenza attiva misurata. Questo campo contiene sempre un valore — se nessuna misurazione è stata ricevuta dal dispositivo, viene impostato su 0. Per i sensori di corrente, si tratta di un valore calcolato derivato dalla corrente misurata, dal fattore di potenza configurato e dalla tensione configurata. Per i misuratori di potenza, questo valore viene misurato direttamente dal dispositivo.
`energy`	Energia calcolata. Derivata direttamente dal valore di potenza misurato o calcolato nel tempo.

Metriche dei misuratori di potenza

Le seguenti metriche vengono restituite solo per i dispositivi misuratori di potenza. Non compariranno nelle esportazioni di dispositivi con sensori di corrente. Alcuni campi possono contenere valori NULL se un tipo di misurazione specifico non è supportato dall'hardware collegato.

Nome colonna	Descrizione
`active_power_total`	Potenza attiva misurata. Equivalente al campo power, tranne per il fatto che mostra i valori mancanti (NULL) quando non è stata ricevuta alcuna misurazione dal dispositivo.
`apparent_power_total`	Potenza apparente misurata. Rappresenta la potenza totale che scorre nel circuito, incluse le componenti attiva e reattiva.
`reactive_power_total`	Potenza reattiva misurata. Rappresenta la quota di potenza che non compie lavoro utile.
`current_l1`	Corrente misurata sulla fase 1 (L1).
`current_l2`	Corrente misurata sulla fase 2 (L2).
`current_l3`	Corrente misurata sulla fase 3 (L3).
`current_n`	Corrente del neutro misurata.
`current_total`	La corrente di linea trifase equivalente. Calcolata come: apparent_power_total ÷ (√3 × voltage_ll_average).
`power_factor_total`	Fattore di potenza misurato (intervallo da -1 a 1). Rappresenta il rapporto tra potenza attiva e potenza apparente. Un valore di 1 o -1 indica un carico puramente resistivo; valori più vicini a 0 indicano una minore proporzione di potenza reattiva.
`voltage_average`	Tensione media linea-neutro su tutte le fasi.
`voltage_l1_l2`	Tensione linea-linea misurata tra fase 1 (L1) e fase 2 (L2).
`voltage_l1_n`	Tensione linea-neutro misurata sulla fase 1 (L1).
`voltage_l2_l3`	Tensione linea-linea misurata tra fase 2 (L2) e fase 3 (L3).
`voltage_l2_n`	Tensione linea-neutro misurata sulla fase 2 (L2).
`voltage_l3_l1`	Tensione linea-linea misurata tra fase 3 (L3) e fase 1 (L1).
`voltage_l3_n`	Tensione linea-neutro misurata sulla fase 3 (L3).
`voltage_ll_average`	Tensione media linea-linea su tutte le coppie di fase.

Note aggiuntive

Valori NULL vs. zero

Esiste una distinzione importante tra i campi power e active_power_total:

power contiene sempre un valore numerico. Le misurazioni mancanti sono rappresentate come 0.
active_power_total può contenere NULL quando non è stata ricevuta alcuna misurazione, consentendo di distinguere tra una lettura zero genuina e un punto dati mancante.

Sensori di corrente vs. misuratori di potenza

Alcune metriche vengono calcolate in modo diverso a seconda del tipo di dispositivo:

Sensori di corrente calcolano la potenza indirettamente utilizzando la corrente misurata combinata con la tensione e il fattore di potenza configurati.
Misuratori di potenza misurano la potenza attiva direttamente e forniscono un insieme più ricco di misurazioni elettriche, tra cui tensioni e correnti per fase e fattore di potenza.

Calcolo dell'energia

Il campo energy è derivato dal campo power tramite integrazione temporale. Riflette il consumo energetico cumulativo nell'intervallo di misurazione.