במאמר הזה מוסבר איך מתבצע רישום ביומן של נתוני התפעול של Secure Web Proxy, איך משתמשים במדדים של Cloud Monitoring API כדי לנתח את ביצועי השרת proxy, ואיך משתמשים במעקב מבוזר כדי לבחון את מחזורי החיים של הבקשות.
יומנים
Secure Web Proxy משתמש ב-Cloud Logging כדי לאפשר לכם לתעד מידע ולבצע משימות שונות בתחומים העיקריים הבאים:
מעקב ותאימות
- לאכוף תאימות לתקנות, לשפר את אבטחת הרשת ולספק ניראות לתנועת אתרים יוצאת שנשלחת ליעדים חיצוניים מותרים.
- שכבות בקרה וניראות חשובות על התנועה של עומסי העבודה.
- לקבל תובנות חשובות למעקב יעיל במרכז תפעול האבטחה (SOC).
- להשתמש ביומנים כדי לזהות ולעקוב אחרי אירועי אבטחה, כדי להגיב לאיומים באופן יזום.
פריסה והגדרה
- מעקב אחרי ההגדרה הראשונית של התשתית, יצירת חשבונות משתמשים ושינויים בהגדרות.
- כדי לוודא שהפריסה תתבצע בצורה חלקה ומאובטחת, כדאי לעקוב אחרי שגיאות אפשריות.
- להבין את ההשפעה של שינויים בכוונון המדיניות ולשפר את ההגנה.
סוגי היומנים
ב-Secure Web Proxy נעשה שימוש ב-Logging כדי לתעד ולאחסן את סוגי היומנים הבאים:
יומני ביקורת של Cloud: מתעדים שינויים אדמיניסטרטיביים וגישה לנתונים במשאבי Secure Web Proxy. היומנים האלה כוללים את הפרטים הבאים:
יומני ביקורת של פעילות אדמין לקריאות ל-API ולפעולות אחרות שמשנות את המשאבים של Secure Web Proxy, כמו שערים וכללי מדיניות. יומני פעילות אדמין מופעלים תמיד.
יומני ביקורת של גישה לנתונים, אם הם מופעלים.
יומני עסקאות של שרת proxy: מתעדים פרטים על בקשות לאחזור מהרשת ספציפיות שמעובדות על ידי Secure Web Proxy. היומנים האלה מספקים תובנות לגבי זרימת התנועה, אכיפת המדיניות והביצועים של המכונה של Secure Web Proxy. כשפורסים את המכונה של Secure Web Proxy בתור Agent Gateway, יומני הטרנזקציות ממשיכים להירשם במשאב במעקב הרגיל של
networkservices.googleapis.com/Gateway, והמטא-נתונים של הרצת סוכן ה-AI (agentGatewayInfo) מופיעים באופן אוטומטי.
הגדרת התראות ביומן
אתם יכולים להגדיר התראות לאירועים ש-Secure Web Proxy כותב ב-Logging, כמו דחיות תנועה או התאמות לכללים ספציפיים. במאמר הגדרת התראות מבוססות-יומנים מוסבר באופן כללי איך מגדירים את ההתראות האלה.
הנה כמה דוגמאות לשאילתות שאפשר להשתמש בהן כדי להגדיר התראות מבוססות-יומנים ל-Secure Web Proxy:
התראה על תנועה שנדחתה על ידי מדיניות Secure Web Proxy
כדי להפעיל התראה כשמדיניות Secure Web Proxy דוחה בקשה, משתמשים בשאילתה הבאה:
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests" resource.type="networkservices.googleapis.com/Gateway" jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action="DENIED"
מחליפים את PROJECT_ID במזהה של פרויקט היעד ב-Google Cloud .
התראה על תנועה שנדחתה על ידי כלל של Secure Web Proxy
כדי להפעיל התראה כשכלל ספציפי של Secure Web Proxy (למשל, my-specific-deny-rule) דוחה בקשה, משתמשים בשאילתה הבאה:
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests" resource.type="networkservices.googleapis.com/Gateway" jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action="DENIED" AND jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.name=~"projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/POLICY_NAME/rules/my-specific-deny-rule$"
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
REGION: האזור של המכונה של Secure Web Proxy -
POLICY_NAME: השם של מדיניות Secure Web Proxy
התראה על תנועה שנדחתה על ידי מדיניות הרשאות של Agent Gateway
כשפורסים את המכונה של Secure Web Proxy בתור Agent Gateway, משתמשים בשאילתה הבאה כדי להפעיל התראה כשמדיניות הרשאה דוחה את הבקשה מסוכן AI:
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests" resource.type="networkservices.googleapis.com/Gateway" jsonPayload.authzPolicyInfo.result="DENIED"
מחליפים את PROJECT_ID במזהה של פרויקט היעד ב-Google Cloud .
התראה על תנועה שהוגבלה על ידי מדיניות הגבלת קצב של יצירת בקשות בשירות
כדי להפעיל התראה כשמדיניות הגבלת קצב של יצירת בקשות בשירות מצמצמת בקשה, משתמשים בשאילתה הבאה:
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests" resource.type="networkservices.googleapis.com/Gateway" jsonPayload.rateLimitPolicyInfo.overallResult="THROTTLED"
מחליפים את PROJECT_ID במזהה של פרויקט היעד ב-Google Cloud .
התראה על בקשות עם זמן אחזור ארוך
כדי לקבל התראה כשבקשות חורגות מזמן אחזור מסוים, למשל חמש שניות, משתמשים בשאילתה הבאה:
logName="projects/'PROJECT_ID'/logs/networkservices.googleapis.com%2Fgateway_requests" resource.type="networkservices.googleapis.com/Gateway" latency >= "5s"
מחליפים את PROJECT_ID במזהה של פרויקט היעד ב-Google Cloud .
הצגת יומנים ב-Cloud Logging
נכנסים לדף Logs Explorer במסוף Google Cloud .
בוחרים את הפרויקט ב- Google Cloud .
בתפריטים הנפתחים, בוחרים את המשאב
networkservices.googleapis.com/Gatewayאו את המכונה של Secure Web Proxy.
מידע נוסף זמין במאמר שימוש ב-Logs Explorer.
דוגמאות לרשומות ביומן
בכל פעם ש-Secure Web Proxy מעבד בקשה, הוא יוצר רשומות מפורטות ביומן, עוקב אחרי הפעולות שלו ומתעד את כללי המדיניות שהוחלו. בדוגמאות הבאות מוסבר איך פועלים היומנים של Secure Web Proxy.
דוגמה לרשומה ביומן של אירוע אישור
ברשומת היומן הבאה אפשר לראות שמופע Secure Web Proxy יירט ובדק את תנועת ה-HTTPS של www.example.com, ואז אפשר לה להמשיך לאתר היעד. שמות המדיניות והכלל הם swp-policy ו-allow-port-443, בהתאמה.
| שדה | ערכים |
|---|---|
enforcedGatewaySecurityPolicy |
{
"requestWasTlsIntercepted": true,
"hostname": "www.example.com",
"matchedRules": [
{
"action": "ALLOWED",
"name": "projects/76537/locations/us-central1/gatewaySecurityPolicies/swp-policy/rules/allow-port-443"
}
]
} |
httpRequest |
{
"requestMethod": "GET",
"requestUrl": "https://www.example.com/",
"requestSize": "41",
"status": 200,
"responseSize": "1446",
"userAgent": "curl/7.74.0",
"remoteIp": "10.128.0.12:35418",
"serverIp": "93.184.216.34:443",
"latency": "0.051800s",
"protocol": "HTTP/2"
} |
resource |
{
"type": "networkservices.googleapis.com/Gateway",
"labels": {
"gateway_name": "multi-level-tlds",
"network_name": "projects/76537/global/networks/default",
"location": "us-central1",
"resource_container": "",
"gateway_type": "SECURE_WEB_GATEWAY"
}
} |
timestamp |
"2024-02-15T16:56:19.570534Z" |
severity |
"INFO" |
logName |
"projects/76537/logs/networkservices.googleapis.com%2Fgateway_requests" |
receiveTimestamp |
"2024-02-15T16:56:20.714988329Z" |
דוגמה לרשומה ביומן של דחייה
רשומת היומן הזו מראה שהמופע של Secure Web Proxy בדק את התנועה של www.example.com:443 ודחה את בקשת ה-HTTPS בגלל הכלל default_denied במדיניות של Secure Web Proxy.
| שדה | ערכים |
|---|---|
enforcedGatewaySecurityPolicy |
{
"hostname": "www.example.com:443",
"matchedRules": [
{
"name": "default_denied",
"action": "DENIED"
}
]
} |
httpRequest |
{
"requestMethod": "CONNECT",
"requestSize": "122",
"status": 403,
"responseSize": "141",
"userAgent": "curl/7.74.0",
"remoteIp": "10.128.0.12:36338",
"latency": "0.000133s",
"protocol": "HTTP/1.1"
} |
resource |
{
"type": "networkservices.googleapis.com/Gateway",
"labels": {
"gateway_type": "SECURE_WEB_GATEWAY",
"resource_container": "",
"location": "us-central1",
"network_name": "projects/gcp-1768/global/networks/default",
"gateway_name": "high-latency-repro"
}
} |
timestamp |
"2024-02-15T16:55:00.089727Z" |
severity |
"WARNING" |
logName |
"projects/gcp-1768/logs/networkservices.googleapis.com%2Fgateway_requests" |
receiveTimestamp |
"2024-02-15T16:55:04.456901833Z" |
דוגמה לרשומה ביומן של מדיניות הגבלת קצב של יצירת בקשות לשירות
ברשומת היומן הבאה אפשר לראות שהמכונה של Secure Web Proxy ויסתה בקשה כי הלקוח חרג מהמגבלה RateLimitPolicy (בשם rl-egress-policy) במסגרת rl_default_rpm_limit RateLimitBucket.
| שדה | ערכים |
|---|---|
rateLimitPolicyInfo |
{
"policies": [
{
"name": "projects/76537/locations/us-central1/rateLimitPolicies/rl-egress-policy",
"buckets": [
{
"bucket": "rl_default_rpm_limit",
"key": "spiffe://projects-123.global.workload.id.goog/ns/ns1/sa/hellomcp",
"result": "THROTTLED"
}
],
"result": "THROTTLED",
"details": "Default user rate limit rate exceeded client-side."
}
],
"overallResult": "THROTTLED"
} |
httpRequest |
{
"requestMethod": "POST",
"requestUrl": "https://example.com/v1/chat/completions",
"requestSize": "144",
"status": 429,
"responseSize": "85",
"userAgent": "curl/7.74.0",
"remoteIp": "10.128.0.12:35418",
"serverIp": "93.184.216.34:443",
"latency": "0.001200s",
"protocol": "HTTP/2"
} |
resource |
{
"type": "networkservices.googleapis.com/Gateway",
"labels": {
"gateway_type": "SECURE_WEB_GATEWAY",
"resource_container": "",
"location": "us-central1",
"network_name": "projects/76537/global/networks/default",
"gateway_name": "egress-swp-gateway"
}
} |
timestamp |
"2026-02-15T16:56:19.570534Z" |
severity |
"WARNING" |
logName |
"projects/76537/logs/networkservices.googleapis.com%2Fgateway_requests" |
receiveTimestamp |
"2026-02-15T16:56:20.714988329Z" |
מעקב מבוזר באמצעות Cloud Trace
Secure Web Proxy תומך במעקב מובנה אחרי בקשות מבוזרות שמשולב עם Trace.
קורלציה בין יומנים למעקבים
כל רשומה ביומן של טרנזקציות שרת proxy שנכתבת ב-Logging כוללת שדה trace שמכיל את מחרוזת המשאב של Google Cloud trace:
<pre class="devsite-click-to-copy">
"trace": "projects/PROJECT_ID/traces/TRACE_ID"
</pre>
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
TRACE_ID: מזהה מעקב של 128 ביט (32 תווים בבסיס הקסדצימלי) מהלקוח או מטווח המעקב. לדוגמה,4bf92f3577b34da6a3ce929d0e0e4736.
אפשר להשתמש במזהה המעקב הזה כדי להתאים בין רשומות ביומן לבין טווחי המעקב התואמים:
- מיומנים למעקבים: ב-Logs Explorer, לוחצים על השדה
traceשל רשומת יומן כלשהי ובוחרים באפשרות View trace details כדי לפתוח את מפל הבקשות המלא ב-Trace. - ממעקבים ליומנים: ב-Trace, לוחצים על Show logs בחלונית Trace Details כדי לראות את כל יומני העסקאות של שרת ה-proxy שמשויכים למעקב.
מידע נוסף זמין במאמר מעקב מבוזר באמצעות Trace.
מדדים
המדדים של Cloud Monitoring API עוזרים לכם לעקוב אחרי הביצועים, התקינות והשימוש במכונות של Secure Web Proxy.
משאב במעקב
המדדים של Secure Web Proxy מיוצאים במסגרת המשאב הבא במעקב:
-
networkservices.googleapis.com/Gateway: מייצג מופע של שער Secure Web Proxy.
בטבלה הבאה מפורטים המשאבים הזמינים ל-networkservices.googleapis.com/Gateway. אתם יכולים להשתמש במשאבים האלה כדי לסנן ולצבור את נתוני המעקב.
| תווית | תיאור |
|---|---|
resource_container |
מזהה הפרויקט שמשויך למכונה של שער הגישה של Secure Web Proxy. |
location |
Google Cloud : האזור שבו נפרס שער הכניסה. |
gateway_id |
שם ייחודי של המכונה של שער Secure Web Proxy. |
gateway_type |
סוג השער, שמוגדר כ-SECURE_WEB_GATEWAY. |
network_name |
השם של רשת הענן הווירטואלי הפרטי (VPC) שמשויכת לשער. |
המדדים הזמינים
המדדים הבאים זמינים למשאב Gateway. כל המדדים מתחילים ב-networkservices.googleapis.com/https/.
| סוג מדד | השם המוצג | סוג, סוג, יחידה | תיאור |
|---|---|---|---|
networkservices.googleapis.com/https/request_count |
מספר הבקשות | DELTA, INT64, 1 |
המספר הכולל של הבקשות שעובדו על ידי שרת ה-proxy. |
networkservices.googleapis.com/https/request_bytes_count |
גודל הבקשה (בייטים) | DELTA, INT64, By |
המספר הכולל של בייטים שהתקבלו בבקשות. |
networkservices.googleapis.com/https/response_bytes_count |
בייטים של תגובה | DELTA, INT64, By |
מספר הבייטים הכולל שנשלחו בתגובות. |
networkservices.googleapis.com/https/total_latencies |
זמני האחזור הכוללים | DELTA, DIST, ms |
הזמן שחלף מרגע קבלת הבייט הראשון של הבקשה ועד לשליחת הבייט האחרון של התגובה. |
networkservices.googleapis.com/https/backend_latencies |
זמני האחזור של הקצה העורפי | DELTA, DIST, ms |
הזמן שחלף מרגע שליחת הבקשה לקצה העורפי ועד לקבלת הבייט הראשון של התגובה. |
יצירת מרכז בקרה בהתאמה אישית
כדי ליצור מרכז בקרה בהתאמה אישית להצגת הביצועים ומגמות התנועה של המכונות של Secure Web Proxy, מבצעים את הפעולות הבאות:
נכנסים לדף Dashboards במסוף Google Cloud .
לוחצים על יצירת מרכז בקרה בהתאמה אישית.
לוחצים על Add widget ובוחרים באפשרות התרשים Line.
בשדה Metric, מחפשים את
networkservices.googleapis.com/https/request_count.בשדה Filter, אפשר לסנן לפי
gateway_idאם הגדרתם כמה מכונות של Secure Web Proxy.בקטע Aggregation, מגדירים את Alignment Period לערך
1 minuteובוחרים אתrateבשביל Aligner.הפעולה הזו ממירה את נתוני הבקשות הגולמיים לשיעור בקשות לשנייה, וכך קל יותר לראות ולנתח מגמות עקביות בתנועה לאורך זמן.
כדי לשמור את הווידג'ט, לוחצים על אישור.
המאמרים הבאים
- סקירה כללית על מעקב מבוזר
- מעקב אחרי תנועה יוצאת באמצעות Trace
- רישום ביומן הביקורת של Secure Web Proxy
- צפייה ביומני הטרנזקציות של שרת ה-proxy