تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

كيفية المراقبة

الإصدار 4.17.01 من Edge for Private Cloud

يصف هذا المستند أساليب مراقبة المكوّنات التي يتيحها النشر في الموقع لـ Apigee Edge.

تفعيل JMX

يتم تفعيل JMX تلقائيًا في Cassandra، ويتم إيقافه تلقائيًا في جميع مكوّنات Edge الأخرى. لذلك، يجب تفعيل JMX لكل مكوّن على حدة.

يتيح كل مكوّن استخدام JMX على منفذ مختلف. يسرد الجدول التالي منفذ JMX والملف الذي تعدّله لتفعيل JMX على هذا المنفذ:

المكوّن	منفذ JMX	ملف
خادم الإدارة	1099	/opt/apigee/edge-management-server/bin/start
معالج الرسائل	1101	/opt/apigee/edge-mesage-processor/bin/start
Qpid	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

على سبيل المثال، لتفعيل JMX على خادم الإدارة، افتح ‎/opt/apigee/edge-management-server/bin/start في محرِّر. من المفترض أن يظهر لك السطر التالي المستخدَم لبدء خادم الإدارة:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path 
-Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

عدِّل هذا السطر لإضافة ما يلي:

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

يُرجى العِلم أنّ هذا السطر يحدّد رقم منفذ JMX على أنّه 1099 لخادم الإدارة. اضبط رقم المنفذ لكل مكوّن كما هو محدّد في الجدول أعلاه. على سبيل المثال:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts 
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
-Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

احفظ الملف ثم أعِد تشغيل المكوّن. على سبيل المثال، لإعادة تشغيل خادم الإدارة:

> /opt/apigee/apigee-service/bin/ apigee-service edge-management-server restart

تفعيل مصادقة JMX وضبط كلمة مرور JMX

تستخدم عملية المراقبة لخادم الإدارة ومعالج الرسائل وQpid وPostgres جميعها JMX. يتم تفعيل JMX تلقائيًا، ولا يتطلّب الوصول عن بُعد إلى JMX كلمة مرور.

لتفعيل مصادقة JMX، يتضمّن كل مكوّن إجراء change_jmx_auth الذي تستخدمه لتفعيل/إيقاف المصادقة وضبط بيانات اعتماد JMX.

لتفعيل مصادقة JMX، استخدِم الأمر التالي:

>  /opt/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

حيث:

comp هو إما edge-management-server أو edge-message-processor أو edge-qpid-server أو edge-postgres-server.
الخيارات هي:
- ‫‎-u: اسم المستخدم
- ‫-p: كلمة المرور
- ‫-e: y (تفعيل) أو n (إيقاف)
يتضمّن ملف الإعداد ما يلي:
- JMX_USERNAME=username
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (إذا لم يتم ضبطها أو لم يتم تمريرها باستخدام -p، سيُطلب منك ذلك)

على سبيل المثال، لاستخدام الخيارات في سطر الأوامر:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -u foo -p bar -e y

إذا كان لديك ملف إعداد:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -f configFile

إذا كنت تشغّل Edge على عُقد متعددة، نفِّذ هذا الأمر على جميع العُقد، مع تحديد اسم المستخدم وكلمة المرور نفسهما.

لإيقاف مصادقة JMX لاحقًا، استخدِم الأمر:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -e n

خادم الإدارة

استخدام JConsole لمراقبة فحص حالة النظام ومعالجة المعلومات

استخدِم JConsole (أداة متوافقة مع JMX) لإدارة ومراقبة فحص السلامة وإحصاءات العمليات. باستخدام JConsole، يمكنك استخدام إحصاءات JMX التي يعرضها خادم الإدارة (أو أي خادم) وعرضها في واجهة رسومية. لمزيد من المعلومات حول استخدام JConsole، يُرجى الاطّلاع على http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

استخدِم JConsole وعنوان URL للخدمة التالي لمراقبة سمات JMX (MBeans) المقدَّمة عبر JMX.

service:jmx:rmi:///jndi/rmi://<ip address>:<port>/jmxrmi

حيث يكون <ip address> هو عنوان IP الخاص بخادم الإدارة (أو الخادم المعني). يكون المنفذ التلقائي هو 1099 لخادم الإدارة.

يعرض الجدول التالي إحصاءات JMX العامة:

JMX MBeans	سمات JMX
الذاكرة	HeapMemoryUsage
	NonHeapMemoryUsage
	الاستخدام
ملاحظة: سيتم عرض قيم السمات في أربع قيم: committed وinit وmax وused.

استخدام عمليات التحقّق من واجهة برمجة تطبيقات Edge Application

يمكنك إجراء فحص لواجهة برمجة التطبيقات على خادم الإدارة (أو أي خادم) من خلال استدعاء أمر CURL التالي:

curl http://<host>:8080/v1/servers/self/up

حيث يكون <host> هو عنوان IP لخادم الإدارة.

يعرض هذا الطلب "صحيح" و "خطأ". إذا كانت القيمة "صحيح"، يعني ذلك أنّ العقدة تعمل وأنّ خدمة Java قيد التشغيل.

إذا لم تتلقَّ استجابة HTTP 200 (OK)، يعني ذلك أنّ جهاز Edge غير قادر على الاستجابة لطلبات المنفذ 8080.

تحديد المشاكل وحلّها

سجِّل الدخول إلى الخادم وشغِّل الأمر التالي:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server status
إذا لم تكن الخدمة قيد التشغيل، ابدأ الخدمة:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start

استخدام Edge التطبيق: عمليات التحقّق من المستخدمين والمؤسسة والنشر

يؤدي خادم الإدارة دورًا حيويًا في تجميع كل الحزم الأخرى معًا في كل عملية تثبيت على الجهاز. يمكنك التحقّق من حالة المستخدم والمؤسسة والنشر على خادم الإدارة من خلال إصدار الأوامر التالية:

curl -u userEmail:password http://localhost:8080/v1/users
curl -u userEmail:password http://localhost:8080/v1/organizations
curl -u userEmail:password http://localhost:8080/v1/organizations/orgname/deployments

من المفترض أن يعرض النظام الحالة "تم النشر" لجميع المكالمات. إذا لم تنجح هذه الخطوات، يُرجى اتّباع ما يلي:

تحقَّق من سجلّات خادم الإدارة (على opt/apigee/var/log/edge-management-server) بحثًا عن أي أخطاء.
أجرِ مكالمة مع خادم الإدارة للتحقّق مما إذا كان يعمل بشكل صحيح.
أزِل الخادم من ELB ثم أعِد تشغيل خادم الإدارة.
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

جهاز التوجيه

يمكنك إجراء فحص واجهة برمجة التطبيقات على جهاز التوجيه (أو أي خادم) من خلال استدعاء أمر CURL التالي:

curl http://<host>:8081/v1/servers/self/up

حيث يكون المضيف هو عنوان IP الخاص بجهاز التوجيه.

يعرض هذا الطلب "صحيح" و "خطأ". إذا كانت القيمة "صحيح"، يعني ذلك أنّ العقدة تعمل وأنّ خدمة "الموجّه" قيد التشغيل.

إذا لم تتلقَّ استجابة HTTP 200 (OK)، يعني ذلك أنّ Edge لا يمكنه الاستجابة لطلبات المنفذ 8081.