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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

תיאור הבעיה

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

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

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

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

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

1. הצמתים חווברו לאזור או לשם פוד שגויים במהלך ההתקנה בגלל טעויות בקובץ ההתקנה השקטה.
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. כדי לבדוק את החיבורים, יוצרים פלט של עץ ZooKeeper:

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

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

   Gateway Servers

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

   Central Servers

   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 בכל רכיב ומוודאים שהם תואמים למה שרואים בעץ ZooKeeper:

   נתב

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

   מעבד בקשות

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

   Qpid Agent

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

   סוכן Postgres

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

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

רזולוציה

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