أفضل الممارسات المتعلّقة بالمراقبة

تنبيهات المراقبة

تسمح لك Apigee Edge بإعادة توجيه التنبيهات إلى سجلات النظام أو أنظمة/أدوات المراقبة الخارجية عند حدوث خطأ أو عطل بسبب تعذُّر تنفيذ حدث معيّن. يمكن أن تكون هذه التنبيهات على مستوى النظام أو على مستوى التطبيق. تكون التنبيهات على مستوى التطبيق في الغالب تنبيهات مخصّصة يتم إنشاؤها استنادًا إلى الأحداث التي يتم إنشاؤها. عادةً ما يضبط مشرف على الشبكة الشروط المخصّصة. لمزيد من المعلومات عن التنبيهات، يُرجى التواصل مع فريق دعم Apigee.

ضبط الحدود الدنيا للتنبيهات

يمكنك ضبط حد أدنى يتم بعده إنشاء تنبيه. يعتمد الحد الأدنى الذي تضبطه على إعدادات جهازك. يجب ضبط الحد الأدنى بما يتناسب مع سعتك. على سبيل المثال، قد يكون الحد الأدنى منخفضًا جدًا في Apigee Edge إذا كانت سعتك 6 غيغابايت فقط. يمكنك ضبط الحد الأدنى باستخدام المعيار يساوي (=) أو أكبر من (>) يمكنك أيضًا تحديد فترة زمنية بين تنبيهَين متتاليَين. يمكنك استخدام خيار الساعات/الدقائق/الثواني.

معايير ضبط التنبيهات على مستوى النظام

يصف الجدول التالي المعايير:

التحقّق من المنافذ الخاصة بـ Apigee والمنافذ التابعة لجهات خارجية

يُرجى مراقبة المنافذ التالية للتأكّد من أنّها نشطة

• المنفذ 4526 و4527 و4528 على "خادم الإدارة" و"جهاز التوجيه" و"معالج الرسائل"
• المنفذ 1099 و1100 و1101 على "خادم الإدارة" و"جهاز التوجيه" و"معالج الرسائل"
• المنفذ 8081 و15999 على "أجهزة التوجيه"
• المنفذ 8082 و8998 على "معالجات الرسائل"
• المنفذ 8080 على "خادم الإدارة"

يُرجى التحقّق من المنافذ التالية التابعة لجهات خارجية للتأكّد من أنّها نشطة:

• منفذ Qpid رقم 5672
• منفذ Postgres رقم 5432
• منفذ Cassandra رقم 7000 و7199 و9042 و9160
• منفذ ZooKeeper رقم 2181
• منفذ SymasLDAP رقم 10389

لتحديد المنفذ الذي يستمع إليه كل مكوِّن من مكوّنات Apigee لطلبات بيانات من واجهة برمجة التطبيقات، يُرجى تنفيذ طلبات بيانات من واجهة برمجة التطبيقات التالية على "خادم الإدارة" (الذي يكون عادةً على المنفذ 8080):

curl -v -u username:password http://host:port/v1/servers?pod=gateway&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=central&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=analytics&region=dc-1

سيحتوي الناتج من هذه الأوامر على أقسام مشابهة لتلك الموضّحة أدناه. يعرض قسم http.management.port رقم المنفذ للمكوِّن المحدّد.

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

عرض السجلات

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

على سبيل المثال، يحتوي سجلّ النظام النموذجي لأحد المكوّنات على الإدخالات التالية كما هو موضّح أدناه:

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

يمكنك تعديل الملف /opt/apigee/conf/logback.xml للتحكّم في آلية التسجيل بدون الحاجة إلى إعادة تشغيل خادم. يحتوي الملف logback.xml على السمة التالية التي تضبط عدد المرات التي تتحقّق فيها آلية التسجيل من الملف logback.xml بحثًا عن تغييرات في الإعدادات:

<configuration scan="true" scanPeriod="30 seconds" >

تتحقّق آلية التسجيل من التغييرات تلقائيًا كل دقيقة. إذا لم تحدّد الوحدات الزمنية للسمة scanPeriod، سيتم ضبطها تلقائيًا على الملّي ثانية.

يوضّح الجدول التالي موقع ملفات السجلّ لمكوّنات Apigee Edge Private Cloud.

تفعيل سجلات تصحيح الأخطاء لمعالج الرسائل

لتفعيل سجلات تصحيح الأخطاء لمعالج الرسائل، يُرجى اتّباع الخطوات التالية:

1. على عقدة "معالج الرسائل"، عدِّل الملف /opt/apigee/customer/application/message-processor.properties. إذا لم يكن هذا الملف موجودًا، يُرجى إنشائه.
2. أضِف السمة التالية إلى الملف:

   conf_system_log.level=DEBUG

3. أعِد تشغيل "معالج الرسائل":

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

أفضل الممارسات لاستخدام `apigee-monit`

عند استخدام apigee-monit، تنصحك Apigee بما يلي:

• إيقاف مراقبة مكوِّن قبل إجراء أي عملية تبدأه أو توقفه، مثل إجراء نسخة احتياطية أو ترقية
• مراقبة apigee-monit باستخدام أداة مثل cron لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مراقبة apigee-monit.

أدوات المراقبة

يمكن أن تساعدك أدوات المراقبة، مثل Nagios وCollectd وGraphite وSplunk وSumologic وMonit، في مراقبة بيئة مؤسستك وعملياتها التجارية بالكامل.