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

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

تتيح لك Apigee Edge إعادة توجيه التنبيهات إلى سجلّات syslog أو أنظمة/أدوات المراقبة الخارجية عند حدوث خطأ أو تعذّر بسبب تعذّر حدث. يمكن أن تكون هذه التنبيهات على مستوى النظام أو تنبيهات/أحداث على مستوى التطبيق. التنبيهات على مستوى التطبيق هي في الغالب تنبيهات مخصّصة يتم إنشاؤها استنادًا إلى الأحداث التي يتم إنشاؤها. يضبط مشرف الشبكة عادةً الشروط المخصّصة. لمزيد من المعلومات عن التنبيهات، يُرجى التواصل مع فريق دعم 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
• منفذ OpenLDAP 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.

تفعيل سجلّات تصحيح الأخطاء لمعالج الرسائل وواجهة مستخدم Edge

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

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

   conf_system_log.level=DEBUG

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

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

لتفعيل سجلّات تصحيح الأخطاء لواجهة مستخدم Edge، اتّبِع الخطوات التالية:

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

   conf_application_logger.application=DEBUG

3. إعادة تشغيل واجهة مستخدم Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

أفضل الممارسات المتعلّقة بـ apigee-monit

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

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

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

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