التعامل مع سجلات ArcGIS Notebook Server

يسجل ArcGIS Notebook Server كل الأحداث التي تحدث في الموقع، وأي أخطاء مرتبطة بهذه الأحداث، باستخدام السجلات. وتكون هذه السجلات متوفرة لمسؤولي الموقع.

تُعد السجلات أداة هامة لمراقبة المشكلات واستكشاف الأخطاء وإصلاحها في موقع ArcGIS Notebook Server. يمكن أن تساعدك المعلومات التي توفرها السجلات في تعريف الأخطاء وتوفير سياق عن كيفية معالجة المشاكل وحل أخطاء. تعمل السجلات أيضًا كنظام سجل للأحداث التي تحدث في موقعك.

على سبيل المثال، يتم تسجيل أنواع الأحداث التالية في السجلات:

• أحداث التثبيت والترقية، مثل تخويل البرنامج وإنشاء الموقع
• فتح ArcGIS Notebooks وإغلاقه
• مهام التنظيف التي يقوم بها الموقع
• أحداث إدارة الموقع التي يقوم بها المسؤولون، مثل إضافة أوقات تشغيل دفتر الملاحظات أو إزالتها، أو إنشاء دلائل الخادم، أو تكوين إعدادات الأمان
• أحداث الأمان، مثل تسجيل دخول المستخدمين إلى الموقع أو استيراد شهادات SSL وتصديرها

لم يتم تسجيل بعض الأحداث في سجلات ArcGIS Notebook Server. وهذا يشمل توحيد الموقع مع البوابة الإلكترونية. لا يتم تسجيل الأحداث التي تحدث داخل ArcGIS Notebooks، وإضافة المحتوى وتشغيل الخلايا وما إلى ذلك. وكذلك الأحداث التي تحدث داخل حاويات Dockerالخاصة بالجهاز؛ لعرض السجلات الخاصة بالحاوية، راجع عرض سجلات حاوية Docker أدناه.

مستويات السجلات المتوفرة

يحمل كل سجل مستوى تسجيل تفصيلي، والذي يمكن أن يكون واحدًا مما يلي، بالترتيب من الأقل تفصيلاً إلى الأكثر تفصيلاً:

• خطورة شديدة—مشكلات خطيرة تتطلب انتباهًا فوريًا.
• تحذير—مشكلات متوسطة تتطلب الانتباه.
• معلومات—الرسائل الإدارية الشائعة لموقع Notebook Server، بما في ذلك الرسائل المتعلقة بإنشاء الخدمة وبدء التشغيل.
• تفصيلية—الرسائل الشائعة من استخدام الخادم، مثل أسماء طلبات التشغيل المُستلمة.
• مطولة—رسائل توفر المزيد من التفاصيل عن كيفية قيام الخادم بتنفيذ العمليات.
• استكشاف المشكلات وإصلاحها—الرسائل المطولة للغاية المُصممة للمطورين وفنيي الدعم الراغبين في التعرف بشكل أفضل على حالة الخادم عند استكشاف المشكلة وإصلاحها. غير موصى به للاستخدام في أنظمة الإنتاج بسبب كمية السجلات التي يتم إنشاؤها.

في دليل مسؤول ArcGIS Notebook Server، يمكنك تحديد مستوى السجل الأكثر تفصيلاً المراد إنشاؤه. على سبيل المثال، إذا قمت بتعيين المستوى إلى صغيرة، فسيسجل موقع الخادم الرسائل على مستويات التفصيل خطورة شديدة، وتحذير، ومعلومات، وصغيرة.

أكواد السجل

تتعلق نطاقات سجل الكود بأنواع معينة من الرسائل. يوضح الجدول التالي نطاقات أكواد السجل ونوع محتواها.

نطق كود السجل	محتوى الرسالة
1000-4999	إطار عمل ArcGIS Notebook Server الأساسي
5000-6999	Docker SDK وذات الصلة بالحاويات
7000-7200	مفكرات
7200-7299	أدوات Notebook Web
7300-7399	لقطة Notebook
7400-7499	تعليمات برمجية لكود Notebook

سجلات الاستعلام في المدير "Manager"

بدءًا من ArcGIS Notebook Server الإصدار 10.8، يتضمن Manager صفحة السجلات. في هذه الصفحة، يمكنك الاستعلام عن كل السجلات لموقع ArcGIS Notebook Server.

1. سجّل الدخول إلى بوابة ArcGIS Enterprise الإلكترونية كمسؤول وافتح ArcGIS Notebook Server Manager.
2. افتح صفحة السجلات
3. توجد معلمات عامل تصفية الاستعلام أعلى الصفحة. استخدم أي معلمات لتقييد البحث أو توسعته.

   • مستوى السّجل—الحد الأدنى لمستوى السجل المطلوب الاستعلام عنه (راجع القسم أعلاه). يرجع فقط السجلات ذات مستوى سجل قوي أو أكثر حدة من هذا المستوى. المستوى الافتراضي هو WARNING.
   • وقت السجل—المدة الزمنية للبحث عن السجلات. يمكنك تقييد استعلام ما على آخر 15 دقيقة أو آخر ست ساعات أو آخر 24 ساعة أو آخر أسبوع أو آخر 30 يومًا أو عرض كل السجلات منذ إنشاء الموقع.

     تلميح:

     استخدم دليل المسؤول للاستعلام عن السجلات إذا أردت تحديد وقت انتهاء مختلف عن الوقت الحالي، مثل السجلات بين ثلاثة أيام ويومين.

   • الجهاز—تقييد الاستعلام على السجلات من جهاز واحد من أجهزة ArcGIS Notebook Server أو عرض السجلات من كل الأجهزة.
   • معرّفات الطلب—معرّفات الطلب المفصولة بفواصل لواحدة أو أكثر من طلبات الخادم التي ترغب في استعراض سجلاتها. بعض رسائل السجل متعلقة بطلب محدد.
   • المستخدمون—اسم المستخدم لواحد أو أكثر من المستخدمين (مفصولين بفاصلة) الذين يتم الاستعلام عن سجلاتهم ذات الصلة. بعض رسائل السجلات ترتبط بإجراء مستخدم محدد.
   • رموز السجلات—رمز واحد أو أكثر من رموز السجلات المسندة إلى رسالة السجل. في حالة تركها فارغة، تظهر كل رموز السجلات.

