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

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

רישום ביומן

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

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

מעקב

למידע על מדדים של Monitoring ל-Secure Web Proxy, ראו מדדים זמינים.

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