Grafana — بيانات المنشأة في لوحاتك
يُرسم السجل المحفوظ والقيم الحية في Grafana دون إعداد قاعدة بيانات منفصلة. يقرأ مصدر البيانات Infinity في Grafana عناوين JSON في MergenHub بمفتاح وصول للقراءة فقط.
كيف يعمل؟
يقدّم MergenHub ثلاثة عناوين JSON: /config/v1/analytics/tags (الوسوم المسجّلة)، و…/current (القيم الحية)، و…/history (السجل بالصيغة الطويلة: الوسم، الوقت، القيمة). تُستخدم متغيّرات Grafana ${__from} و${__to} مباشرةً؛ ويتبع الاستعلام النطاق الزمني للوحة.
الحدود والأمان
حتى 50 وسمًا في الطلب وحتى 10,000 نقطة لكل وسم (تُخفَّف النطاقات الطويلة). يقرأ المفتاح فقط، وتنتهي صلاحيته، ويتوقف عن العمل لحظة حذفه، ولا يتجاوز صلاحيات مالكه. عندما يكون HTTPS معطّلًا يعمل من الشبكة المحلية فقط.
لوحة Grafana بأربع خطوات
- 01
أنشئ مفتاح وصول
في الصفحة الرئيسية لـ الإعدادات › Data Bridge اضغط فتح في بطاقة Grafana؛ سمِّ المفتاح واختر مدة الصلاحية ثم اضغط إنشاء مفتاح. انسخه فورًا: لن يُعرض مرة أخرى.
- 02
أضف مصدر البيانات Infinity
ثبّت إضافة Infinity في Grafana وأضفها مصدرَ بيانات. Authentication = Bearer Token ← الصق المفتاح؛ Allowed hosts = عنوان MergenHub (مثال
http://10.0.0.5:8090). - 03
اكتب الاستعلام
في اللوحة Type = JSON وSource = URL:
/config/v1/analytics/history?tags=TAG1,TAG2&from=${__from}&to=${__to}&maxPoints=${__maxDataPoints} - 04
اربط الأعمدة
time ← Timestamp، value ← Number، tag ← String. يصبح لكل وسم خط خاص به. ويختبر أمر التجربة في صفحة Grafana الاتصال مسبقًا.
العناوين
قائمة الوسوم
…/analytics/tags: الوسوم ذات السجل المحفوظ ومجموعاتها؛ و?live=true لكل الوسوم الحية.
القيمة الحية
…/analytics/current?tags=A,B: القيمة والجودة والوقت.
السجل
…/analytics/history?tags=A,B&from=&to=&maxPoints=: كل صف الوسم، الوقت، القيمة.
صيغة مرنة
unix ms أو ثواني unix أو ISO 8601 أو نسبي (now، now-6h، now-7d). آخر 24 ساعة إذا لم يُحدَّد.
مسجّل البيانات
يُقرأ السجل من مجموعات السجل في تسجيل البيانات، أيًّا كان المخزن الذي تكتب فيه: SQLite أو SQL Server أو MySQL أو PostgreSQL أو ODBC.
نتيجة فارغة أو 403
نتيجة فارغة: الوسم ليس في مجموعة سجل أو لا توجد بيانات في النطاق. 403: يُستخدم المفتاح لعنوان آخر أو لا يملك مالكه الصلاحية.
MergenHub