Eksport danych & API (pl)

Przegląd

Ten artykuł referencyjny opisuje wszystkie metryki dostępne przez eksport danych (CSV) i API. Metryki są podzielone na dwie kategorie:

Metryki uniwersalne — zwracane dla wszystkich urządzeń elektrycznych, w tym czujników prądu i liczników mocy.
Metryki liczników mocy — zwracane wyłącznie dla liczników mocy, zapewniając rozszerzone pomiary elektryczne.

Wskazówka: Jeśli kolumna pojawia się w eksporcie, ale wyświetla wartości NULL, sprawdź, czy urządzenie jest licznikiem mocy i czy odpowiedni typ pomiaru jest obsługiwany przez konfigurację sprzętową.

Metryki uniwersalne

Poniższe metryki są zwracane dla wszystkich urządzeń elektrycznych, zarówno w eksportach CSV, jak i w odpowiedziach API.

Nazwa kolumny	Opis
`external_id`	Unikalny identyfikator przypisany do wybranego zasobu. Używany do odwoływania się do urządzenia w zewnętrznych systemach i integracjach.
`asset_name`	Nazwa zasobu skonfigurowana na platformie.
`Customer`	Nazwa lokalizacji klienta, do której należy zasób.
`time_zone`	Strefa czasowa, w której znajduje się zasób. Zobacz tutaj, aby uzyskać pełną listę obsługiwanych identyfikatorów stref czasowych i ich opisów.
`measured_at`	Znacznik czasu pomiaru w czasie lokalnym (na podstawie skonfigurowanej strefy czasowej zasobu).
`utc_time`	Znacznik czasu pomiaru w Skoordynowanym Czasie Uniwersalnym (UTC).
`power`	Zmierzona moc czynna. To pole zawsze zawiera wartość — jeśli nie odebrano żadnego pomiaru z urządzenia, wartość domyślna wynosi 0. W przypadku czujników prądu jest to wartość obliczona na podstawie zmierzonego prądu, skonfigurowanego współczynnika mocy i skonfigurowanego napięcia. W przypadku liczników mocy wartość ta jest mierzona bezpośrednio przez urządzenie.
`energy`	Obliczona energia. Obliczana bezpośrednio z zmierzonej lub obliczonej wartości mocy w czasie.

Metryki liczników mocy

Poniższe metryki są zwracane tylko dla liczników mocy. Nie pojawią się w eksportach z czujników prądu. Niektóre pola mogą zawierać wartości NULL, jeśli określony typ pomiaru nie jest obsługiwany przez podłączony sprzęt.

Nazwa kolumny	Opis
`active_power_total`	Zmierzona moc czynna. Odpowiednik pola power, z tą różnicą, że pokazuje brakujące wartości (NULL), gdy nie odebrano żadnego pomiaru z urządzenia.
`apparent_power_total`	Zmierzona moc pozorna. Reprezentuje całkowitą moc przepływającą w obwodzie, obejmującą zarówno składowe czynne, jak i bierne.
`reactive_power_total`	Zmierzona moc bierna. Reprezentuje część mocy, która nie wykonuje użytecznej pracy.
`current_l1`	Zmierzony prąd w fazie 1 (L1).
`current_l2`	Zmierzony prąd w fazie 2 (L2).
`current_l3`	Zmierzony prąd w fazie 3 (L3).
`current_n`	Zmierzony prąd przewodu neutralnego.
`current_total`	Równoważny trójfazowy prąd liniowy. Obliczany jako: apparent_power_total ÷ (√3 × voltage_ll_average).
`power_factor_total`	Zmierzony współczynnik mocy (zakres od -1 do 1). Reprezentuje stosunek mocy czynnej do mocy pozornej. Wartość 1 lub -1 oznacza obciążenie czysto rezystancyjne; wartości bliższe 0 wskazują na mniejszy udział mocy biernej.
`voltage_average`	Średnie napięcie fazowe (linia-neutralny) we wszystkich fazach.
`voltage_l1_l2`	Zmierzone napięcie międzyfazowe między fazą 1 (L1) a fazą 2 (L2).
`voltage_l1_n`	Zmierzone napięcie fazowe (linia-neutralny) w fazie 1 (L1).
`voltage_l2_l3`	Zmierzone napięcie międzyfazowe między fazą 2 (L2) a fazą 3 (L3).
`voltage_l2_n`	Zmierzone napięcie fazowe (linia-neutralny) w fazie 2 (L2).
`voltage_l3_l1`	Zmierzone napięcie międzyfazowe między fazą 3 (L3) a fazą 1 (L1).
`voltage_l3_n`	Zmierzone napięcie fazowe (linia-neutralny) w fazie 3 (L3).
`voltage_ll_average`	Średnie napięcie międzyfazowe we wszystkich parach faz.

Dodatkowe uwagi

Wartości NULL a wartości zerowe

Istnieje ważna różnica między polami power i active_power_total:

power zawsze zawiera wartość liczbową. Brakujące pomiary są reprezentowane jako 0.
active_power_total może zawierać NULL, gdy nie odebrano żadnego pomiaru, co pozwala odróżnić rzeczywisty odczyt zerowy od brakującego punktu danych.

Czujniki prądu vs. liczniki mocy

Niektóre metryki są obliczane różnie w zależności od typu urządzenia:

Czujniki prądu obliczają moc pośrednio na podstawie zmierzonego prądu w połączeniu ze skonfigurowanym napięciem i współczynnikiem mocy.
Liczniki mocy mierzą moc czynną bezpośrednio i dostarczają bogatszy zestaw pomiarów elektrycznych, w tym napięcia i prądy fazowe oraz współczynnik mocy.

Obliczanie energii

Pole energy jest wyprowadzane z pola power metodą całkowania czasowego. Odzwierciedla skumulowane zużycie energii w interwale pomiarowym.