רישום ביומן ומעקב אחר קריאות ל-Cloud Load Balancing

בדף הזה מוסבר איך להגדיר את Cloud Logging ו-Cloud Monitoring ולהשתמש בהם עם קריאות ל-Service Extensions ב-Cloud Load Balancing.

רישום ביומן

בקטע הזה מתואר הרישום ביומן של קריאות ל-Application Load Balancer.

הפעלת רישום ביומן בשירות קצה עורפי

אתם יכולים להפעיל רישום ביומן עבור קריאות ל-Application Load Balancer בזמן יצירת השירות, על ידי הפעלת רישום ביומן בשירות לקצה העורפי שהוא יעד של בקשה (ולא בשירות לקצה העורפי שמשויך לתוסף).

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

כדי להפעיל רישום ביומן עבור שירות לקצה העורפי של היעד, משתמשים בפקודה gcloud compute backend-services update.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-logging \
    --logging-sample-rate=RATE \
    --region=REGION \
    --logging-optional=LOGGING_OPTIONAL_MODE \
    --logging-optional-fields=OPTIONAL_FIELDS

מחליפים את מה שכתוב בשדות הבאים:

• ‫BACKEND_SERVICE: השם של שירות הקצה העורפי
• ‫RATE: ערך מ-0.0 עד 1.0, כאשר 0.0 מציין שלא מתבצעת רישום של בקשות ו-1.0 מציין שמתבצע רישום של 100% מהבקשות. ערך ברירת המחדל הוא 1.0. ההגדרה הזו תקפה רק כשמשתמשים בה עם הפרמטר enable-logging. אם לא מציינים את הערך enable-logging, הרישום ביומן מושבת.
• ‫REGION: האזור של ה-backend

• ‫LOGGING_OPTIONAL_MODE: מאפשר רישום ביומן של שדות אופציונליים באחד מהמצבים הבאים:

  • INCLUDE_ALL_OPTIONAL כולל את כל השדות האופציונליים.
  • ‫EXCLUDE_ALL_OPTIONAL (default) excludes all optional fields.
  • ‫CUSTOM: רשימה בהתאמה אישית של שדות אופציונליים.
• ‫OPTIONAL_FIELDS: רשימה מופרדת בפסיקים של שדות אופציונליים כשבוחרים במצב CUSTOM

אחרי שמפעילים את הרישום ביומן בשירות לקצה העורפי, בקשות HTTP או HTTPS נרשמות ביומן באמצעות בקשות ליומנים של Cloud Logging.

כדי לראות את היומנים, נכנסים לדף Logs Explorer במסוף Google Cloud .

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

הודעות יומן לשירות קצה עורפי

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

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

יומני הבקשות של מאזני עומסים מסוג HTTP ו-HTTPS מכילים אובייקט service_extension_info במטען הייעודי (payload) של JSON ביומן מאזן העומסים, עם המידע הבא:

שדה	סוג	תיאור
backend_target_name	מחרוזת	השם של יעד ה-backend של התוסף.
backend_target_type	מחרוזת	סוג היעד לקצה העורפי.
chain	מחרוזת	השם של שרשרת התוספים בשדה של משאב התוסף של השירות שתואם לבקשה.
extension	מחרוזת	השם של התוסף בשרשרת התוספים.
failed_open	בוליאני	אם ההגדרה של התוסף היא failOpen true, הערך true של המדד הזה מציין שהעיבוד נמשך כשזמן ההמתנה של התוסף הסתיים או כשהוא נכשל. ההגדרה הזו חלה רק על מאזני עומסים חיצוניים אזוריים של אפליקציות (ALB), מאזני עומסים פנימיים אזוריים של אפליקציות (ALB) ומאזני עומסים פנימיים של אפליקציות (ALB) שפועלים בכמה אזורים.
grpc_status	enum	הסטטוס האחרון בזרם gRPC. מידע נוסף זמין במאמר בנושא קודי סטטוס של gRPC.
per_processing_request_info	מערך	רשימה של נתוני ProcessingRequest לגבי תוספי ext_proc או נתוני CheckRequest לגבי תוספי ext_authz שמתרחשים בזרם gRPC.
per_processing_request_info[].event_type	enum	סוג האירוע של ProcessingRequest. אפשר להשתמש באחד מהערכים הבאים: REQUEST_HEADERS, REQUEST_BODY, RESPONSE_HEADERS או RESPONSE_BODY.
per_processing_request_info[].latency	משך	משך הזמן שחלף משליחת הבייט הראשון של ההודעה ProcessingRequest לתוסף ועד לקבלת הבייט האחרון של ההודעה ProcessingResponse.
per_processing_request_info[].processing_effect	enum	התוצאה של העיבוד לכל אירוע בבקשת עיבוד. ההגדרה הזו חלה רק על מאזני עומסים חיצוניים אזוריים של אפליקציות (ALB), מאזני עומסים פנימיים אזוריים של אפליקציות (ALB) ומאזני עומסים פנימיים של אפליקציות (ALB) שפועלים בכמה אזורים. יכול להיות אחד מהערכים הבאים: ‫NONE: מציין שהתוכן לא השתנה. ‫NONE_FAILED_OPEN: מציין שלא בוצעו מוטציות כי התוסף נכשל בפתיחה. ‫CONTENT_MODIFIED: מציין שהתוכן השתנה בעקבות בקשת מוטציה שהתקבלה. ‫IMMEDIATE_RESPONSE: מציין שהתוסף שלח תגובה מיידית כדי לעצור את כל העיבודים הנוספים. ‫MUTATION_REJECTED: מציין שהתוסף ביקש לפחות שינוי אחד שלא מותר, והעיבוד הופסק. הודעות שגיאה מתאימות נרשמות ביומן. ‫UNSPECIFIED: מציין שההשפעה של העיבוד לא ידועה.
per_processing_request_info[].processing_effect_details	מחרוזת	אם הערך של processing_effect הוא MUTATION_REJECTED, הפרטים על הסיבה לדחיית המוטציה. ההגדרה הזו חלה רק על מאזני עומסים חיצוניים אזוריים של אפליקציות (ALB), על מאזני עומסים פנימיים אזוריים של אפליקציות (ALB) ועל מאזני עומסים פנימיים של אפליקציות (ALB) שפועלים בכמה אזורים.
resource	מחרוזת	שם משאב התוסף

