MergenHub Envest

السجلات وبيانات التشخيص

كل سجل يكتبه MergenHub: سجلات الملفات وسجل الأحداث وسجل التدقيق وقاعدة بيانات الأرشيف وسجل المثبّت؛ مدة الاحتفاظ والمواقع.

يحتفظ 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دورة حياة الخدمة والانهيارات غير المعالَجةسياسة Windowseventvwr.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.import
  • tag.write من OPC UA أو REST مع القيمة القديمة والجديدة
  • user.login وuser.login_failed وuser.password_change
  • license.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
أيام سجل الملفاتدوّار، تلقائي
الإعدادات › الاحتفاظ — مدة الاحتفاظ بالأحداث والتدقيق وسجل الإنذارات
الإعدادات › الاحتفاظ — مدة الاحتفاظ بالأحداث والتدقيق وسجل الإنذارات

إرسال السجلات إلى الدعم

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