דף זה תורגם על ידי Cloud Translation API.

איך לעקוב

Edge for Private Cloud גרסה 4.17.09

במסמך הזה מתוארות שיטות המעקב אחרי רכיבים שנתמכים על ידי מערכות מקומיות בפריסה של Apigee Edge.

הפעלת JMX

JMX מופעל כברירת מחדל עבור Cassandra ומושבת כברירת מחדל בכל שאר מכשירי Edge רכיבים. לכן צריך להפעיל JMX בנפרד לכל רכיב.

כל רכיב תומך ב-JMX ביציאה אחרת. הטבלה הבאה מפרטת את יציאת ה-JMX של הקובץ שמשנים כדי להפעיל JMX ביציאה הזאת:

רכיב	יציאת JMX	קובץ
שרת ניהול	1099	/opt/apigee/edge-management-server/bin/start
נתב	1100	/opt/apigee/edge-router/bin/start
מעבד בקשות	1101	/opt/apigee/edge-message-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 הוא End-management-server, End-message-processor, dge-qpid-server, או edge-postgres-server.
האפשרויות הן:
- -u: שם משתמש
- -p: סיסמה
- -e: y (הפעלה) או n (ניתנת לשיתוף)
קובץ התצורה כולל:
- JMX_USERNAME=שם משתמש
- JMX_Available=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
	שימוש
הערה: ערכי המאפיינים יוצגו בארבעה ערכים: commitment, init, מקסימום ו-used.

שימוש ב-Edge Application API בדיקות

כדי לבצע בדיקת API בשרת הניהול (או בכל שרת אחר), יש להפעיל את הפקודה הבאה: פקודת CURL:

curl http://<host>:8080/v1/servers/self/up -H "Accept: application/json"

כאשר <host> הוא כתובת ה-IP של שרת הניהול. אפשר לציין את סוג ההסכמה כ-application/json או כ-application/xml.

הקריאה מחזירה את הערך "true" ו-"false". אם הערך הוא True, המשמעות היא שהצומת הגיע ושירות Java ריצה.

אם לא מתקבלת תגובה מסוג HTTP 200 (OK), ממשק Edge לא יכול להגיב ליציאה 8080 בקשות.

פתרון בעיות

צריך להתחבר לשרת ולהריץ את הפקודה הבאה:
/opt/apigee/apigee-service/bin/apigee-service סטטוס שרת ניהול הקצה
אם השירות לא פועל, אפשר להפעיל את השירות:
/opt/apigee/apigee-service/bin/apigee-service התחלת שרת-ניהול קצה

שימוש ב-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 הפעלה מחדש של שרת ניהול הקצה

נתב

אפשר לבצע בדיקת API בנתב (או בכל שרת אחר) על ידי הפעלה של ה-CURL הבא הפקודה:

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

כאשר המארח הוא כתובת ה-IP של הנתב.

הקריאה מחזירה את הערך "true" ו-"false". אם הערך הוא True, המשמעות היא שהצומת למעלה והנתב השירות פועל.

אם לא מתקבלת תגובה מסוג HTTP 200 (OK) , Edge לא יכול להגיב ליציאה 8081 בקשות.