يتضمّن 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 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
بشكل مستقل على كل عقدة في
مجموعةإعدادات المكوّنات
يستخدم apigee-monit
إعدادات المكوّنات لتحديد المكوّنات التي يجب مراقبتها والجوانب التي يجب التحقّق منها في المكوّن والإجراء الذي يجب اتّخاذه في حال حدوث خطأ.
تتولّى أداة apigee-monit
تلقائيًا مراقبة جميع مكوّنات Edge على عقدة باستخدام إعدادات المكوّنات المحدّدة مسبقًا. للاطّلاع على الإعدادات التلقائية، يمكنك الرجوع إلى ملفات إعدادات المكوّن apigee-monit
. لا يمكنك تغيير إعدادات المكوّنات التلقائية.
تتحقّق apigee-monit
من جوانب مختلفة لأحد المكوّنات، وذلك حسب المكوّن الذي يتم التحقّق منه. يسرد الجدول التالي ما يتحقّق منه apigee-monit
لكل مكوّن، ويوضّح لك مكان إعدادات المكوّن لكل مكوّن. يُرجى العِلم أنّ بعض المكوّنات يتم تحديدها في ملف إعداد واحد، بينما يكون للبعض الآخر إعدادات خاصة.
المكوّن | موقع الإعداد | ما تتم مراقبته |
---|---|---|
خادم الإدارة | /opt/apigee/edge-management-server/monit/default.conf |
عمليات التحقّق 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
لا يتم تثبيت apigee-monit
تلقائيًا، ولكن يمكنك تثبيته يدويًا بعد الترقية إلى الإصدار 4.19.01 أو إصدار أحدث من Apigee Edge للسحابة الخاصة أو تثبيت هذا الإصدار.
يوضّح هذا القسم كيفية تثبيت apigee-monit
.
للحصول على معلومات حول إلغاء تثبيت apigee-monit
، يُرجى الاطّلاع على
إلغاء تثبيت apigee-monit
.
تثبيت apigee-monit
يوضّح هذا القسم كيفية تثبيت apigee-monit
.
لتثبيت apigee-monit
، اتّبِع الخطوات التالية:
- ثبِّت
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
- اضبط
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- ابدأ
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit start
- كرِّر هذا الإجراء على كل عقدة في مجموعتك.
إيقاف مكونات المراقبة وبدء تشغيلها
عندما تتوقف إحدى الخدمات لأي سبب، يحاول apigee-monit
إعادة تشغيلها.
يمكن أن يتسبب ذلك في حدوث مشكلة إذا كنت تريد إيقاف أحد المكوّنات عن قصد. على سبيل المثال، قد تحتاج إلى إيقاف أحد المكوّنات عند الحاجة إلى الاحتفاظ بنسخة احتياطية منه أو ترقيته.
إذا أعاد apigee-monit
تشغيل الخدمة أثناء إجراء النسخ الاحتياطي أو الترقية، قد تتعطّل عملية الصيانة، ما قد يؤدي إلى تعذّر إكمالها.
تعرض الأقسام التالية خيارات لإيقاف مراقبة المكوّنات.
إيقاف مكوّن وإلغاء مراقبته
لإيقاف أحد المكوّنات وإلغاء مراقبته، نفِّذ الأمر التالي:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c 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
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
، اتّبِع الخطوات التالية:
- إذا أعددت مهمة
cron
لمراقبةapigee-monit
، عليك إزالة مهمةcron
قبل إلغاء تثبيتapigee-monit
:sudo rm /etc/cron.d/apigee-monit.cron
- أوقِف
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
- ألغِ تثبيت
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
- كرِّر هذا الإجراء على كل عقدة في مجموعتك.
مراقبة أحد المكوّنات المثبَّتة حديثًا
إذا ثبّتَّ مكونًا جديدًا على عقدة تعمل عليها apigee-monit
، يمكنك بدء مراقبته
من خلال تنفيذ أمر restart
الخاص بـ apigee-monit
. سيؤدي ذلك إلى إنشاء ملف monit.conf جديد يتضمّن المكوّن الجديد في إعدادات المكوّنات.
يعيد المثال التالي تشغيل apigee-monit
:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart
تخصيص apigee-monit
يمكنك تخصيص إعدادات apigee-monit
المختلفة، بما في ذلك:
إعدادات التحكّم التلقائية في 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
التلقائية، اتّبِع الخطوات التالية:
- عدِّل الملف التالي:
/opt/apigee/customer/application/monit.properties
إذا لم يكن الملف متوفّرًا، أنشئه واضبط المالك على المستخدم "apigee":
chown apigee:apigee /opt/apigee/customer/application/monit.properties
يُرجى العِلم أنّه إذا كان الملف متوفّرًا من قبل، قد تكون هناك خصائص إعداد إضافية محدّدة فيه بخلاف ما هو مدرَج في الجدول أعلاه. يجب عدم تعديل أي خصائص أخرى غير تلك المذكورة أعلاه.
اضبط قيم السمات أو استبدلها بقيمك الجديدة.
على سبيل المثال، لتغيير موقع ملف السجلّ إلى
/tmp
، أضِف السمة التالية أو عدِّلها:conf_monit_monit_logdir=/tmp/apigee-monit.log
- احفظ التغييرات في ملف
monit.properties
. - أعِد ضبط
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- أعِد تحميل
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
إذا تعذّر إعادة تشغيل
apigee-monit
، راجِع ملف السجلّ بحثًا عن أخطاء كما هو موضّح في الوصول إلى ملفات سجلّapigee-monit
. - كرِّر هذا الإجراء لكل عقدة في مجموعتك.
إعدادات الضبط العامة
يمكنك تحديد إعدادات الضبط العامة لـ apigee-monit
، مثلاً، يمكنك إضافة إشعارات بالبريد الإلكتروني بشأن التنبيهات. يمكنك إجراء ذلك من خلال إنشاء ملف إعداد في الدليل /opt/apigee/data/apigee-monit
ثم إعادة تشغيل apigee-monit
.
لتحديد إعدادات الضبط العامة في apigee-monit
، اتّبِع الخطوات التالية:
- أنشئ ملف إعداد جديدًا للمكوّن في الموقع الجغرافي التالي:
/opt/apigee/data/apigee-monit/filename.conf
يمكن أن يكون filename أي اسم ملف صالح، باستثناء "monit".
- غيِّر مالك ملف الإعداد الجديد إلى المستخدم "apigee"، كما يوضّح المثال التالي:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
- أضِف إعدادات الضبط العامة إلى الملف الجديد. يضبط المثال التالي خادم بريد ويحدد مستلمي التنبيهات:
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.
- احفظ التغييرات في ملف إعداد المكوّن.
- أعِد تحميل
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
إذا لم تتم إعادة تشغيل
apigee-monit
، تحقَّق من ملف السجلّ بحثًا عن أخطاء كما هو موضّح في الوصول إلى ملفات سجلّapigee-monit
. - كرِّر هذا الإجراء لكل عقدة في مجموعتك.
إعدادات المكوّنات غير التابعة لـ Apigee
يمكنك إضافة إعداداتك الخاصة إلى apigee-monit
لكي يتحقّق من الخدمات التي لا تشكّل جزءًا من Apigee Edge للسحابة الخاصة. على سبيل المثال، يمكنك استخدام apigee-monit
للتأكّد من أنّ واجهات برمجة التطبيقات تعمل من خلال إرسال طلبات إلى نقطة النهاية المستهدَفة.
لإضافة إعدادات مكوّن غير تابع لـ Apigee، اتّبِع الخطوات التالية:
- أنشئ ملف إعداد جديدًا للمكوّن في الموقع الجغرافي التالي:
/opt/apigee/data/apigee-monit/filename.conf
يمكن أن يكون filename أي اسم ملف صالح، باستثناء "monit".
يمكنك إنشاء أي عدد تريده من ملفات إعداد المكوّنات. على سبيل المثال، يمكنك إنشاء ملف إعداد منفصل لكل مكوّن غير تابع لـ Apigee تريد تتبُّعه على العُقدة.
- غيِّر مالك ملف الإعداد الجديد إلى المستخدم "apigee"، كما يوضّح المثال التالي:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
- أضِف الإعدادات المخصّصة إلى الملف الجديد. يتحقّق المثال التالي من نقطة النهاية المستهدَفة على الخادم المحلي:
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.
- احفظ التغييرات في ملف الإعدادات.
- أعِد تحميل
apigee-monit
باستخدام الأمر التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
إذا لم تتم إعادة تشغيل
apigee-monit
، تحقَّق من ملف السجلّ بحثًا عن أخطاء كما هو موضّح في الوصول إلى ملفات سجلّapigee-monit
. - كرِّر هذا الإجراء لكل عقدة في مجموعتك.
يُرجى العِلم أنّ هذا الإجراء مخصّص للمكوّنات غير 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
، اتّبِع الخطوات التالية:
- أضِف دعم
cron
من خلال نسخ الدليلapigee-monit.cron
إلى الدليل/etc/cron.d
، كما هو موضّح في المثال التالي:cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
- افتح ملف
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. - غيِّر إعدادات
cron
لتتوافق مع سياسات مؤسستك. على سبيل المثال، لتغيير معدّل التنفيذ إلى كل 5 دقائق، اضبط تعريف المهمة على ما يلي:*/5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
- احفظ ملف
apigee-monit.cron
. - كرِّر هذا الإجراء لكل عقدة في مجموعتك.
إذا لم يبدأ 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