الشفاء الذاتي مع إبرة الرماح

يتضمّن Apigee Edge for Private Cloud apigee-monit، وهي أداة تستند إلى الأداة المساعدة monit المفتوحة المصدر. تتحقّق apigee-monit بشكل دوري من خدمات Edge، وإذا كانت إحدى الخدمات غير متاحة، تحاول apigee-monit إعادة تشغيلها.

لاستخدام apigee-monit، يجب تثبيته يدويًا. وهي ليست جزءًا من عملية التثبيت العادية.

بشكلٍ تلقائي، تتحقّق apigee-monit من حالة خدمات Edge كل 60 ثانية.

البدء بسرعة

يوضّح لك هذا القسم كيفية البدء بسرعة في استخدام apigee-monit.

إذا كنت تستخدم Amazon Linux أو Oracle-Linux-7.X، عليك أولاً تثبيت monit من خلال Fedora. وإلّا، تخطَّ هذه الخطوة.

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

لتثبيت apigee-monit، اتّبِع الخطوات التالية:

  تثبيت apigee-monit
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

يؤدي ذلك إلى تثبيت apigee-monit وبدء مراقبة جميع المكوّنات على العقدة تلقائيًا.

  إيقاف مراقبة المكوّنات
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
  بدء تتبُّع المكوّنات
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
  الحصول على معلومات حالة ملخّصة
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
  الاطّلاع على ملفات سجلّ apigee-monit
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

يتم وصف كل من هذه المواضيع وغيرها بالتفصيل في الأقسام التالية.

لمحة عن apigee-monit

تساعد apigee-monit في ضمان استمرار تشغيل جميع المكوّنات على العُقدة. ويتم ذلك من خلال توفير مجموعة متنوعة من الخدمات، بما في ذلك:

  • إعادة تشغيل الخدمات التي تعذّر تشغيلها
  • عرض معلومات الملخّص
  • تسجيل حالة المراقبة
  • إرسال الإشعارات
  • مراقبة الخدمات غير التابعة لـ Edge

تنصح Apigee بمراقبة apigee-monit للتأكّد من أنّه يعمل. لمزيد من المعلومات، يُرجى الاطّلاع على مراقبة apigee-monit.

بنية apigee-monit

أثناء عملية تثبيت Apigee Edge for Private Cloud وإعداده، يمكنك اختياريًا تثبيت نسخة منفصلة من apigee-monit على كل عقدة في مجموعتك. تعمل هذه الحالات المنفصلة apigee-monit بشكل مستقل عن بعضها البعض، فهي لا تنقل حالة مكوّناتها إلى العُقد الأخرى، ولا تنقل حالات تعذُّر أداة المراقبة نفسها إلى أي خدمة مركزية.

تعرض الصورة التالية بنية apigee-monit في مجموعة مؤلفة من 5 عُقد:

بنية Apigee monit في مجموعة مؤلّفة من 5 عقد
الشكل 1: يتم تشغيل نسخة منفصلة من apigee-monit بشكل مستقل على كل عقدة في مجموعة

إعدادات المكوّنات

يستخدم apigee-monit إعدادات المكوّنات لتحديد المكوّنات التي يجب مراقبتها والجوانب التي يجب التحقّق منها في المكوّن والإجراء الذي يجب اتّخاذه في حال حدوث خطأ.

تتولّى أداة apigee-monit تلقائيًا مراقبة جميع مكوّنات Edge على عقدة باستخدام إعدادات المكوّنات المحدّدة مسبقًا. للاطّلاع على الإعدادات التلقائية، يمكنك الرجوع إلى ملفات إعدادات المكوّن apigee-monit. لا يمكنك تغيير إعدادات المكوّنات التلقائية.

تتحقّق apigee-monit من جوانب مختلفة لأحد المكوّنات، وذلك حسب المكوّن الذي يتم التحقّق منه. يسرد الجدول التالي ما يتحقّق منه apigee-monit لكل مكوّن، ويوضّح لك مكان إعدادات المكوّن لكل مكوّن. يُرجى العِلم أنّ بعض المكوّنات يتم تحديدها في ملف إعداد واحد، بينما يكون للبعض الآخر إعدادات خاصة.

المكوّن موقع الإعداد ما تتم مراقبته
خادم الإدارة /opt/apigee/edge-management-server/monit/default.conf عمليات التحقّق apigee-monit:
  • المنافذ المحدّدة مفتوحة وتقبل الطلبات
  • البروتوكولات المحدّدة متوافقة
  • حالة الردّ