4. انقر على بحث لإجراء الاستعلام. تظهر كل السجلات التي تتطابق مع معلمات الاستعلام في الجدول الناتج.

تغيير إعدادات السجل في Manager

يمكنك أيضًا استخدام ArcGIS Notebook Server Manager لتغيير سجلات الاستعلام لموقعك.

1. سجّل الدخول إلى بوابة ArcGIS Enterprise الإلكترونية كمسؤول وافتح ArcGIS Notebook Server Manager.
2. افتح صفحة الإعدادات وانقر على السجلات.
3. يمكنك تغيير الإعدادات التالية:

   • دليل السجل—موقع القرص لدليل السجلات. إذا كان لديك اجهزة متعددة في موقعك، تأكد أن هذا المسار هو مشاركة اتفاقية التسمية العالمية (UNC).
   • مستوى السجل—مستوى السجل الأكثر تفصيلاً الذي سيكتبه موقعك. في حال التعيين على FINE، على سبيل المثال، لا يحتفظ موقعك بالسجلات في مستويات VERBOSE أو DEBUG.
   • عدد أيام الاحتفاظ بالسجلات—عدد الأيام التي يتم بعد حذف رسائل السجلات. ضع في اعتبارك الذاكرة المتوفرة في مشغل دليل السجلات، علاوة على إعداد مستوى السجل الذي اخترته ومستوى النشاط على موقعك. على سبيل المثال، إذا غيّرت مستوى السجل ليبدأ الكتابة بمستوى أكثر تفصيلاً، فقد تحتاج إلى تقليل عدد أيام الاحتفاظ بالسجلات.

4. انقر على حفظ لتأكيد التغييرات.

الاستعلام عن سجلات الخادم باستخدام دليل المسؤول

استخدم دليل مسئول ArcGIS Notebook Server للاستعلام عن سجلات الخادم وعرضها وتكوينها وحذفها.

للوصول إلى السجلات، اتبع هذه الخطوات:

1. سجل الدخول إلى دليل المسؤول. تنسيق عنوان URL هو https://notebookserver.domain.com:11443/arcgis/admin أو https://notebookserver.domain.com/<webadaptorname>/admin.
2. انقر على استعلام عن > السجلات للاستعلام عن السجلات الحالية ومراجعتها. استخدم عناصر التحكم في عوامل التصفية على الصفحة لمساعدتك على تضييق الأحداث حسب الفئات مثل الفترة الزمنية أو مستوى التسجيل.
3. انقر على إعدادات > السجلات لإدارة إعدادات السجل، مثل مستوى التسجيل الافتراضي (على النحو الموضح أعلاه)، ومدة الاحتفاظ بالسجلات على القرص، والموقع الذي تتم كتابة السجلات فيه.
4. انقر على تنظيف السجلات لحذف جميع ملفات السجل الخاصة بك من موقع ArcGIS Notebook Server.

عرض سجلات حاوية Docker باستخدام مدير ArcGIS Notebook Server

يمكنك عرض السجلات الخاصة بحاويات Docker الخاصة بموقعك باستخدام ArcGIS Notebook Server.

1. سجّل الدخول إلى مدير بوابة ArcGIS Notebook Server الإلكترونية كمسؤول. تنسيق عنوان URL هو https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html.
2. استعرض علامة تبويب الحاويات.
3. انقر فوق زر عرض السجلات لعرض سجلات الحاوية للجهاز المختار.

عرض سجلات حاوية Docker باستخدام سطر أوامر Docker

يمكنك عرض السجلات الخاصة بحاويات Docker الخاصة بموقعك باستخدام واجهة سطر أوامر Docker كما يلي.

1. سجل الدخول إلى دليل المسؤول. تنسيق عنوان URL هو https://notebookserver.domain.com:11443/arcgis/admin أو https://notebookserver.domain.com/<webadaptorname>/admin.
2. استعرض إلى حاويات > النظام. حدد موقع الحاوية التي تريد عرض سجلاتها، وانقر على معرّفها.
3. افتح طريقة عرض JSON الخاصة بصفحة معلومات الحاوية من خلال إضافة ?f=pjson إلى عنوان URL الخاص بها، بحيث يصبح تنسيق عنوان URL هو https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson.
4. حدد موقع containerId للحاوية وسجل قيمته.
5. افتح موجه الأوامر كمستخدم يمتلك امتيازات Docker.
6. شغّل الأمر docker logs <containerId> باستخدام القيمة التي سجلتها. سيؤدي ذلك إلى إرجاع سجلات Docker الخاصة بهذه الحاوية.