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

الإصدار 4.17.05 من Edge for Private Cloud

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

تتيح لك منصة 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
• منفذ 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"
}

عرض السجلّات

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

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

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. في عقدة معالج الرسائل، عدِّل /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

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

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