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

Edge for Private Cloud - الإصدار 4.16.09

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

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

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

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

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

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

تنبيه

الحد الأدنى المقترَح

الوصف

الذاكرة منخفضة

500 ميغابايت

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

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

8 غيغابايت

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

حِمل شديد

3+

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

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

N/A، قيمة منطقية لـ true أو false

تم إيقاف عملية Apigee Java في النظام.

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

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

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

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

  • منفذ Qpid 5672
  • منفذ Postgres رقم 5432
  • ميناء كاساندرا 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 ;

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

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

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

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

المكوّنات

الموقع الجغرافي

خادم الإدارة

<inst_root>/apigee/var/log/edge-management-server

جهاز التوجيه

<inst_root>/apigee/var/log/edge-router

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

<inst_root>/apigee/var/log/edge-message-processor

خادم Qpid

<inst_root>/apigee/var/log/edge-qpid-server

خادم Apigee Postgres

<inst_root>/apigee/var/log/edge-postgres-server

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

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

من الفئة العمرية 31-45

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

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

<inst_root>/apigee/var/log/apigee-postgresql

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

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

  1. في عقدة "معالج الرسائل"، عدِّل /<install_dir>/apigee/customer/application/messsage-processor.properties. إذا لم يكن الملف موجودًا، فأنشئه.
  2. أضِف السمة التالية إلى الملف:
    conf_system_log.level=DEBUG
  3. أعِد تشغيل معالج الرسائل:
    > /<install_dir>/apigee/apigee-service/bin/apigee-service Edge-message-processor أعِد تشغيل

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

  1. في عقدة واجهة مستخدم Edge، عدِّل /<install_dir>/apigee/customer/application/ui.properties. إذا لم يكن الملف موجودًا، فأنشئه.
  2. أضِف السمة التالية إلى الملف:
    conf_application_logger.application=DEBUG
  3. أعِد تشغيل واجهة مستخدم Edge:
    > /<install_dir>/apigee/apigee-service/bin/apigee-service Edge-ui إعادة تشغيل

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

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

المكوّن

الناغيوس

تم التجميع

Splunk

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

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

?

?

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

?

?

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

?

?

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

?

?

العمليات

?

عمليات فحص واجهة برمجة التطبيقات

?

سباق JMX

?

Java

?

ملفات السجلّ

?

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

تم بلوغ الحدّ الأقصى لمعدّل الزحف

?

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

?

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

?

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

يتعذّر الوصول إلى خادم SMTP.

?

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

?