بالإضافة إلى ذلك، بالنسبة إلى هذه المكوّنات apigee-monit:

  • يتطلّب حدوث حالات فشل متعدّدة خلال عدد محدّد من الدورات قبل اتخاذ إجراء
  • تضبط هذه السمة مسار طلب مخصّصًا.
معالج الرسائل /opt/apigee/edge-message-processor/monit/default.conf
خادم Postgres /opt/apigee/edge-postgres-server/monit/default.conf
خادم Qpid /opt/apigee/edge-qpid-server/monit/default.conf
جهاز التوجيه /opt/apigee/edge-router/monit/default.conf
Cassandra
واجهة مستخدم Edge
SymasLDAP
Postgres
Qpid
Zookeeper
/opt/apigee/data/apigee-monit/monit.conf عمليات التحقّق apigee-monit:
  • الخدمة قيد التشغيل

يوضّح المثال التالي إعدادات المكوّن التلقائية edge-router للمكوّن:

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

يعرض المثال التالي الإعدادات التلقائية لمكوّن Classic UI (edge-ui):

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

ينطبق ذلك على واجهة المستخدم الكلاسيكية، وليس على واجهة Edge الجديدة التي يكون اسم مكوّنها edge-management-ui.

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

بشكل تلقائي، تراقب apigee-monit جميع المكوّنات على العقدة التي يتم تشغيلها عليها. يمكنك تفعيل هذه السياسة أو إيقافها لجميع المكوّنات أو لمكوّنات فردية. يمكنك الاطّلاع على ما يلي للحصول على مزيد من المعلومات:

تثبيت apigee-monit

لا يتم تثبيت apigee-monit تلقائيًا، ولكن يمكنك تثبيته يدويًا بعد الترقية إلى الإصدار 4.19.01 أو إصدار أحدث من Apigee Edge للسحابة الخاصة أو تثبيت هذا الإصدار.

يوضّح هذا القسم كيفية تثبيت apigee-monit.

للحصول على معلومات حول إلغاء تثبيت apigee-monit، يُرجى الاطّلاع على إلغاء تثبيت apigee-monit.

تثبيت apigee-monit

يوضّح هذا القسم كيفية تثبيت apigee-monit.

لتثبيت apigee-monit، اتّبِع الخطوات التالية:

  1. ثبِّت apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. اضبط apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. ابدأ apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
  4. كرِّر هذا الإجراء على كل عقدة في مجموعتك.

إيقاف مكونات المراقبة وبدء تشغيلها

عندما تتوقف إحدى الخدمات لأي سبب، يحاول apigee-monit إعادة تشغيلها.

يمكن أن يتسبب ذلك في حدوث مشكلة إذا كنت تريد إيقاف أحد المكوّنات عن قصد. على سبيل المثال، قد تحتاج إلى إيقاف أحد المكوّنات عند الحاجة إلى الاحتفاظ بنسخة احتياطية منه أو ترقيته. إذا أعاد apigee-monit تشغيل الخدمة أثناء إجراء النسخ الاحتياطي أو الترقية، قد تتعطّل عملية الصيانة، ما قد يؤدي إلى تعذّر إكمالها.

تعرض الأقسام التالية خيارات لإيقاف مراقبة المكوّنات.

إيقاف مكوّن وإلغاء مراقبته

