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

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

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

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

البدء بسرعة

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

إذا كنت تستخدم Amazon Linux، أولاً تثبيت الأرباح عبر 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"، اتّبِع الخطوات التالية:

/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

/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

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

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

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

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

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

تنصح Apigee بمراقبة "apigee-monit" للتأكّد من تشغيله. لمزيد من المعلومات راجِع مراقبة واجهة برمجة التطبيقات API.

هندسة معمارية أبيج مونيت

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

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

تكوينات المكونات

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

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

تتحقّق ميزة apigee-monit من جوانب مختلفة للمكوِّن، بناءً على المكوّن الذي يتم التحقّق منه. تشير رسالة الأشكال البيانية يسرد الجدول التالي ما يتحقّق منه 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-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 for Private Cloud. يمكنك ذلك، ومع ذلك، يمكنك إضافة إعدادات المكوّنات الخاصة بالخدمات الخارجية، مثل نقطة النهاية المستهدفة. أو خدمة httpd. لمزيد من المعلومات، يُرجى مراجعة إعدادات المكوّنات غير Apigee:

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

• إيقاف مكوِّن وبدء تتبُّعه
• إيقاف apigee-monit وتفعيله وإيقافه

تثبيت apigee-monit

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

يوضّح هذا القسم كيفية تثبيت "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

• 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، كما هو موضَّح في. إيقاف واجهة برمجة التطبيقات API وإيقافها وبدئها

إيقاف وتشغيل وتعطيل واجهة برمجة التطبيقات apigee-monit

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

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

لإيقاف "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

إيقاف واجهة برمجة التطبيقات API

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

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

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

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

لإلغاء تثبيت "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 reload

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

5. كرر هذا الإجراء لكل عقدة في المجموعة الخاصة بك.

تجدر الإشارة إلى أنّ هذه السمة مخصّصة للمكوّنات التي لا تستخدم نظام التشغيل 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"، ثم إعادة المحاولة.

مراقبة واجهات برمجة التطبيقات API

من أفضل الممارسات التحقُّق بانتظام من تشغيل 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، يُرجى الاطّلاع على وثائق نظام تشغيل الخادم أو .

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 واحدة فقط محددة في الملف. (لا تستخدم السطور التعليقية count.)

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

لإيقاف 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