יומנים, מדדים ועקבות

במאמר הזה מוסבר איך מתבצע רישום ביומן של נתוני התפעול של Secure Web Proxy, איך משתמשים במדדים של Cloud Monitoring API כדי לנתח את ביצועי השרת proxy, ואיך משתמשים במעקב מבוזר כדי לבחון את מחזורי החיים של הבקשות.

יומנים

‫Secure Web Proxy משתמש ב-Cloud Logging כדי לאפשר לכם לתעד מידע ולבצע משימות שונות בתחומים העיקריים הבאים:

  • מעקב ותאימות

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

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

סוגי היומנים

ב-Secure Web Proxy נעשה שימוש ב-Logging כדי לתעד ולאחסן את סוגי היומנים הבאים:

הגדרת התראות ביומן

אתם יכולים להגדיר התראות לאירועים ש-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

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

    כניסה לדף Logs Explorer

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

  3. בתפריטים הנפתחים, בוחרים את המשאב 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, מבצעים את הפעולות הבאות:

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

    כניסה לדף Dashboards

  2. לוחצים על יצירת מרכז בקרה בהתאמה אישית.

  3. לוחצים על Add widget ובוחרים באפשרות התרשים Line.

  4. בשדה Metric, מחפשים את networkservices.googleapis.com/https/request_count.

  5. בשדה Filter, אפשר לסנן לפי gateway_id אם הגדרתם כמה מכונות של Secure Web Proxy.

  6. בקטע Aggregation, מגדירים את Alignment Period לערך 1 minute ובוחרים את rate בשביל Aligner.

    הפעולה הזו ממירה את נתוני הבקשות הגולמיים לשיעור בקשות לשנייה, וכך קל יותר לראות ולנתח מגמות עקביות בתנועה לאורך זמן.

  7. כדי לשמור את הווידג'ט, לוחצים על אישור.

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