בעיות נתונים של שומר גן

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

תיאור הבעיה

בעיות שקשורות לנתונים, שלרוב מכונות בעיות בחיווט, יכולות להתבטא באחד מהתסמינים הבאים:

• כשלים במהלך ההפעלה של שרתי הניהול
• כשלים בפריסה
• שגיאות של מאגר הנתונים בממשק המשתמש
• בעיות בקישוריות בין מרכזי נתונים שונים אצל מעבדי הודעות ושרתי ניהול
• לא מוצגים נתונים ב-Analytics

הבעיות האלה לא קשורות לתשתית שלzoKeeper, אלא לנתונים לא חוקיים שזמינים בעץ שלzoKeeper.

גורמים אפשריים

הסיבות האופייניות לבעיה הזו הן:

1. צמתים חוטו לאזור שגוי או לשם pod במהלך ההתקנה בגלל טעויות בקובץ ההתקנה השקט.
2. התקנה שנכשלה של רכיב יוצרת רישומים כפולים כאשר אתם מתקינים מחדש את הרכיב מספר פעמים. במקרה כזה, נדרש ניקוי כדי להסיר את הרישום עם מזהי UUID הלא נכונים.

אבחון

כדי לאבחן, יש לאסוף את הנתונים הבאים:

1. תרשים טופולוגיה, עם שם המארח וכתובות ה-IP של כל צומת ורכיב Apigee שקיים בצומת. מיפוי כמו בדוגמה הבאה באמצעות הפרופיל של התקנת Apigee יהיה שימושי ביותר:

   DC-1
   DS: ip1 hostname
   DS: ip2 hostname
   DS: ip3 hostname
   MS: ip4 hostname
   RMP: ip5 hostname
   RMP: ip6 hostname
   SAX: ip7 hostname
   
   DC-2
   DS: ip8 hostname
   DS: ip9 hostname
   DS: ip10 hostname
   MS: ip11 hostname
   RMP: ip12 hostname
   RMP: ip13 hostname
   SAX: ip14 hostname
   

2. יוצרים פלט של עץ גן החיות כדי לבדוק את החיווט:

   /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh > zk-tree-output.txt
   

3. כדי שיהיה לכם קל לאמת את הנתונים בעץ שלzoKeeper, תוכלו להריץ את הקריאות הבאות לממשק ה-API לניהול כדי לקבל את הרשימה של מזהי ה-UUID של השרת בכל אחד ממרכזי הנתונים:

   שרתי שער

   curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=gateway&region=region-name"
   

   שרתים מרכזיים

   curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=central&region=region-name"
   

   שרתים ל-Analytics

   curl -u sysadmin@email.com "http://management-server-host:8080/v1/servers?pod=analytics&region=region-name"
   

4. צריך לבדוק את מזהי ה-UUID בכל רכיב ולוודא שהם תואמים למה שמופיע בעץ של zoKeeper:

   נתב

   curl 0:8081/v1/servers/self/uuid
   

   מעבד הודעות

   curl 0:8082/v1/servers/self/uuid
   

   סוכן Qpid

   curl 0:8083/v1/servers/self/uuid
   

   סוכן Postgres

   curl 0:8084/v1/servers/self/uuid
   

5. משתמשים בנתוני ה-UUID כדי לחפש בפלט העץ שלzoKeeper שנוצר בשלב 2, כדי לאמת את החיווט של הרכיבים ולהסיר רישומים כפולים של הרכיב שיש בהם מזהי UUID שגויים.
6. כדי לתקן את הרישום של מאגר הנתונים, אפשר להשתמש בקריאות ל-API לניהול שרשומות כאן. הרכיבים כמו נתבים, מעבדי הודעות, מעבדי הודעות, Postgres ורישום עצמי של Qpid ל-ZooKeeper בזמן ההפעלה.

רזולוציה

יש לטפל בבעיות הקשורות לנתונים ב-ZooKeeper על בסיס כל מקרה לגופו. הנתונים ב-ZooKeeper מבוססים על הטופולוגיות של Apigee Edge ומשתנים בהתאם לתרחיש השימוש. אם נתקלתם באחת מתסמינים של הבעיה, עליכם לאסוף את הנתונים כפי שמוסבר בסעיף הקודם ולפנות לתמיכה של Apigee Edge.