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

يتضمّن 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 في مجموعة عنقودية من 5 عُقد
الشكل 1: يتم تشغيل مثيل منفصل من apigee-monit بشكل منعزل على كل عقدة في مجموعة

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

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

By default, apigee-monit monitors all Edge components on a node using their pre-defined component configurations. للاطّلاع على الإعدادات التلقائية، يمكنك الرجوع إلى ملفات إعدادات المكوّن 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
New Edge UI
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

يوضّح المثال التالي الإعدادات التلقائية لمكوّن واجهة مستخدم Edge الجديدة (edge-management-ui):

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

لا يمكنك تغيير إعدادات المكوّنات التلقائية لأي مكوّن من مكوّنات Apigee Edge for Private Cloud. ومع ذلك، يمكنك إضافة إعدادات المكوّنات الخاصة بك للخدمات الخارجية، مثل نقطة النهاية المستهدفة أو خدمة 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 (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (قاعدة بيانات PostgreSQL)
  • apigee-qpidd (Qpidd)
  • ‫apigee-zookeeper (ZooKeeper)
  • ‫edge-management-server (خادم الإدارة)
  • ‫edge-management-ui (واجهة مستخدم Edge الجديدة)
  • edge-message-processor (معالج الرسائل)
  • edge-postgres-server (خادم Postgres)
  • ‫edge-qpid-server (Qpid Server)
  • edge-router (جهاز توجيه الحافة)

يُرجى العِلم أنّ "الكل" ليس خيارًا صالحًا لـ 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 (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (قاعدة بيانات PostgreSQL)
  • apigee-qpidd (Qpidd)
  • ‫apigee-zookeeper (ZooKeeper)
  • ‫edge-management-server (خادم الإدارة)
  • ‫edge-management-ui (واجهة مستخدم Edge الجديدة)
  • edge-message-processor (معالج الرسائل)
  • edge-postgres-server (خادم Postgres)
  • ‫edge-qpid-server (Qpid Server)
  • edge-router (جهاز توجيه الحافة)

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

/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 for Private Cloud. على سبيل المثال، يمكنك استخدام 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 الأوامر التالية التي تمنحك معلومات مجمّعة عن حالة المكوّنات على عقدة:

الأوامر الاستخدام
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-management-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