Grafana — tesis verisi panolarınızda
Veri Kaydı'ndaki geçmiş ve anlık değerler, ayrı bir veritabanı kurmadan Grafana'da çizilir. Grafana'nın Infinity veri kaynağı MergenHub'ın JSON adreslerini salt okunur bir erişim anahtarıyla okur.
Nasıl çalışır?
MergenHub üç JSON adresi sunar: /config/v1/analytics/tags (kayıtlı tag'ler), …/current (anlık değer) ve …/history (geçmiş, uzun biçim: tag, zaman, değer). Grafana'nın ${__from} ve ${__to} değişkenleri doğrudan kullanılır; panodaki zaman aralığı değişince sorgu da değişir.
Sınırlar ve güvenlik
Tek istekte en çok 50 tag, tag başına en çok 10.000 nokta (uzun aralıklar seyreltilir). Anahtar yalnız okur, süresi dolar, silinince anında geçersiz olur ve sahibinin yetkisini aşamaz. HTTPS kapalıyken yalnız yerel ağdan çalışır.
Dört adımda Grafana panosu
- 01
Erişim anahtarı oluşturun
Ayarlar › Data Bridge ana sayfasında Grafana kartında Aç; anahtara ad ve geçerlilik süresi verip Anahtar oluştur. Anahtarı hemen kopyalayın: bir daha gösterilmez.
- 02
Infinity veri kaynağını ekleyin
Grafana'da Infinity eklentisini kurup veri kaynağı olarak ekleyin. Authentication = Bearer Token → anahtarı yapıştırın; Allowed hosts = MergenHub adresi (ör.
http://10.0.0.5:8090). - 03
Sorguyu yazın
Panelde Type = JSON, Source = URL:
/config/v1/analytics/history?tags=TAG1,TAG2&from=${__from}&to=${__to}&maxPoints=${__maxDataPoints} - 04
Sütunları eşleyin
time → Timestamp, value → Number, tag → String. Her tag ayrı bir çizgi olur. Grafana sayfasındaki deneme komutu bağlantıyı önceden sınar.
Adresler
Tag listesi
…/analytics/tags: geçmişi kayıtlı tag'ler ve grupları; ?live=true ile bütün canlı tag'ler.
Anlık değer
…/analytics/current?tags=A,B: değer, kalite ve zaman.
Geçmiş
…/analytics/history?tags=A,B&from=&to=&maxPoints=: her satır tag, zaman, değer.
Esnek biçim
Unix ms, unix saniye, ISO 8601 ya da göreli (now, now-6h, now-7d). Verilmezse son 24 saat.
Veri Kaydı
Geçmiş, Veri Kaydı'nın log gruplarından okunur: SQLite, SQL Server, MySQL, PostgreSQL ya da ODBC hangisine yazılıyorsa.
Boş sonuç ya da 403
Boş sonuç: tag bir log grubunda değil ya da aralıkta veri yok. 403: anahtar başka adres için kullanılıyor ya da sahibinin yetkisi yok.
MergenHub