הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של
Apigee Edge
Apigee תומך בשתי גישות לבדיקת תקינות. האפשרות הנכונה לכם תלויה באופן שבו תנועת הלקוחות מגיעה אל Apigee.
-
בדיקת תקינות פעילה: לארכיטקטורות שבהן תנועת הלקוחות מנותבת אל Apigee דרך Google Cloud מאזן עומסים שמגובה בקבוצת מופעי מכונה מנוהלים (MIG). מאזן העומסים (או הלקוח) בודק באופן פעיל את אחד מנקודות הקצה
/healthz/*כדי לקבוע את תקינות המופע או הסביבה, ומאזן העומסים מבצע מעבר אוטומטי בין אזורים. אם הארכיטקטורה שלכם משתמשת ב-MIG, צריך להמשיך להשתמש בבדיקת תקינות פעילה. - בדיקת תקינות של PSC: לארכיטקטורות שבהן תעבורת הלקוחות מנותבת אל Apigee דרך Private Service Connect (PSC). מערכת Apigee עוקבת אחרי המקרים האזוריים בשבילכם ומעדכנת באופן אוטומטי את מצב התקינות בכל אזור. לא נדרשים בדיקות תקינות שמופעלות על ידי לקוח או מאזן עומסים. אם הארכיטקטורה שלכם משתמשת ב-PSC, צריך להפעיל את בדיקת התקינות של PSC.
אפשר לבחור כרטיסייה כדי לקבל מידע נוסף.
בדיקת תקינות פעילה
Apigee חושף בדיקות תקינות פעילות ברמות שונות, שאפשר להשתמש בהן בהתאם לתרחיש השימוש.
- בדיקת תקינות ברמת האזור או ברמת מופע Apigee: מחזירה את התקינות של מופע Apigee כולל באזור מסוים.
- בדיקות תקינות ברמת הסביבה: מחזירה את התקינות של סביבה מסוימת במופע Apigee.
- בדיקת תקינות מותאמת אישית דרך proxy ל-API: בתרחישי שימוש מורכבים, אפשר להגדיר proxy ל-API ייעודי כנקודת קצה מותאמת אישית לבדיקת תקינות.
ביצוע בדיקת תקינות ברמה אזורית
Apigee מציע בדיקת תקינות ברמת האזור או ברמת מופע Apigee, כדי להעריך את הסטטוס הכללי של מופע Apigee באזור מסוים. דפוס בדיקת התקינות הזה, שנמצא בשימוש נרחב במאזני עומסים, קובע את סטטוס התקינות של מופעי Apigee ומבצע יתירות כשל אזורית. כדי לבצע בדיקת תקינות ברמת האזור, צריך ליצור את הבקשה באופן הבא:
- נתיב בדיקת תקינות:
/healthz/ingress - הוספת כותרת בקשה:
User-Agent: GoogleHC.
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/ingress Apigee Ingress is healthy
$HOST מייצג את שם המארח שמוגדר בקבוצת הסביבות של Apigee שמשרת מאזן העומסים.
ביצוע בדיקת תקינות ברמת הסביבה
Apigee מציע בדיקת תקינות ברמת הסביבה כדי להעריך את התקינות של סביבה מסוימת שמוגשת על ידי מופע Apigee. מומלץ להשתמש בדפוס הזה של בדיקת תקינות כשרוצים לבצע יתירות כשל אזורית על סמך התקינות של סביבות קריטיות או סלקטיביות מסוימות. כדי לבצע בדיקת תקינות ברמת הסביבה, צריך לקרוא לכל proxy ל-API תקף בסביבה. לשם כך, צריך ליצור את הבקשה באופן הבא:
- הוספת
/healthz/בתחילת נתיב הבסיס של ה-Proxy. - הוספת כותרת בקשה:
User-Agent: GoogleHC.
לדוגמה, נניח ש-/catalog הוא נתיב בסיס חוקי של שרת proxy שנפרס בסביבה. כדי לבצע בדיקת תקינות, קוראים לשרת ה-proxy כך:
$ curl -H 'User-Agent: GoogleHC' https://$HOST/healthz/catalog Server Ready
$HOST מייצג את שם המארח שמוגדר בקבוצת הסביבות של Apigee שמשרת מאזן העומסים.
ביצוע בדיקת תקינות בהתאמה אישית באמצעות proxy ל-API
אם רוצים לבצע אימותים נוספים, אפשר להגדיר לוגיקה מותאמת אישית לבדיקת תקינות ב-proxy ל-API שנפרס בסביבה. לדוגמה, יכול להיות שהבדיקה תכשל אם כמה סביבות לא פעילות. או שהבדיקה תכשל על סמך בריאות היעד או זמן האחזור.
במקרה כזה, אפשר לבצע את בדיקת התקינות על ידי ביצוע קריאה רגילה ל-API של השרת הפרוקסי.
לדוגמה, נניח שרוצים לבדוק את תקינות הסביבה שנקראת prod.
פורסים proxy ל-API בסביבה הזו עם נתיב בסיס /healthcheck-prod.
כדי לבדוק את תקינות סביבת prod שמוצגת על ידי מופע Apigee, צריך להפעיל את ה-proxy באופן הבא:
$ curl https://$HOST/healthcheck-prod
$HOST מייצג את שם המארח שמוגדר בקבוצת הסביבות של Apigee שמשרת מאזן העומסים.
הערות שימוש
בבדיקות תקינות ברמת האזור וברמת הסביבה: אם הבדיקות מבוצעות על ידי מאזני העומסים של Google Cloud, מאזן העומסים מגדיר את הכותרת הנכונה User-Agent. אם הלקוח שלכם צורך את הקריאות האלה ל-API של בדיקת תקינות, אתם צריכים לוודא שהערך הנכון של User-Agent מוגדר.
ב-Apigee Hybrid: התכונה של בדיקת התקינות זמינה רק בגרסה 1.4 ומעלה.
בדיקת תקינות של PSC
Apigee תומך בבדיקת תקינות באמצעות Private Service Connect (PSC), מה שמאפשר מעבר אוטומטי לגיבוי באזור אחר לפריסות בכמה אזורים. אם יש לכם כמה מופעי Apigee בכמה אזורים, אתם יכולים להפעיל בדיקות תקינות של PSC כדי שתעבורת הנתונים תעבור אוטומטית לאזור תקין אם מופע Apigee באזור הפעיל יהפוך ללא תקין. לא נדרשת בקשה מהלקוח או ממאזן העומסים כדי להפעיל את הבדיקה. Google Cloud מנטר את המופע באופן רציף בשמכם ומעדכן את מצב התקינות באופן אוטומטי.
תכונת בדיקת התקינות של PSC מוגדרת ב-Apigee backend. אין צורך לפרוס משאבים נוספים, לכתוב קוד או לשנות את פרוקסי ה-API.
דרישות מוקדמות
- יש לכם ארגון Apigee עם תשלום לפי שימוש או מינוי.
- בארגון שלכם יש שתי דוגמאות או יותר של Apigee, כל אחת באזור Google Cloud אחר.
- תעבורת הלקוחות מגיעה אל Apigee דרך Private Service Connect (PSC).
- כל סביבה, קבוצת סביבות, שרת proxy של API, רכיב זרימה משותף ומשאב נפרסים באופן זהה בכל מופעי Apigee שמשתתפים במעבר לשירות גיבוי. פריסות לא עקביות עלולות לגרום להתנהגות בלתי צפויה כשמתבצעת העברה של תנועת הגולשים בין אזורים.
איך מפעילים את התכונה
בדיקת תקינות של PSC היא תכונה אופציונלית שמנוהלת על ידי Google. כדי לבקש הפעלה לארגון שלכם, צריך לפנות לצוות ניהול החשבון של Apigee או לתמיכה של Apigee. אם ההגדרה הזו מופעלת, מעבר אוטומטי לגיבוי אזורי פעיל לכל המקרים בארגון. אין צורך בהגדרות נוספות.
בדיקת ההמלצות
בדיקת תקינות של PSC מציגה מעבר מיידי ואוטומטי לגיבוי אזורי שמשפיע ישירות על ניתוב התנועה, ולכן מומלץ לבדוק את התכונה בסביבת Apigee שאינה סביבת ייצור לפני שמפעילים אותה בארגון הייצור. מוודאים שהמעבר לגיבוי והשחזור מתבצעים כמצופה בדפוסי התנועה של ממשק ה-API, ושהאפליקציות של הלקוח מטפלות במעבר בצורה שקופה.
כדי לדמות תרחיש של מעבר לגיבוי ולבדוק את ההגדרה, פנו לצוות החשבון שלכם ב-Apigee או לתמיכה ב-Apigee. הצוות יכול לעזור לכם ליצור תנאי כשל בסביבה מבוקרת, כדי שתוכלו לראות איך הגיבוי פועל לפני שתפעילו את התכונה בסביבת הייצור.
איך מעבר לגיבוי עובד
כשבדיקת תקינות של PSC קובעת שמופע Apigee באזור הפעיל לא תקין, תנועת הלקוחות מנותבת באופן מיידי ואוטומטי למופע Apigee תקין באזור אחר. כשהמופע הלא תקין חוזר לפעולה, התנועה חוזרת לאזור המקורי. המעבר לגיבוי והשחזור מתבצעים באופן שקוף לאפליקציות הלקוח.
מגבלות נוכחיות
- בשלב הזה, בדיקת תקינות של PSC מזהה רק הפסקות חשמל מלאות בתשתית אזורית. It does not trigger on incidents where traffic can still flow, even if the traffic is degraded in error rates or latency. אנחנו מתכננים להוסיף בדיקות תקינות ברמת הרכיב בגרסה עתידית.
אימות מצב התקינות ב-Cloud Logging
אפשר לראות את אירועי סטטוס התקינות של כל אזור בנפרד עבור מופעי Apigee ב-Cloud Logging. ב-Logs Explorer של פרויקט Google Cloud שמארח את הארגון שלכם ב-Apigee, מריצים את המסנן הבא:
resource.type="compute.googleapis.com/NetworkEndpointGroupV2"
מידע נוסף זמין במאמר בנושא מעקב אחרי יומני בדיקות תקינות מורכבות.
בכל אזור, בודקים את השדה healthState ברשומות היומן התואמות. הערך HEALTHY מציין שאפשר להגיע למופע Apigee באזור הזה והוא משרת תנועה. ערכים אחרים מציינים שבדיקת תקינות של PSC לא מעבירה כרגע תנועה לאזור הזה.