MergenHub Envest عرض مباشر
التكامل · Grafana

Grafana — بيانات المنشأة في لوحاتك

يُرسم السجل المحفوظ والقيم الحية في Grafana دون إعداد قاعدة بيانات منفصلة. يقرأ مصدر البيانات Infinity في Grafana عناوين JSON في MergenHub بمفتاح وصول للقراءة فقط.

يعمل معGrafanaGrafana

كيف يعمل؟

يقدّم MergenHub ثلاثة عناوين JSON: /config/v1/analytics/tags (الوسوم المسجّلة)، و…/current (القيم الحية)، و…/history (السجل بالصيغة الطويلة: الوسم، الوقت، القيمة). تُستخدم متغيّرات Grafana ${__from} و${__to} مباشرةً؛ ويتبع الاستعلام النطاق الزمني للوحة.

الحدود والأمان

حتى 50 وسمًا في الطلب وحتى 10,000 نقطة لكل وسم (تُخفَّف النطاقات الطويلة). يقرأ المفتاح فقط، وتنتهي صلاحيته، ويتوقف عن العمل لحظة حذفه، ولا يتجاوز صلاحيات مالكه. عندما يكون HTTPS معطّلًا يعمل من الشبكة المحلية فقط.

خطوة بخطوة

لوحة Grafana بأربع خطوات

  1. 01

    أنشئ مفتاح وصول

    في الصفحة الرئيسية لـ الإعدادات › Data Bridge اضغط فتح في بطاقة Grafana؛ سمِّ المفتاح واختر مدة الصلاحية ثم اضغط إنشاء مفتاح. انسخه فورًا: لن يُعرض مرة أخرى.

  2. 02

    أضف مصدر البيانات Infinity

    ثبّت إضافة Infinity في Grafana وأضفها مصدرَ بيانات. Authentication = Bearer Token ← الصق المفتاح؛ Allowed hosts = عنوان MergenHub (مثال http://10.0.0.5:8090).

  3. 03

    اكتب الاستعلام

    في اللوحة Type = JSON وSource = URL: /config/v1/analytics/history?tags=TAG1,TAG2&from=${__from}&to=${__to}&maxPoints=${__maxDataPoints}

  4. 04

    اربط الأعمدة

    time ← Timestamp، value ← Number، tag ← String. يصبح لكل وسم خط خاص به. ويختبر أمر التجربة في صفحة Grafana الاتصال مسبقًا.

التكامل

العناوين

GET

قائمة الوسوم

…/analytics/tags: الوسوم ذات السجل المحفوظ ومجموعاتها؛ و?live=true لكل الوسوم الحية.

GET

القيمة الحية

…/analytics/current?tags=A,B: القيمة والجودة والوقت.

GET

السجل

…/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: يُستخدم المفتاح لعنوان آخر أو لا يملك مالكه الصلاحية.