מעקב

בקטע הזה מוסבר איך לעקוב אחרי קריאות ל-callout שהוגדרו באמצעות Service Extensions ל-Cloud Load Balancing.

הצגת לוח בקרה של Monitoring

מאזני עומסים של אפליקציות מייצאים נתוני מעקב אל Cloud Monitoring.

אפשר להשתמש במדדי המעקב למטרות הבאות:

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

כדי לצפות במרכז בקרה מוגדר מראש:

1. נכנסים לדף Dashboards overview במסוף Google Cloud .

   מעבר לסקירה הכללית של מרכזי השליטה

2. בקטע Categories (קטגוריות), לוחצים על GCP.
   • כדי לראות רשימה של מרכזי בקרה עבור כל מאזני העומסים, ברשימה GCP Dashboards (מרכזי בקרה של GCP), לוחצים על מרכז הבקרה בשם Google Cloud Load Balancers (מאזני העומסים של Google Cloud). כדי לראות את לוח הבקרה של מאזן עומסים ספציפי, מאתרים את מאזן העומסים ברשימה ולוחצים על השם שלו.
   • כדי לראות את מרכזי הבקרה המוגדרים מראש רק עבור איזון העומסים שלכם, בוחרים את מרכז הבקרה המתאים.

בנוסף למרכזי הבקרה המוגדרים מראש ב-Monitoring, אתם יכולים ליצור מרכזי בקרה בהתאמה אישית, להגדיר התראות ולשאול שאילתות על המדדים באמצעות Cloud Monitoring API.

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

מעקב אחרי מדדים של קריאות למידע

אפשר לעקוב אחרי המדדים הבאים של שירותי קצה עורפיים של קריאות ל-API.

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

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

סוג המדד	השם המוצג סוג, יחידה תיאור
extension/invocation_count	מספר ההפעלות של התוסף DELTA, INT64, 1 מספר ההפעלות שנשלחו לתוסף.
extension/invocation_latencies	זמני האחזור של הפעלת התוסף DELTA, DISTRIBUTION, ms הפיזור שמחושב מזמן האחזור של כל הפעלה של התוסף.
extension/sent_chunks_count	מספר החלקים שנשלחו על ידי התוסף DELTA, INT64, 1 רלוונטי רק לאירועים request_body ו-response_body. מספר נתחי הנתונים שנשלחו לתוסף.
extension/received_chunks_count	מספר החלקים שהתקבלו בתוסף DELTA, INT64, 1 רלוונטי רק לאירועים מסוג request_body ו-response_body. מספר החלקים שהתקבלו מהתוסף.
extension/failed_open_count	הפעלות של תוסף נכשלו עם fail-open DELTA, INT64, 1 מספר הפעמים שהפעלה נכשלה כשהמערכת הוגדרה ל-fail open והבקשה הורשתה להמשיך.
extension/mutation_rejections_count	מספר הדחיות של שינוי תוסף DELTA, INT64, 1 מספר הקריאות שביקשו שינויים בכותרת, בגוף או בטריילר, אבל נדחו. יכולות להיות סיבות שונות לדחייה, למשל אם המוטציה לא תקינה או חורגת ממגבלות הגודל.
extension/sent_bytes_count	מספר הבייטים שנשלחו לתוסף ‫ DELTA, INT64, By מספר הבייטים שנשלחו לתוסף.
extension/received_bytes_count	מספר הבייטים שהתקבלו מהתוסף DELTA, INT64, By מספר הבייטים שהתקבלו מהתוסף.

אפשר גם לעקוב אחרי המדדים הבאים. המדדים האלה כוללים את הקידומת loadbalancing.googleapis.com/. הקידומת מושמטת מהערכים בטבלה.

סוג המדד	השם המוצג סוג, יחידה תיאור
https/backend_request_count, https/external/regional/backend_request_count, https/internal/backend_request_count	מספר הבקשות לקצה העורפי ‫ DELTA, INT64, 1 ‫ מספר הפעמים ששירות לקצה העורפי של callout מופעל מ-Application Load Balancer.
https/backend_request_bytes_count, https/external/regional/backend_request_bytes_count, https/internal/backend_request_bytes_count	בייטים של בקשות לקצה העורפי ‫ DELTA, INT64, By מספר הבייטים שנשלחו ממאזן העומסים לשירות הקצה העורפי של ה-callout.
https/backend_response_bytes_count, https/external/regional/backend_response_bytes_count, https/internal/backend_response_bytes_count	בייטים של תגובות מהקצה העורפי ‫ DELTA, INT64, By מספר הבייטים שמאזן העומסים קיבל מהקצה העורפי של התוסף.
https/backend_latencies, https/external/regional/backend_latencies, https/internal/backend_latencies	זמן האחזור של הקצה העורפי DELTA, DISTRIBUTION, ms התפלגות שמחושבת מסכום זמני האחזור של כל קריאה להפעלה של תוסף בין מאזן העומסים לבין שירות הקצה העורפי של ה-callout. המדדים נדגמים כל 60 שניות.

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

• הצגת הודעות ביומן של קריאות ל-API