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

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

תיאור הבעיה

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

• כשלים במהלך ההפעלה של שרתי הניהול
• כשלים בפריסה
• שגיאות במאגר הנתונים בממשק המשתמש החדש של Edge
• בעיות בקישוריות בין מרכזי נתונים שונים בין מעבדי הודעות ושרתי ניהול
• לא מוצגים נתונים ב-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, מריצים את הקריאות הבאות ל-Management 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 בכל רכיב ומוודאים שהם תואמים למה שמופיע בעץ 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 Agent

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

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

רזולוציה

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