צפייה ביומני הטרנזקציות של שרת ה-proxy

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

סוגים של רשומות ביומן העסקאות של השרת הפרוקסי

יש שלושה סוגים של רשומות ביומן של שרת proxy:

היומנים האלה שימושיים לפעולות הבאות:

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

HttpRequest

רשומות היומן האלה מכילות את הפרטים הבאים:

שם סוג תיאור
requestMethod String סוג שיטת הבקשה, כמו GET,‏ HEAD,‏ PUT או POST.
requestUrl String הסכימה (http או https), שם המארח, הנתיב והחלק של השאילתה בכתובת ה-URL המבוקשת. לדוגמה, http://example.com/some/info?color=red.
requestSize

מחרוזת (פורמט int64)

 הגודל, בבייטים, של הודעת בקשת ה-HTTP, כולל כותרות הבקשה וגוף הבקשה.
status מספר שלם קוד סטטוס HTTP או HTTPS שמציין את התגובה. לדוגמה, 200 OK או 404 Not Found.
responseSize מחרוזת (פורמט int64) הגודל בבייטים של קוד סטטוס של HTTP שנשלח בחזרה ללקוח, כולל הכותרות והגוף.
userAgent String סוכן המשתמש שהלקוח שולח, למשל Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705).
remoteIp String כתובת ה-IP (מסוג IPv4 או IPv6) של הלקוח ששלח את בקשת ה-HTTP. השדה הזה יכול לכלול פרטי יציאה. לדוגמה, 192.168.1.1, 10.0.0.1:80, ו-FE80::0202:B3FF:FE1E:8329.
serverIp String כתובת ה-IP (מסוג IPv4 או IPv6) של שרת המקור שאליו נשלחה הבקשה. השדה הזה יכול לכלול פרטי יציאה. לדוגמה, 192.168.1.1, 10.0.0.1:80 ו-FE80::0202:B3FF:FE1E:8329.
referrer String כתובת ה-URL של מקור הבקשה, כפי שמוגדר ב-HTTP/1.1 Header Field Definitions.
latency מחרוזת (פורמט משך) השהיית עיבוד הבקשה בשרת, מהרגע שבו הבקשה התקבלה ועד שהתגובה נשלחה.

זמן האחזור הוא משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, והוא מסתיים ב-s, כמו 3.5s.
cacheLookup בוליאני מציין אם היה ניסיון לבצע חיפוש במטמון.
cacheHit בוליאני השדה הזה מציין אם ישות הוגשה מהמטמון (עם או בלי אימות).
cacheValidatedWithOriginServer בוליאני מציין אם התגובה אומתה בשרת המקור לפני שהיא הוגשה מהמטמון. השדה הזה רלוונטי רק אם הערך של cacheHit הוא True.
cacheFillBytes מחרוזת (פורמט int64) מספר הבייטים של קוד סטטוס של HTTP שמוכנסים.
protocol String הפרוטוקול שבו נעשה שימוש בבקשה, כמו HTTP/1.1,‏ HTTP/2 ו-websocket.

LoadBalancerLogEntry

רשומות היומן האלה מכילות את הפרטים הבאים:

שם סוג תיאור
insertId String מזהה יומן ייחודי.
jsonPayload.@type String סוג היומן. הערך של סוג היומן הוא תמיד type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry.
jsonPayload.enforcedGatewaySecurityPolicy.hostname String שם המארח שמשויך לבקשה.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action String הפעולה שבוצעה לגבי הבקשה.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.rule String שם הכלל שחל על הבקשה.
jsonPayload.enforcedGatewaySecurityPolicy.clientServiceAccount String חשבון השירות שמשויך לבקשה.
jsonPayload.enforcedGatewaySecurityPolicy.clientSecureTags String תגים מאובטחים שמשויכים לבקשה.

GatewayLogEntry

רשומות היומן האלה מכילות את הפרטים הבאים:

שם סוג תיאור
resource_container String מאגר התגים שמשויך לשער.
location String שם האזור שבו מוגדר השער.
network_name String השם של רשת הענן הווירטואלי הפרטי (VPC) שבה נוצר שער.
gateway_type String סוג השער. ב-Secure Web Proxy, הערך חייב להיות SECURE_WEB_GATEWAY.
gateway_name String השם של משאב השער.

הפורמט של יומני עסקאות של שרת proxy

יומני העסקאות של ה-proxy נכתבים ב-Cloud Logging עם שם היומן projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests.

מטען ה-JSON הייעודי של כל רשומה ביומן מכיל מידע מפורט על העסקה. הרשומות ביומן מכילות את השדות העיקריים הבאים:

