Tüm bir yıllık ham değerleri okumak yavaş olur ve bir grafiğe sığmaz. Bu nedenle Hermetry sayısal okumaları dakika, saat ve gün bazında özetler ve istediğiniz zaman aralığına uyan özeti okur. Bu sayfa özetleri, çözünürlüğün nasıl seçildiğini ve her toplama fonksiyonunun ne döndürdüğünü açıklar.
Özetler
Her cihazın her sayısal anahtarı için depo, her kova başına beş değer tutar:
| Değer | Anlamı |
|---|---|
| sum | Kovadaki değerlerin toplamı |
| count | Kovaya kaç değer geldi |
| min | En küçük değer |
| max | En büyük değer |
| last | Kovadaki en son zaman damgasına sahip değer |
| Seviye | Kova | Saklama süresi |
|---|---|---|
| 1 dakikalık toplamalar | 1 dakika | Saklama sınıfınız, en fazla 31 gün |
| Saatlik özetler | 1 saat | Tüm saklama sınıfınız |
| Günlük özetler | 1 gün, UTC’ye göre gece yarısından gece yarısına | Tüm saklama sınıfınız |
Tüm kovalar UTC’ye hizalanır. Dakika özetlerini her dakika çalışan bir iş hesaplar; saat ve gün özetleri bunlardan türetilir. Dakikası özetlendikten sonra gelen bir okuma o dakikayı yeniden işaretler, bu nedenle geç gelen okumalar da dahil edilir. Yeni kaydedilen bir okumanın özetlerde görünmesi bir iki dakika sürebilir; ham okumalar (24 saate kadar olan aralıklar) ise onu hemen görür.
Metin, true/false ve JSON değerleri özetlenmez. Bkz. Sayılar, metin ve doğru/yanlış değerleri.
Bir aralığın hangi çözünürlüğü okuduğu
Kova auto (grafikler ve API için varsayılan) seçiliyken:
| Aralık uzunluğu | Çözünürlük |
|---|---|
| 24 saate kadar | Ham değerler, her okuma |
| 10.000 dakikaya kadar (yaklaşık 6,9 gün; bu nedenle tam 7 günlük bir aralık zaten saatlik değerleri okur) | 1 dakika |
| 10.000 saate kadar (yaklaşık 416 gün) | 1 saat |
| Daha uzun | 1 gün |
Bir aralık, seçilen çözünürlükte en fazla 10.000 kova içerebilir. Sabit bir çözünürlük istediğinizde bu sayıdan fazla kova gerekirse (örneğin 30 gün boyunca 1m), API 400 yanıtı verir ve range_too_large kodunu döndürür. Daha kaba bir kova veya daha kısa bir aralık isteyin.
Bir seviyenin tutulduğu süreden daha geriye giden bir aralık, eksik kısım için hiçbir şey döndürmez. Örneğin 365 günlük sınıfta, 31 günden eski 1m kovaları yoktur; bunun yerine 1h isteyin.
Toplama fonksiyonları
Her kova, beş değerinden hesaplanan tek bir değer döndürür:
| Fonksiyon | Kova başına değer | Kullanım alanı |
|---|---|---|
avg (varsayılan) | sum / count | Sıcaklıklar, seviyeler, basınçlar |
min | En küçük değer | En düşük seviye, en soğuk nokta |
max | En büyük değer | Zirveler, 0/1 anahtarlar için “oldu mu” |
last | Son değer | Sayaç okumaları, durumlar, ayar noktaları |
sum | Değerlerin toplamı | Zaten aralık başına tutar olan değerler (bu aralıktaki litreler, olay sayısı olarak 1) |
count | Okuma sayısı | Raporlama oranı, veri tamlığı |
increase | Bir sayacın ne kadar arttığı | Enerji ve su sayaçları, darbe toplamları |
avg, kovadaki okumaların zamana göre ağırlıklandırılmamış düz ortalamasıdır. Bazı dönemlerde daha sık rapor veren bir cihaz o dönemlere daha fazla ağırlık verir.
Ham bir aralık okunduğunda (24 saate kadar), toplama uygulanmaz: depolanan her değeri alırsınız. Ham noktaları ve özeti yan yana gösteren grafikler, bu nedenle son bir gün için eski günlerden daha fazla ayrıntı gösterebilir.
Sayaçlar için increase
Sayaçlar yalnızca sıfırdan yeniden başlayana kadar artar (kWh, m³, darbe). increase, bunları kova başına tüketime çevirir:
- Her kovanın değeri, kendi
lastdeğerinden önceki kovanınlastdeğerinin çıkarılmasıyla bulunur. - Değer düştüyse (sayaç yeniden başladıysa), kovanın
lastdeğeri sıfırdan sayılarak artış kabul edilir. - Aralığın ilk kovası, içinde yükselen miktarı sayar: kendi
lastdeğerindenmindeğerinin çıkarılması.
Bir enerji sayacının saatlik kovalarıyla örnek:
| Saat | last | increase |
|---|---|---|
| 08:00 | 1,200.0 | 4,0 (ilk kova: last 1.200,0 – min 1.196,0) |
| 09:00 | 1,212.5 | 12.5 |
| 10:00 | 1,221.0 | 8.5 |
| 11:00 | 3.0 | 3,0 (sayaç yeniden başladı) |
Notlar:
- Bir boşluk boyunca olan artış, boşluktan sonraki ilk kovada sayılır.
- Yeniden başlayan ve bir kova içinde eski değerinin üzerine çıkan bir sayaç, yeniden başlatma olarak görülmez.
increaseişlevini ham sayaç üzerinde kullanın; zaten aralık başına tutar olan bir anahtarda asla kullanmayın; bunun içinsumkullanın.
Özetlerin kullanılması
| Yer | Nasıl seçersiniz |
|---|---|
| Pano grafik kartları | Kartın Toplama ayarı ve panonun zaman aralığı. Bkz. Grafik kartları ve Veri kaynakları ve parametreler. |
| Cihazın Telemetri sekmesi | Her zaman avg, seçtiğiniz aralıkla. Bkz. Cihazın Telemetri sekmesi. |
| API | GET /api/telemetry/series üzerinde bucket ve agg. Bkz. Geçmiş API’si. |
| Akışlar | Statistics bloğu, istatistikleri akışın içinde bir mesaj aralığı üzerinden hesaplar. Bkz. Sayaçlar, istatistikler ve bekçi zamanlayıcıları. |
Yerel günler ve aylar
Günlük özetler UTC günleridir. Başka bir saat diliminde günlük toplam için 1h kovalarını okuyun ve her yerel günün saatlerini kendiniz toplayın; yarım saat ofsetli bölgeler için 1m kovalarını okuyun (31 güne kadar geriye). Örnek için bkz. Geçmiş API’si.