يحتفظ MergenHub بعدة أنواع من السجلات، لكل منها غرضه وموقعه ومدة احتفاظه. وجميعها موجودة ضمن مجلد البيانات C:\ProgramData\MergenHub.
نظرة عامة
| السجل | الموقع | محتواه | مدة الاحتفاظ | أين يُعرض |
|---|---|---|---|---|
| سجل ملفات التطبيق | logs\mergenhub-YYYYMMDD.log | كل ما تسجّله عملية النواة: البدء واتصالات المشغّلات والأخطاء وتتبعات المكدس وطلبات API | ملف لكل يوم؛ تُنظَّف الملفات القديمة تلقائيًا | أي محرر نصوص؛ يُرفق بطلبات الدعم |
| سجل الأحداث | events.db (SQLite) | أحداث موجّهة للمشغّل: اتصال الجهاز/فقده، مهلات الانتظار، بدء/إيقاف الخدمات، جلسات OPC UA، الإنذارات المُطلقة | 7 أيام افتراضيًا (الإعدادات › الاحتفاظ) | … › سجل الأحداث في واجهة الويب، مع تصفية وبحث وتصدير إلى نص |
| سجل التدقيق | audit.db | من غيّر ماذا: كل كتابة إعدادات (POST/PUT/DELETE) وكتابات OPC UA وREST في الوسوم وعمليات تسجيل الدخول واستدعاءات أدوات MCP وإجراءات الترخيص | 90 يومًا افتراضيًا | الإعدادات › التدقيق (شرائح تصفية حسب الفئة والمستخدم والوقت) |
| سجل الإنذارات | داخل مخزن المشروع | كل انتقال لإنذار: أُطلق، أُقِرّ، زال، ومن فعل ذلك | 90 يومًا افتراضيًا | الإنذارات › السجل |
| أرشيف البيانات (Historian) | logs.db (SQLite) أو قاعدة بيانات ODBC الخاصة بك | قيم الوسوم التي سجّلتها مجموعات التسجيل | حتى تحذفها أو تخفّض دقتها | Historian › الاتجاه وتصدير CSV/Excel وOPC UA HistoryRead |
| تشخيص الأجهزة | في الذاكرة | إطارات الطلب/الاستجابة الخام (hex) لكل جهاز وآخر خطأ والتوقيت | مخزن دوّار | الجهاز › التشخيص؛ تصدير تتبع بأسلوب Wireshark |
| سجل المثبّت | %TEMP%\MergenHub-Setup.log | كل خطوة من خطوات المثبّت وأوامر الخدمات وجدار الحماية | حتى تحذفه | محرر نصوص |
| عارض أحداث Windows | سجل Application، المصدر MergenHub | دورة حياة الخدمة والانهيارات غير المعالَجة | سياسة Windows | eventvwr.msc |

