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

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

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

إعداد حدود للتنبيهات

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

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

ويوضّح الجدول التالي المعايير:

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

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

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

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

• منفذ Qpid رقم 5672
• المنفذ 5432 لـ Postgres
• كاساندرا بورت 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

أفضل ممارسات نظام apigee-monit

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

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

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

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