لإيقاف أحد المكوّنات وإلغاء مراقبته، نفِّذ الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
يمكن أن تكون قيمة component_name إحدى القيم التالية:
  • apigee-cassandra (كاساندرا)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (قاعدة بيانات PostgreSQL)
  • apigee-qpidd (Qbidd)
  • apigee-sso (الدخول الموحّد في Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (خادم الإدارة)
  • edge-management-ui (واجهة مستخدم Edge الجديدة)
  • edge-message-processor (معالج الرسائل)
  • edge-postgres-server (خادم Postgres)
  • edge-qpid-server (خادم Qbid)
  • edge-router (جهاز توجيه الحواف)
  • edge-ui (واجهة المستخدم الكلاسيكية)

يُرجى العلم أنّ "الكل" ليس خيارًا صالحًا لـ stop-component. يمكنك إيقاف المراقبة وإلغاءها لمكوّن واحد فقط في كل مرة باستخدام stop-component.

لإعادة تشغيل المكوّن واستئناف المراقبة، نفِّذ الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

يُرجى العلم أنّ "الكل" ليس خيارًا صالحًا لـ start-component.

للحصول على تعليمات حول كيفية إيقاف جميع المكوّنات وإلغاء مراقبتها، راجِع إيقاف جميع المكوّنات وإلغاء مراقبتها.

إيقاف مراقبة أحد المكوّنات (بدون إيقافه)

لإيقاف مراقبة أحد المكوّنات (بدون إيقافه)، نفِّذ الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
يمكن أن تكون قيمة component_name إحدى القيم التالية:
  • apigee-cassandra (كاساندرا)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (قاعدة بيانات PostgreSQL)
  • apigee-qpidd (Qbidd)
  • apigee-sso (الدخول الموحّد في Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (خادم الإدارة)
  • edge-management-ui (واجهة مستخدم Edge الجديدة)
  • edge-message-processor (معالج الرسائل)
  • edge-postgres-server (خادم Postgres)
  • edge-qpid-server (خادم Qbid)
  • edge-router (جهاز توجيه الحواف)
  • edge-ui (واجهة المستخدم الكلاسيكية)

لاستئناف مراقبة المكوّن، شغِّل الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

إيقاف مراقبة جميع المكوّنات (بدون إيقافها)

لإيقاف مراقبة جميع المكوّنات (بدون إيقافها)، نفِّذ الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

لاستئناف مراقبة جميع المكوّنات، نفِّذ الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

إيقاف جميع المكوّنات وإلغاء مراقبتها

لإيقاف جميع المكوّنات وإلغاء مراقبتها، نفِّذ الأوامر التالية:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

لإعادة تشغيل جميع المكوّنات واستئناف المراقبة، نفِّذ الأوامر التالية:

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

لإيقاف مراقبة جميع المكوّنات، يمكنك أيضًا إيقاف apigee-monit، كما هو موضّح في إيقاف apigee-monit وبدء تشغيله وإيقافه.

إيقاف apigee-monit وبدء تشغيله وإيقافه

كما هو الحال مع أي خدمة، يمكنك إيقاف apigee-monit وبدء تشغيلها باستخدام الأمر apigee-service. بالإضافة إلى ذلك، يتيح apigee-monit استخدام الأمر unmonitor الذي يتيح لك إيقاف مراقبة المكوّنات مؤقتًا.

إيقاف apigee-monit

لإيقاف apigee-monit، استخدِم الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

بدء apigee-monit

لبدء apigee-monit، استخدِم الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

إيقاف apigee-monit

يمكنك إيقاف مراقبة جميع المكوّنات على العُقدة باستخدام الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

بدلاً من ذلك، يمكنك إيقاف apigee-monit نهائيًا عن طريق إلغاء تثبيته من العقدة، كما هو موضّح في إلغاء تثبيت apigee-monit.

إلغاء تثبيت apigee-monit

لإلغاء تثبيت apigee-monit، اتّبِع الخطوات التالية:

  1. إذا أعددت مهمة cron لمراقبة apigee-monit، عليك إزالة مهمة cron قبل إلغاء تثبيت apigee-monit:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. أوقِف apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. ألغِ تثبيت apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. كرِّر هذا الإجراء على كل عقدة في مجموعتك.

مراقبة أحد المكوّنات المثبَّتة حديثًا

إذا ثبّتَّ مكونًا جديدًا على عقدة تعمل عليها apigee-monit، يمكنك بدء مراقبته من خلال تنفيذ أمر restart الخاص بـ apigee-monit. سيؤدي ذلك إلى إنشاء ملف monit.conf جديد يتضمّن المكوّن الجديد في إعدادات المكوّنات.

يعيد المثال التالي تشغيل apigee-monit:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

تخصيص apigee-monit

يمكنك تخصيص إعدادات apigee-monit المختلفة، بما في ذلك:

  1. إعدادات التحكّم apigee-monit التلقائية
  2. إعدادات الضبط العامة
  3. إعدادات المكوّنات غير التابعة لـ Apigee

إعدادات التحكّم التلقائية في apigee-monit

يمكنك تخصيص إعدادات التحكّم التلقائية في apigee-monit، مثل معدّل تكرار عمليات التحقّق من الحالة ومواقع ملفات apigee-monit. يمكنك إجراء ذلك من خلال تعديل ملف خصائص باستخدام تقنية الرمز مع الإعداد. ستبقى ملفات الخصائص متاحة حتى بعد ترقية Apigee Edge for Private Cloud.

يوضّح الجدول التالي إعدادات عنصر التحكّم التلقائية apigee-monit التي يمكنك تخصيصها:

الموقع الوصف
conf_monit_httpd_port منفذ البرنامج الخفي httpd يستخدم تطبيق apigee-monit httpd للوحة البيانات ولتفعيل التقارير/الملخّصات. القيمة التلقائية هي 2812.
conf_monit_httpd_allow القيود المفروضة على الطلبات الموجّهة إلى البرنامج الخفي httpd يستخدم apigee-monit httpd لتشغيل تطبيق لوحة البيانات وتفعيل التقارير/الملخّصات. يجب أن تشير هذه القيمة إلى المضيف المحلي (المضيف الذي يتم تشغيل httpd عليه).

لطلب تضمين اسم مستخدم وكلمة مرور في الطلبات، استخدِم البنية التالية:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

عند إضافة اسم مستخدم وكلمة مرور، أدرِج "\n" بين كل قيد. لا تُدرِج أسطرًا جديدة أو عمليات إرجاع فعلية في القيمة.

conf_monit_monit_datadir الدليل الذي يتم فيه تخزين تفاصيل الحدث
conf_monit_monit_delay_time مقدار الوقت الذي ينتظره apigee-monit بعد تحميله لأول مرة في الذاكرة قبل تشغيله. يؤثّر ذلك في apigee-monit عملية التحقّق الأولى فقط.
conf_monit_monit_logdir موقع ملف السجل apigee-monit
conf_monit_monit_retry_time تمثّل هذه السمة عدد المرات التي يحاول فيها apigee-monit التحقّق من كل عملية، والقيمة التلقائية هي 60 ثانية.
conf_monit_monit_rundir موقع ملفات معرّف العملية (PID) وملفات الحالة التي يستخدمها apigee-monit للتحقّق من العمليات

لتخصيص إعدادات عنصر التحكّم apigee-monit التلقائية، اتّبِع الخطوات التالية:

  1. عدِّل الملف التالي:
    /opt/apigee/customer/application/monit.properties

    إذا لم يكن الملف متوفّرًا، أنشئه واضبط المالك على المستخدم "apigee":

    chown apigee:apigee /opt/apigee/customer/application/monit.properties

    يُرجى العِلم أنّه إذا كان الملف متوفّرًا من قبل، قد تكون هناك خصائص إعداد إضافية محدّدة فيه بخلاف ما هو مدرَج في الجدول أعلاه. يجب عدم تعديل أي خصائص أخرى غير تلك المذكورة أعلاه.

  2. اضبط قيم السمات أو استبدلها بقيمك الجديدة.

    على سبيل المثال، لتغيير موقع ملف السجلّ إلى /tmp، أضِف السمة التالية أو عدِّلها:

    conf_monit_monit_logdir=/tmp/apigee-monit.log
  3. احفظ التغييرات في ملف monit.properties.
  4. أعِد ضبط apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. أعِد تحميل apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    إذا تعذّر إعادة تشغيل apigee-monit، راجِع ملف السجلّ بحثًا عن أخطاء كما هو موضّح في الوصول إلى ملفات سجلّ apigee-monit.

  6. كرِّر هذا الإجراء لكل عقدة في مجموعتك.

إعدادات الضبط العامة

يمكنك تحديد إعدادات الضبط العامة لـ apigee-monit، مثلاً، يمكنك إضافة إشعارات بالبريد الإلكتروني بشأن التنبيهات. يمكنك إجراء ذلك من خلال إنشاء ملف إعداد في الدليل /opt/apigee/data/apigee-monit ثم إعادة تشغيل apigee-monit.

لتحديد إعدادات الضبط العامة في apigee-monit، اتّبِع الخطوات التالية:

  1. أنشئ ملف إعداد جديدًا للمكوّن في الموقع الجغرافي التالي:
    /opt/apigee/data/apigee-monit/filename.conf

    يمكن أن يكون filename أي اسم ملف صالح، باستثناء "monit".

  2. غيِّر مالك ملف الإعداد الجديد إلى المستخدم "apigee"، كما يوضّح المثال التالي:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
  3. أضِف إعدادات الضبط العامة إلى الملف الجديد. يضبط المثال التالي خادم بريد ويحدد مستلمي التنبيهات:
    SET MAILSERVER smtp.gmail.com PORT 465
      USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
      USING SSL, WITH TIMEOUT 15 SECONDS
    
    SET MAIL-FORMAT {
      from: edge-alerts@example.com
      subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
    }
    SET ALERT fred@example.com
    SET ALERT nancy@example.com

    للاطّلاع على قائمة كاملة بخيارات الإعدادات العامة، يُرجى الرجوع إلى مستندات monit.

  4. احفظ التغييرات في ملف إعداد المكوّن.
  5. أعِد تحميل apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    إذا لم تتم إعادة تشغيل apigee-monit، تحقَّق من ملف السجلّ بحثًا عن أخطاء كما هو موضّح في الوصول إلى ملفات سجلّ apigee-monit.

  6. كرِّر هذا الإجراء لكل عقدة في مجموعتك.

إعدادات المكوّنات غير التابعة لـ Apigee

يمكنك إضافة إعداداتك الخاصة إلى apigee-monit لكي يتحقّق من الخدمات التي لا تشكّل جزءًا من Apigee Edge للسحابة الخاصة. على سبيل المثال، يمكنك استخدام apigee-monit للتأكّد من أنّ واجهات برمجة التطبيقات تعمل من خلال إرسال طلبات إلى نقطة النهاية المستهدَفة.

لإضافة إعدادات مكوّن غير تابع لـ Apigee، اتّبِع الخطوات التالية:

  1. أنشئ ملف إعداد جديدًا للمكوّن في الموقع الجغرافي التالي:
    /opt/apigee/data/apigee-monit/filename.conf

    يمكن أن يكون filename أي اسم ملف صالح، باستثناء "monit".

    يمكنك إنشاء أي عدد تريده من ملفات إعداد المكوّنات. على سبيل المثال، يمكنك إنشاء ملف إعداد منفصل لكل مكوّن غير تابع لـ Apigee تريد تتبُّعه على العُقدة.

  2. غيِّر مالك ملف الإعداد الجديد إلى المستخدم "apigee"، كما يوضّح المثال التالي:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
  3. أضِف الإعدادات المخصّصة إلى الملف الجديد. يتحقّق المثال التالي من نقطة النهاية المستهدَفة على الخادم المحلي:
    CHECK HOST localhost_validate_test WITH ADDRESS localhost
      IF FAILED
        PORT 15999
        PROTOCOL http
        REQUEST "/validate__test"
        CONTENT = "Server Ready"
        FOR 2 times WITHIN 3 cycles
      THEN alert

    للاطّلاع على قائمة كاملة بإعدادات الضبط المحتملة، يُرجى الرجوع إلى مستندات Monit.

  4. احفظ التغييرات في ملف الإعدادات.
  5. أعِد تحميل apigee-monit باستخدام الأمر التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    إذا لم تتم إعادة تشغيل apigee-monit، تحقَّق من ملف السجلّ بحثًا عن أخطاء كما هو موضّح في الوصول إلى ملفات سجلّ apigee-monit.

  6. كرِّر هذا الإجراء لكل عقدة في مجموعتك.

يُرجى العِلم أنّ هذا الإجراء مخصّص للمكوّنات غير Edge فقط. لا يمكنك تخصيص إعدادات المكوّنات لمكوّنات Edge.

الوصول إلى ملفات سجلّ apigee-monit

تسجّل apigee-monit جميع الأنشطة، بما في ذلك الأحداث وعمليات إعادة التشغيل وتغييرات الإعدادات والتنبيهات، في ملف سجلّ.

الموقع التلقائي لملف السجلّ هو:

/opt/apigee/var/log/apigee-monit/apigee-monit.log

يمكنك تغيير الموقع الجغرافي التلقائي من خلال تخصيص إعدادات عنصر التحكّم apigee-monit.

تتّخذ إدخالات ملف السجلّ الشكل التالي:

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

لا يمكنك تخصيص تنسيق إدخالات ملف السجلّ apigee-monit.

عرض الحالة المجمّعة باستخدام apigee-monit

يتضمّن apigee-monit الأوامر التالية التي تمنحك معلومات مجمّعة عن حالة المكوّنات على إحدى العُقد:

Command الاستخدام
report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

يتم شرح كل من هذه الأوامر بمزيد من التفصيل في الأقسام التالية.

تقرير

يمنحك الأمر report ملخّصًا مجمّعًا لعدد المكوّنات التي تعمل أو لا تعمل أو يتم تهيئتها حاليًا أو لا تتم مراقبتها حاليًا على إحدى العُقد. يستدعي المثال التالي الأمر report:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

يوضّح المثال التالي ناتج report في إعدادات AIO (الكل في واحد):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

في هذا المثال، تشير apigee-monit إلى أنّ 11 خدمة من أصل 12 تعمل بشكل سليم. لا تتم مراقبة إحدى الخدمات حاليًا.

قد يظهر لك الخطأ Connection refused عند تنفيذ الأمر report للمرة الأولى. في هذه الحالة، يُرجى الانتظار لمدة قيمة السمة conf_monit_monit_delay_time، ثم إعادة المحاولة.

ملخّص

تعرض الأداة summary كل مكوّن وتوفّر حالته. يستدعي المثال التالي الأمر summary:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

يوضّح المثال التالي ناتج summary في إعدادات AIO (الكل في واحد):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

إذا ظهر لك الخطأ Connection refused عند تنفيذ الأمر summary للمرة الأولى، حاوِل الانتظار لمدة conf_monit_monit_delay_time، ثم أعِد المحاولة.

مراقبة apigee-monit

من أفضل الممارسات التحقّق بانتظام من أنّ apigee-monit يعمل على كل عقدة.

للتحقّق من أنّ apigee-monit قيد التشغيل، استخدِم الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

تنصح Apigee بتنفيذ هذا الأمر بشكل دوري على كل عقدة يتم تشغيل apigee-monit عليها. يمكن إجراء ذلك باستخدام أداة مثل cron التي تنفّذ المهام المجدوَلة على فترات زمنية محددة مسبقًا.

لاستخدام cron لمراقبة apigee-monit، اتّبِع الخطوات التالية:

  1. أضِف دعم cron من خلال نسخ الدليل apigee-monit.cron إلى الدليل /etc/cron.d، كما هو موضّح في المثال التالي:
    cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
  2. افتح ملف apigee-monit.cron لتعديله.

    يحدد ملف apigee-monit.cron مهمة cron التي سيتم تنفيذها، بالإضافة إلى معدّل تكرار تنفيذ هذه المهمة. يوضّح المثال التالي القيم التلقائية:

    # Cron entry to check if monit process is running. If not start it
    */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

    يستخدم هذا الملف بنية الجملة التالية، حيث تحدّد الحقول الخمسة الأولى الوقت الذي ينفّذ فيه apigee-monit الإجراء:

    min hour day_of_month month day_of_week task_to_execute

    على سبيل المثال، وقت التنفيذ التلقائي هو */2 * * * *، ما يوجّه cron إلى التحقّق من عملية apigee-monit كل دقيقتَين.

    لا يمكنك تنفيذ مهمة cron أكثر من مرة واحدة في الدقيقة.

    لمزيد من المعلومات حول استخدام cron، راجِع مستندات نظام تشغيل الخادم أو صفحات man.

  3. غيِّر إعدادات cron لتتوافق مع سياسات مؤسستك. على سبيل المثال، لتغيير معدّل التنفيذ إلى كل 5 دقائق، اضبط تعريف المهمة على ما يلي:
    */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
  4. احفظ ملف apigee-monit.cron.
  5. كرِّر هذا الإجراء لكل عقدة في مجموعتك.

إذا لم يبدأ cron بمشاهدة apigee-monit، يُرجى التأكّد مما يلي:

  • يجب ترك سطر فارغ بعد تعريف مهمة cron.
  • تم تحديد وظيفة cron واحدة فقط في الملف. (لا يتم احتساب الأسطر التي تتضمّن تعليقات.)

إذا أردت إيقاف apigee-monit أو إيقافه مؤقتًا، عليك إيقاف مهمة cron هذه أيضًا، وإلا ستعيد cron تشغيل apigee-monit.

لإيقاف cron، نفِّذ أحد الإجراءات التالية:

  • احذف الملف /etc/cron.d/apigee-monit.cron:
    sudo rm /etc/cron.d/apigee-monit.cron

    عليك إعادة نسخه إذا أردت لاحقًا إعادة تفعيل إمكانية وصول "cron" إلى apigee-monit.

    أو

  • عدِّل الملف /etc/cron.d/apigee-monit.cron وأضِف تعليقًا إلى تعريف المهمة من خلال إضافة علامة "#" في بداية السطر، على سبيل المثال:
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit