סקירה כללית על תגובות שגיאה מותאמות אישית

מאזני עומסים גלובליים חיצוניים של אפליקציות מאפשרים לכם להתאים אישית את תגובות השגיאה שלכם כשנוצר קוד מצב שגיאה ב-HTTP ‏ (4xx ו-5xx). אפשר להתאים אישית את תגובות השגיאה לשגיאות שנוצרות על ידי איזון העומסים וגם על ידי מופעי הקצה העורפי. אפשר גם להתאים אישית את תגובות השגיאה לקודי תגובת שגיאה שנוצרים כש-Google Cloud Armor דוחה תעבורה.

הנה דוגמה לדף שגיאה בהתאמה אישית שבו אפשר להגדיר תגובות לשגיאות באפליקציית הצרכנים החיצונית שלכם עם המיתוג וסמל הלוגו של החברה, קישורים לדפים קשורים והודעות בהתאמה אישית.

דף שגיאה מותאם אישית בתגובת HTTP.
דף תגובה מותאם אישית לשגיאת HTTP

באמצעות מדיניות מותאמת אישית לתגובות שגיאה, אפשר להגדיר תגובות שגיאה שונות לקודי סטטוס שונים של שגיאות HTTP, לדומיינים של כתובות URL, לנתיבים של כתובות URL ולשדות של כותרות ופרמטרים של בקשות HTTP.

החזרת תגובות שגיאה מותאמות אישית עוזרת לשפר את חוויית המשתמשים שלכם, כי היא מאפשרת לכם:

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

אם לא מגדירים מדיניות תגובת שגיאה מותאמת אישית, מוצג אובייקט שגיאה גנרי בלי קשר למותג, כמו שמוצג באיור 2.

דף תגובת שגיאת HTTP כללי.
דף תגובה כללי לשגיאת HTTP

תרחישים לדוגמה

התכונה 'תשובות שגיאה בהתאמה אישית' מתאימה לתרחישי שימוש רבים. בקטע הזה מפורטות כמה דוגמאות כלליות.

הגדרה של דף תחזוקה משלכם

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

הגדרת דף שגיאה משלכם כברירת מחדל

אתם יכולים להגדיר תשובות שגיאה מותאמות אישית לפי קודי שגיאה ספציפיים. לדוגמה, אפשר להגדיר דף שגיאה עם ההודעה 'כניסה או הרשמה' לקוד תגובת HTTP‏ 401 (Unauthorized). אפשר גם להגדיר דף שגיאה שמופיע כברירת מחדל ומכיל את המיתוג של החברה ופרטים רלוונטיים אחרים לכל קודי שגיאת HTTP מסדרות 4xx ו-5xx.

הגדרת תגובות לשגיאות בכללי אבטחה

אתם יכולים להחזיר דף שגיאה מותאם אישית לקודי תגובה לשגיאה שנוצרים כשמדיניות האבטחה של Cloud Armor דוחה תעבורה. צריך לוודא שהגדרתם את דף השגיאה עם אותו קוד שגיאת HTTP מסדרה 4xx או מסדרה 5xx שהזנתם בכלל האבטחה של Cloud Armor.

צמצום ההשפעה של זמן ההשבתה

במקרים הרלוונטיים, אתם יכולים להגדיר תגובת שגיאה שתחזיר קוד סטטוס 200 (OK) HTTP ותציג דף אינטרנט סטטי, כדי שהמשתמשים יראו מידע הקשרי ומועיל יותר במקום דף שגיאה במהלך ההשבתה.

התאמה אישית של תגובות לשגיאות על סמך סוג הבקשה של הלקוח

אפשר להתאים אישית תגובה לשגיאה על סמך כותרות ופרמטרים של בקשת HTTP – לדוגמה, הכותרת Content-Type. כשמנתבים את הבקשה המקורית לשירות השגיאות, הניתוב יכול להתבסס על הכותרת Content-Type כדי להציג דף אינטרנט (לבקשות מדפדפנים) או JSON (לבקשות מ-API לאינטרנט).

איך פועלת מדיניות מותאמת אישית בנושא תגובות לשגיאות

אפשר להגדיר מדיניות מותאמת אישית לתגובה לשגיאות בשלוש רמות של משאב מפת URL: ברמת מאזן העומסים, ברמת הדומיין של כתובת ה-URL וברמת נתיב כתובת ה-URL.

  • ברמת מאזן העומסים. המדיניות חלה על כל התנועה שמתקבלת במאזן העומסים.

  • רמת הדומיין של כתובת ה-URL. המדיניות חלה על תנועה שמופנית לשם דומיין או לשם מארח ספציפיים – לדוגמה, www.example.com.

  • רמת נתיב כתובת ה-URL. המדיניות חלה על תנועה שמופנית לנתיב ספציפי – למשל, www.example.com/images/*. ברמה הזו, אפשר גם להשתמש בתנאי התאמה מתקדמים עם כותרות ופרמטרים של בקשות HTTP – לדוגמה, Content-Type:application/json.

בטבלה הבאה מוצגת מדיניות תגובה לשגיאה בהתאמה אישית שהוחלה ברמת מאזן העומסים, ברמת הדומיין של כתובת ה-URL וברמת הנתיב של כתובת ה-URL במפת URL.

רמת המדיניות שדה API
מאזן עומסים urlMaps.defaultCustomErrorResponsePolicy
הדומיין של כתובת ה-URL pathMatchers[].defaultCustomErrorResponsePolicy
נתיב כתובת ה-URL

pathMatchers[].pathRules[].customErrorResponsePolicy

pathMatchers[].routeRules[].customErrorResponsePolicy

אם מגדירים מדיניות מותאמת אישית לתגובה על שגיאה בכמה רמות של משאב מפת URL, מוחזר אובייקט השגיאה שצוין במדיניות המותאמת אישית לשגיאות ברמה הנמוכה ביותר של מפת URL. מדיניות תגובות לשגיאות שמוגדרת ברמה נמוכה יותר של מפת URL היא ספציפית יותר, ולכן היא מקבלת עדיפות על פני מדיניות תגובות לשגיאות שמוגדרת ברמה גבוהה יותר של מפת URL.

לדוגמה, מדיניות תגובת שגיאה מותאמת אישית ברמת איזון העומסים חלה רק אם המדיניות תואמת לתנאי השגיאה, ולא הוגדרה מדיניות תואמת לקוד השגיאה ברמות הנמוכות יותר – דומיין כתובת ה-URL או נתיב כתובת ה-URL. באופן דומה, מדיניות תגובת שגיאה מותאמת אישית ברמת הדומיין של כתובת ה-URL חלה רק אם המדיניות תואמת לתנאי השגיאה, ולא הוגדרה מדיניות תואמת לקוד השגיאה ברמה הנמוכה יותר – נתיב כתובת ה-URL. מידע נוסף על ההגדרה הזו זמין במאמר הגדרת מדיניות מפורטת של תגובות שגיאה מותאמות אישית עבור דומיינים, נתיבים וקודי תגובות שגיאה שונים.

ציון של כמה כללי תגובה לשגיאה כדי להתאים לקודי תגובה של שגיאת HTTP

בכל רמה במדיניות מותאמת אישית של תגובות לשגיאות, אפשר לציין כמה כללים של תגובות לשגיאות. הכללים האלה יכולים להתאים לתגובת שגיאת HTTP לפי קודי שגיאה ספציפיים או טווח של קודי שגיאה. אם מציינים כלל לטווח של קודי שגיאה וגם כללים לקודי שגיאה ספציפיים, הכללים עם קודי השגיאה הספציפיים מקבלים עדיפות.

לדוגמה, נניח שהגדרתם כלל לשגיאה עם קוד 401 (Unauthorized) וכלל נוסף לכל השגיאות עם קודים בסדרה 4xx. אם שירות הקצה העורפי מחזיר קוד שגיאה 401, יוחל הכלל שתואם לשגיאה 401. עם זאת, אם שירות לקצה העורפי מחזיר קוד שגיאה 403, הכלל לשגיאות 4xx נכנס לתוקף.

שינוי קוד תגובת ה-HTTP

כללי תגובת השגיאה מאפשרים לשנות את קוד תגובת ה-HTTP שמוחזר על ידי מאזן העומסים. המשמעות היא שאתם יכולים לבטל את קוד התגובה שנוצר על ידי השרת ולהגדיר מה יהיה קוד התגובה הסופי לבקשה. אפשר לציין להחזיר כל קוד תגובה של HTTP, כולל 200 (OK), סדרת 4xx או סדרת 5xx של קודי תגובה, או כל קוד תגובה אחר בן שלוש ספרות. מידע נוסף על שינוי קוד התגובה זמין במאמר הגדרת דף שגיאה לקוד שגיאה ספציפי עבור מארח ספציפי.

אם מגדירים קוד תגובה של החלפה, הוא נרשם כשדה חדש overrideResponseCodeServed ביומני איזון העומסים. השדה הזה מאוכלס רק בבקשות שבהן מדיניות תגובת השגיאה המותאמת אישית חלה על קוד תגובה חלופי.

הקוד status שנרשם בשדה httpRequest לא מושפע. הוא מתעד את קוד התגובה של HTTP שנוצר על ידי השרת או את תגובת ה-HTTP שמאזן העומסים מחזיר. יכול להיות שקוד הסטטוס הזה יהיה שונה מהקוד בפועל שמועבר ללקוח אם קוד התגובה משתנה על ידי מדיניות מותאמת לתגובות שגיאה.

שמירת תשובות שגיאה מותאמות אישית במטמון

אפשר לשמור במטמון תגובת שגיאה בהתאמה אישית על ידי ציון negative caching עבור ה-Backend שיצר את השגיאה. הסיבה לכך היא להחיל שליטה מדויקת על שמירה במטמון עבור שגיאות נפוצות או הפניות לכתובת אחרת. כך אפשר להפחית את העומס על מקורות התוכן ולשפר את חוויית המשתמש על ידי צמצום זמן האחזור של התגובה.

למדיניות negative caching שהוגדרה עבור ה-Backend שיצר את השגיאה תמיד יש עדיפות על פני המטא-נתונים Cache-Control שהוגדרו לאובייקט השגיאה בשירות השגיאות. בנוסף, אם מאזן העומסים מחזיר קוד תגובה של ביטול, negative caching מוחל על סמך הערך של קוד התגובה של הביטול, ולא על סמך קוד התגובה המקורי שהקצה העורפי החזיר למאזן העומסים. אם קוד שאינו קוד שגיאה (HTTP 200) מוחזר כקוד תשובה של ביטול, מדיניות שלילית של שמירה במטמון לא חלה.

אם אורך החיים (TTL) של תגובת השגיאה לא הסתיים, מאזן העומסים ממשיך להציג תוכן שנשמר במטמון בלי להפנות את הבקשה לשירות לקצה העורפי או לקטגוריית קצה עורפי. עם זאת, ההתנהגות הזו תלויה בשאלה אם Cloud CDN מופעל במאזן העומסים.

‫Cloud CDN מופעל במאזן העומסים

בקטע הזה מתואר אופן הפעולה של איזון העומסים כש-Cloud CDN מופעל ונעשה שימוש בתשובות שגיאה מותאמות אישית.

  1. כשמאזן העומסים מקבל בקשה, הוא בודק את המטמון של Cloud CDN. אם מאזן העומסים מוצא תגובה שנשמרה במטמון לבקשת המשתמש, מאזן העומסים מחזיר למשתמש את התגובה שנשמרה במטמון. התשובה הזו שנשמרת במטמון יכולה להיות התוכן שהמשתמש ביקש או אובייקט שגיאה מותאם אישית.

  2. אם אין פגיעה במטמון, מאזן העומסים מעבד את הבקשה ושולח אותה לקצה העורפי.

  3. אם ה-Backend מחזיר תגובה ללא שגיאה, התגובה הזו מוחזרת למשתמש הקצה. עם זאת, אם בקשת לקוח נתקלת בשגיאה (קוד תגובה מסוג 4xx או 5xx HTTP), מאזן העומסים מנסה לקבל את אובייקט השגיאה המותאם אישית משירות השגיאות שצוין באופן הבא:

    1. מאזן העומסים בודק את כל מדיניות התגובה לשגיאות בהתאמה אישית ומקבל את הנתיב המתאים של אובייקט השגיאה בהתאמה אישית שמתאים לקוד הסטטוס של השגיאה ולתנאי התאמה אחרים.

    2. מאזן העומסים מעביר את הבקשה לאובייקט השגיאה המותאם אישית לשירות השגיאות שצוין במדיניות התגובה לשגיאות מותאמות אישית. המונח שירות השגיאות מתייחס לקטגוריית קצה עורפי או לשירות לקצה העורפי שמציג את תוכן השגיאה המותאם אישית.

    3. מאזן העומסים מחזיר את אובייקט השגיאה המותאם אישית ללקוח ששלח את הבקשה. הוא גם שולח את האובייקט ל-Cloud CDN כדי לשמור במטמון את אובייקט השגיאה למשך הזמן שצוין על ידי cdnPolicy.negativeCachingPolicy[].ttl.

‫Cloud CDN מושבת במאזן העומסים

אם Cloud CDN מושבת, מומלץ להשתמש בקטגוריית קצה עורפי כשירות השגיאות ולא בשירות לקצה העורפי. הסיבה לכך היא ששירות לקצה העורפי לא יכול לשמור תוכן במטמון אם Cloud CDN מושבת. עם זאת, לקטגוריות קצה עורפי יש יכולת מובנית של שמירה במטמון, והן יכולות לשמור במטמון תגובות שגיאה גם אם Cloud CDN מושבת.

מגבלות

  • תשובות שגיאה מותאמות אישית נתמכות רק במאזן עומסים גלובלי חיצוני של אפליקציות (ALB). אין תמיכה במצבים אזוריים וקלאסיים.

  • אם אי אפשר לאחזר את אובייקט השגיאה המותאם אישית משירות השגיאות – למשל, אם נתיב התוכן לא מוגדר בצורה נכונה – יוחזר אובייקט שגיאה כללי ללא מיתוג.

  • מדיניות תגובת השגיאה המותאמת אישית לא עוקבת אחרי האובייקט שמוחזר על ידי שירות השגיאות ולא מסננת אותו כדי לזהות סיכוני אבטחה. לכן, חשוב להקפיד על סילוק נקודות חולשה ולהגביל את ההשפעה של חשיפה פוטנציאלית.

  • תשובות שגיאה בהתאמה אישית נתמכות רק בדלי Cloud Storage שניתן לקרוא אותם באופן ציבורי.

    כדי למנוע טעויות בהגדרות כשמשתמשים בקטגוריה של Cloud Storage, כדאי לעיין בשיטות המומלצות הנפוצות לשימוש ב-Cloud Storage.

  • תשובות שגיאה בהתאמה אישית לא פועלות אם מאזן העומסים הגלובלי החיצוני של אפליקציות כולל רק קטגוריות קצה עורפי. בנוסף לקטגוריית קצה עורפי, צריך שיהיה לכם לפחות שירות לקצה העורפי שמצורף למאזן העומסים.

  • כותרות תגובה בהתאמה אישית שהוגדרו על סמך המקור של תגובת השגיאה בהתאמה אישית לא חלות על תגובות יוצאות.

  • מדיניות התגובה לשגיאה בהתאמה אישית חלה רק על תגובות HTTP שמגיעות בפועל מהעורפים. אם התגובה מגיעה מ-Google Front End ‏ (GFE), יכול להיות שיוצגו קודי תגובת HTTP לא צפויים אחרים.

  • תשובות שגיאה מותאמות אישית לא תואמות לסוגי הבקשות הבאים:

    • בקשות עם גופים שמפעילים מדיניות של הזרקת תקלות.
    • בקשות גדולות שבהן שירות לקצה העורפי שולח תגובה לפני שהוא קורא את הגוף באופן מלא.
    • בקשות שכוללות כותרת Authorization. אם בקשה כוללת כותרת Authorization, ‏ Cloud Storage מחזיר תגובה Authentication Required.

תמחור

אין עלות נוספת לשימוש בתגובות שגיאה מותאמות אישית. יחול תמחור רגיל לאיזון עומסים. Google Cloud מידע נוסף מפורט בקטע תמחור.

המאמרים הבאים