רישום ביומן ומעקב אחר קריאות ל-Secure Web Proxy

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

רישום ביומן

ב-Secure Web Proxy נעשה שימוש ב-Logging כדי לתעד ולאחסן כמה סוגים של יומנים, כולל כאלה שקשורים לתוספים. למידע נוסף על רישום ביומן של Secure Web Proxy, קראו את המאמר יומנים.

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

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

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

שדה סוג תיאור
backend_target_name מחרוזת השם של יעד הקצה העורפי של התוסף.
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), למאזני עומסים פנימיים אזוריים של אפליקציות ולמאזני עומסים פנימיים חוצי-אזורים של אפליקציות.
resource מחרוזת שם המשאב של התוסף

מעקב

למידע על מדדי מעקב של Secure Web Proxy, קראו את המאמר מדדים זמינים.

בגרסת טרום-השקה (Preview), אתם יכולים לעקוב אחרי המדדים הבאים של תוספים בכל הסוגים של מאזני עומסים של אפליקציות. למדדים האלה יש את הקידומת 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 ‫Extension failed invocations with 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
מספר הבייטים שהתקבלו מהתוסף.