שם סוג תיאור
destination_ip String כתובת ה-IP של היעד אחרי פתרון הבעיה.
instance String השם של מופע Secure Web Proxy שעיבד את הבקשה.
mtls_info אובייקט מידע על תהליך הלחיצה (handshake) של mTLS, אם רלוונטי.
policy_evaluation_results אובייקט מידע על הכללים שהתאימו ועל הפעולה שבוצעה כתוצאה מכך, כמו allow או deny.
request_host String שם המארח המבוקש.
request_method String ה-method של ה-HTTP, כמו GET או POST.
request_path String הנתיב של הבקשה.
request_port מספר שלם יציאת היעד.
request_protocol String גרסת פרוטוקול HTTP.
request_scheme String הסכימה של בקשת כתובת ה-URL, כמו http או https.
request_time חותמת הזמן התאריך והשעה שבהם השרת הפרוקסי קיבל את הבקשה. חותמת הזמן מוגדרת בפורמט ISO 8601: YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. לדוגמה: 2025-06-03T11:52:26.452Z.
response_code מספר שלם קוד סטטוס של HTTP שמוחזר ללקוח.
response_size מספר שלם גודל גוף התגובה, בבייטים.
response_time חותמת הזמן התאריך והשעה שבהם השרת הפרוקסי שלח את התשובה ללקוח. חותמת הזמן מצוינת בפורמט ISO 8601: YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. לדוגמה: 2025-06-03T11:52:26.452Z.
source_ip String כתובת ה-IP של הלקוח.
source_port מספר שלם יציאת המקור של הלקוח.
tls_cipher_suite String סט אלגוריתמים להצפנה (cipher suite) שמשמש לחיבור TLS.
tls_version String גרסת ה-TLS שמשמשת לחיבור.

מעקב אחרי יומני עסקאות של שרת proxy

  1. נכנסים לדף Logs Explorer במסוף Google Cloud .

    כניסה לדף Logs Explorer

  2. בוחרים את הפרויקט Google Cloud .

  3. כדי להציג את כל יומני העסקאות של Secure Web Proxy, משתמשים בשאילתה הבאה:

    logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"

    מחליפים את PROJECT_ID במזהה של פרויקט Google Cloud היעד.

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

    • למצוא את כל הבקשות שנדחו.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
jsonPayload.policy_evaluation_results.policy_action="DENY"

    • חיפוש בקשות מכתובת IP ספציפית של מקור.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
jsonPayload.source_ip="192.0.2.1"

    • חיפוש בקשות למארח ספציפי.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
jsonPayload.request_host="example.com"

ביצוע קורלציה בין יומני עסקאות של שרת proxy לבין Cloud Trace

כשהאפשרות 'מעקב מבוזר' מופעלת בשער Secure Web Proxy, אפשר לקשר בין רשומות ביומן העסקאות של ה-proxy לבין טווחי מעקב ב-Trace. כדי לעשות זאת, פועלים לפי השלבים הבאים:

  1. נכנסים לדף Logs Explorer במסוף Google Cloud .

    כניסה לדף Logs Explorer

  2. מרחיבים רשומה ביומן gateway_requests.

  3. מאתרים את השדה trace ברמה העליונה: 

      projects/PROJECT_ID/traces/TRACE_ID

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

    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
    • ‫TRACE_ID: מזהה מעקב באורך 128 ביט (32 תווים הקסדצימליים) מהלקוח או מטווח המעקב. לדוגמה, 4bf92f3577b34da6a3ce929d0e0e4736.

  4. לוחצים על כתובת ה-URL‏ trace ובוחרים באפשרות הצגת פרטי המעקב כדי לעבור ישירות לתרשים המפל של המעקב ב-Cloud Trace.

  5. כדי לסנן יומנים לפי מזהה מעקב מוכר מלקוח עם OpenTelemetry, מריצים את השאילתה הבאה ב-Logs Explorer:

    logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
trace="projects/PROJECT_ID/traces/TRACE_ID"

מידע נוסף זמין במאמרים סקירה כללית על מעקב מבוזר ומעקב אחר תנועה יוצאת באמצעות Cloud Trace.

ניתוב של יומני עסקאות של שרת proxy

אפשר לנתב יומני עסקאות של שרת proxy ליעדים אחרים כמו Cloud Storage,‏ BigQuery או Pub/Sub באמצעות יעד לניתוב יומנים. מידע נוסף זמין במאמר בנושא ניתוב של רשומות ביומן.

מה השלב הבא?