سجل ملفات التطبيق
تكتب النواة سجلًا نصيًا دوّارًا في C:\ProgramData\MergenHub\logs\. يحتوي كل سطر على الطابع الزمني والمستوى (INF وWRN وERR) والمكوّن المصدر والرسالة. إدخالات نموذجية:
2026-09-05 10:14:02.117 INF Web API listening on http://0.0.0.0:8090
2026-09-05 10:14:03.402 INF OPC UA server started: opc.tcp://0.0.0.0:48010/MergenHub
2026-09-05 10:14:05.930 INF ChannelWorker Connected: Pumping_Station.PLC_1
2026-09-05 10:20:41.008 WRN ModbusTcp Read timeout 10.0.0.5:502 unit 1 (block 40001..40064), retry 1/3
2026-09-05 10:20:44.012 ERR ChannelWorker Device Pumping_Station.PLC_1 marked Bad: 3 consecutive failures
يتحكم الإعدادات › الاحتفاظ في عدد الأيام المحفوظة. في حالات الدعم أرسل ملف اليوم الذي حدثت فيه المشكلة.
سجل الأحداث
الأحداث هي ما يحتاج المشغّل إلى رؤيته دون قراءة ملفات السجل: تغيّر حالات الاتصال ومهلات الانتظار وإعادة تشغيل الخدمات وجلسات عملاء OPC UA وإعادة تحميل الإعدادات ورسائل الترخيص/الوضع التجريبي. افتحه من القائمة … في أعلى اليمين › سجل الأحداث.
- تصفية الكل / تحذير / خطأ، وبحث نصي حر، وإيقاف التحديث التلقائي مؤقتًا.
- تصدير إلى نص يحفظ العرض الحالي.
- تقرير التطبيق ينشئ ملفًا نصيًا واحدًا بالإصدار وملخص الإعدادات وسلامة القنوات/الأجهزة وآخر الأحداث — وهو أسرع ما يمكن إرفاقه بتذكرة دعم.
- تُحفظ الأحداث في
events.dbللعدد المضبوط من الأيام (الافتراضي 7) وتبقى بعد إعادة التشغيل.
سجل التدقيق
يُسجَّل كل تغيير يتم عبر واجهة الويب أو REST API أو كتابات OPC UA أو أداة MCP مع المستخدم وعنوان IP والوقت والإجراء والهدف. افتح الإعدادات › التدقيق. أمثلة على ما ستجده:
channel.createوdevice.updateوtag.deleteوproject.importtag.writeمن OPC UA أو REST مع القيمة القديمة والجديدةuser.loginوuser.login_failedوuser.password_changelicense.activateوlicense.releaseوsettings.update
مدة الاحتفاظ 90 يومًا افتراضيًا (الإعدادات › الاحتفاظ). لا يمكن تعديل سجلات التدقيق من واجهة المستخدم أبدًا.

سجل الإنذارات
يُحتفظ بكل انتقال لإنذار (أُطلق، أُقِرّ، زال) مع الطابع الزمني والقيمة والمستخدم والتعليق طوال مدة الاحتفاظ بسجل الإنذارات (الافتراضي 90 يومًا) ويُعرض في الإنذارات › السجل. كما يتوفر لعملاء الإنذارات والشروط في OPC UA.
بيانات أرشيف البيانات
تكتب مجموعات التسجيل في logs.db (SQLite) افتراضيًا أو في أي قاعدة بيانات ODBC (SQL Server وMySQL/MariaDB وPostgreSQL وOracle). عندما تتعذّر الوجهة، تُخزَّن السجلات مؤقتًا على القرص (التخزين والإعادة) وتُكتب لاحقًا. الاتجاهات وخفض الدقة وتصدير CSV/Excel/PNG موجودة في وحدة Historian؛ راجع أرشيف البيانات.
تشخيص الأجهزة وتتبع الحزم
اختر جهازًا وافتح التشخيص: آخر إطارات الطلب/الاستجابة بصيغة hex وأعداد البايتات والتوقيت ونص آخر خطأ. بالنسبة للبروتوكولات القائمة على الذاكرة المؤقتة (DNP3 وIEC 104 وIEC 61850) يعرض مسار TX/RX الخام حركة الارتباط الفعلية. يمكن حفظ التتبع للتحليل. راجع استكشاف الأخطاء وإصلاحها.
إعدادات الاحتفاظ
الإعدادات › الاحتفاظ:
| الإعداد | الافتراضي |
|---|---|
| أيام سجل الأحداث | 7 |
| أيام سجل التدقيق | 90 |
| أيام سجل الإنذارات | 90 |
| أيام سجل الملفات | دوّار، تلقائي |

إرسال السجلات إلى الدعم
- … › سجل الأحداث › تقرير التطبيق — احفظ الملف.
- أضف ملف اليوم
logs\mergenhub-YYYYMMDD.log. - في حال مشكلة جهاز أضف تتبع التشخيص لذلك الجهاز.
- أرسلها عبر بوابة العملاء (الدعم) أو بالبريد الإلكتروني.
MergenHub