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

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

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

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

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

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

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

تنبيه الحدّ الأدنى المقترَح الوصف

ذاكرة منخفضة

500 ميغابايت

الذاكرة منخفضة جدًا بحيث لا يمكن بدء تشغيل مكوّن

انخفاض مساحة القرص (/var/log)

8 غيغابايت

انخفضت مساحة القرص كثيرًا.

حِمل زائد

3+

زيادة غير متوقعة في عدد العمليات التي تكون في انتظار التشغيل

تم إيقاف العملية

لا ينطبق، قيمة منطقية صواب أم خطأ

توقّفت عملية Java في Apigee في النظام

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

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

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

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

  • منفذ Qpid رقم 5672
  • المنفذ 5432 لـ Postgres
  • منفذ 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.

المكونات الموقع الجغرافي

خادم الإدارة

opt/apigee/var/log/edge-management-server

جهاز التوجيه

opt/apigee/var/log/edge-router

معالج الرسائل

opt/apigee/var/log/edge-message-processor

خادم Qpid

opt/apigee/var/log/edge-qpid-server

خادم Apigee Postgres

opt/apigee/var/log/edge-postgres-server

واجهة مستخدم Edge

opt/apigee/var/log/edge-ui

ZooKeeper

opt/apigee/var/log/apigee-zookeeper

OpenLDAP

opt/apigee/var/log/apigee-openldap

كاساندرا

opt/apigee/var/log/apigee-cassandra

Qpidd

opt/apigee/var/log/apigee-qpidd

قاعدة بيانات PostgreSQL

opt/apigee/var/log/apigee-postgresql

تفعيل سجلات تصحيح الأخطاء للرسالة المعالِج وواجهة مستخدم 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 باتّباع ما يلي:

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

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

المكوّن ناغيوس Collectd Splunk

عمليات التحقّق على مستوى النظام

استخدام وحدة المعالجة المركزية

الذاكرة المتوفّرة/المستعملة

استخدام مساحة القرص

إحصاءات الشبكة

العمليات

عمليات التحقّق من واجهة برمجة التطبيقات

JMX

Java

ملفات السجلّ

الأحداث المهمة

نتيجة قيود المعدل

لا يمكن الوصول إلى خادم الخلفية (Hybris أو SharePoint)

لا يمكن الوصول إلى FaaS (STS)

أحداث التحذيرات

لا يمكن الوصول إلى خادم SMTP

اتفاقيات مستوى الخدمة التي تمّ انتهاكها