Proxy-Transaktionslogs ansehen

Proxy-Transaktionslogs enthalten detaillierte Informationen zu jeder Anfrage, die von Secure Web Proxy verarbeitet wird. Diese Logs enthalten einen Eintrag für jede Transaktion, die Secure Web Proxy zwischen Nutzern und dem Internet vermittelt. In diesem Dokument wird erläutert, wie Sie auf die Transaktionslogs zugreifen und sie interpretieren, die von Ihren Secure Web Proxy-Instanzen generiert werden.

Arten von Proxy-Transaktionslogeinträgen

Es gibt drei Arten von Proxy-Transaktionslogeinträgen:

Diese Logs sind für die folgenden Aktionen nützlich:

  • Sicherheitsanalyse und Bedrohungserkennung
  • Fehlerbehebung bei Konnektivitäts- und Richtlinienproblemen
  • Webzugriff prüfen
  • Leistungsanalyse für Secure Web Proxy

HttpRequest

Diese Logeinträge enthalten die folgenden Informationen:

Name Typ Beschreibung
requestMethod String Typ der Anfragemethode, z. B. GET, HEAD, PUT oder POST.
requestUrl String Schema (http oder https), Hostname, Pfad und der Abfrageteil der angeforderten URL. Beispiel: http://example.com/some/info?color=red
requestSize

String (int64-Format)

Größe der HTTP-Anfragenachricht in Byte, einschließlich Anfrageheader und Anfragetext.
status Ganzzahl HTTP- oder HTTPS-Statuscode, der die Antwort angibt. Beispiel: 200 OK oder 404 Not Found.
responseSize String (int64-Format) Größe des HTTP-Statuscodes in Byte, der an den Client zurückgesendet wird, einschließlich Header und Text.
userAgent String User-Agent, den der Client sendet, z. B. Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705).
remoteIp String IP-Adresse (IPv4 oder IPv6) des Clients, der die HTTP-Anfrage gesendet hat. Dieses Feld kann Portinformationen enthalten. Beispiel: 192.168.1.1, 10.0.0.1:80 und FE80::0202:B3FF:FE1E:8329.
serverIp String IP-Adresse (IPv4 oder IPv6) des Ursprungsservers, an den die Anfrage gesendet wurde. Dieses Feld kann Portinformationen enthalten. Beispiel: 192.168.1.1, 10.0.0.1:80 und FE80::0202:B3FF:FE1E:8329.
referrer String Referrer-URL der Anfrage, wie in den HTTP/1.1-Headerfelddefinitionen definiert.
latency String (Duration-Format) Latenz der Anfrageverarbeitung auf dem Server, vom Zeitpunkt des Empfangs der Anfrage bis zum Senden der Antwort.

Die Latenz ist eine Dauer in Sekunden mit bis zu neun Nachkommastellen und endet mit s, z. B. 3.5s.

cacheLookup Boolesch Gibt an, ob eine Cache-Suche versucht wurde.
cacheHit Boolesch Gibt an, ob eine Entität aus dem Cache bereitgestellt wurde (mit oder ohne Validierung).
cacheValidatedWithOriginServer Boolesch Gibt an, ob die Antwort mit dem Ursprungsserver validiert wurde, bevor sie aus dem Cache bereitgestellt wurde. Dieses Feld ist nur sinnvoll, wenn cacheHit den Wert True hat.
cacheFillBytes String (int64-Format) Anzahl der eingefügten HTTP-Statuscode-Bytes.
protocol String Für die Anfrage verwendetes Protokoll, z. B. HTTP/1.1, HTTP/2 und websocket.

LoadBalancerLogEntry

Diese Logeinträge enthalten die folgenden Informationen:

Name Typ Beschreibung
insertId String Eindeutige Log-ID
jsonPayload.@type String Logtyp. Der Wert für den Logtyp ist immer type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry.
jsonPayload.enforcedGatewaySecurityPolicy.hostname String Der mit der Anfrage verknüpfte Hostname.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action String Maßnahme, die aufgrund des Ersuchens ergriffen wurde.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.rule String Name der Regel, die auf die Anfrage angewendet wird.
jsonPayload.enforcedGatewaySecurityPolicy.clientServiceAccount String Dienstkonto, das mit der Anfrage verknüpft ist.
jsonPayload.enforcedGatewaySecurityPolicy.clientSecureTags String Sichere Tags, die mit der Anfrage verknüpft sind.

GatewayLogEntry

Diese Logeinträge enthalten die folgenden Informationen:

Name Typ Beschreibung
resource_container String Container, der mit dem Gateway verknüpft ist.
location String Name der Region, in der das Gateway definiert ist.
network_name String Name des VPC-Netzwerks (Virtual Private Cloud), in dem das Gateway erstellt wurde.
gateway_type String Enum-Typ des Gateways. Für Secure Web Proxy muss der Wert SECURE_WEB_GATEWAY sein.
gateway_name String Name der Gateway-Ressource.

Format von Proxy-Transaktionslogs

Proxy-Transaktionslogs werden mit dem Lognamen projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests in Cloud Logging geschrieben.

Die JSON-Nutzlast jedes Logeintrags enthält detaillierte Informationen zur Transaktion. Logeinträge enthalten die folgenden Schlüsselfelder:

Name Typ Beschreibung
destination_ip String Aufgelöste IP-Adresse des Ziels.
instance String Name der Secure Web Proxy-Instanz, die die Anfrage verarbeitet hat.
mtls_info Objekt Informationen zum mTLS-Handshake, falls zutreffend.
policy_evaluation_results Objekt Informationen darüber, welche Regeln abgeglichen wurden, und die resultierende Aktion, z. B. allow oder deny.
request_host String Angeforderter Hostname.
request_method String HTTP-Methode, z. B. GET oder POST.
request_path String Pfad der Anfrage.
request_port Ganzzahl Zielport.
request_protocol String HTTP-Protokollversion.
request_scheme String Schema der URL-Anfrage, z. B. http oder https.
request_time Zeitstempel Datum und Uhrzeit, zu der der Proxy die Anfrage empfangen hat. Der Zeitstempel wird im Format ISO 8601 angegeben: YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. Beispiel: 2025-06-03T11:52:26.452Z
response_code Ganzzahl HTTP-Statuscode, der an den Client zurückgegeben wird.
response_size Ganzzahl Größe des Antworttexts in Byte.
response_time Zeitstempel Datum und Uhrzeit, zu der der Proxy die Antwort an den Client gesendet hat. Der Zeitstempel wird im Format ISO 8601 angegeben: YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. Beispiel: 2025-06-03T11:52:26.452Z
source_ip String Client-IP-Adresse.
source_port Ganzzahl Quellport des Clients.
tls_cipher_suite String Cipher Suite, die für die TLS-Verbindung verwendet wird.
tls_version String Für die Verbindung verwendete TLS-Version.

Proxy-Transaktionslogs überwachen

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

  2. Wählen Sie Ihr Google Cloud Projekt aus.

  3. Verwenden Sie die folgende Abfrage, um alle Secure Web Proxy-Transaktionslogs aufzurufen:

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

    Ersetzen Sie PROJECT_ID durch die ID Ihres Zielprojekts inGoogle Cloud .

    Hier sind einige Beispielabfragen, mit denen Sie bestimmte Details aufrufen können:

    • Alle abgelehnten Anfragen finden.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
      jsonPayload.policy_evaluation_results.policy_action="DENY"
      
    • Anfragen von einer bestimmten Quell-IP-Adresse suchen

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
      jsonPayload.source_ip="192.0.2.1"
      
    • Anfragen an einen bestimmten Host finden.

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

Proxy-Transaktionslogs mit Cloud Trace korrelieren

Wenn verteiltes Tracing auf Ihrem Secure Web Proxy-Gateway aktiviert ist, können Sie Proxy-Transaktionslogeinträge mit Trace-Spans in Trace korrelieren. Gehen Sie dazu so vor:

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

  2. Maximieren Sie einen beliebigen gateway_requests-Logeintrag.

  3. Suchen Sie das Feld trace auf oberster Ebene:

      projects/PROJECT_ID/traces/TRACE_ID
      

    Ersetzen Sie Folgendes:

    • PROJECT_ID: ID Ihres Projekts in Google Cloud
    • TRACE_ID: 128-Bit-Trace-ID (32-stellige Hexadezimalzahl) von Ihrem Client oder Trace-Span. Beispiel: 4bf92f3577b34da6a3ce929d0e0e4736
  4. Klicken Sie auf die URL trace und wählen Sie dann Trace-Details ansehen aus, um direkt zum Trace-Wasserfalldiagramm in Cloud Trace zu gelangen.

  5. Wenn Sie Logs für eine bekannte Trace-ID von einem mit OpenTelemetry instrumentierten Client filtern möchten, führen Sie die folgende Abfrage im Log-Explorer aus:

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

Weitere Informationen finden Sie unter Übersicht über verteiltes Tracing und Ausgehenden Traffic mit Cloud Trace verfolgen.

Transaktionslogeinträge für das Agent Gateway

Wenn Sie Secure Web Proxy als Agent-Gateway bereitstellen, werden Transaktionslogs unter der standardmäßigen networkservices.googleapis.com/Gateway überwachten Ressource aufgezeichnet.

Zusätzlich zu den Standardmetadaten für HTTP-Anfrage enthält das Feld jsonPayload die folgenden speziellen Felder für agentischen Traffic:

  • agentGatewayInfo: Details zur Agententransaktion:

    • agentRegistryResource: Vollständiger Ressourcenname des übereinstimmenden Agent Registry-Ziels, z. B. ein MCP-Server (Model Content Platform) oder ein Skill
    • destinationUrn: Informationen zum Ziel-URN, z. B. die MCP-Serveradresse
    • mcpInfo: Details zum MCP-JSON-RPC-Aufruf, einschließlich der Methode (z. B. tools/call oder resources/read) und des Toolnamens oder Ressourcen-URI (parameter)
  • authzPolicyInfo: Bewertungsergebnisse der Autorisierungsrichtlinien, die auf die Transaktion angewendet werden, einschließlich result (ALLOWED oder DENIED) und der Namen der übereinstimmenden Richtlinien

  • tls: TLS-Details und Attribute zur Überprüfung des kryptografischen Clientzertifikats (mTLS), z. B. clientCertPresent und clientCertSha256Fingerprint

Transaktionslogs für KI-Agenten-Gateways filtern

Wenn Sie die Anfragen, die Secure Web Proxy für ein Agent-Gateway verarbeitet, im Log-Explorer aufrufen möchten, verwenden Sie eine Abfrage wie die folgende:

resource.type="networkservices.googleapis.com/Gateway"
resource.labels.gateway_name="SECURE_WEB_PROXY_NAME"
jsonPayload.agentGatewayInfo:*

Ersetzen Sie SECURE_WEB_PROXY_NAME durch den Namen Ihres Secure Web Proxy-Gateways.

Verwenden Sie die folgende Abfrage, um nach Anfragen zu filtern, die von Ihren Autorisierungsrichtlinien abgelehnt wurden:

resource.type="networkservices.googleapis.com/Gateway"
resource.labels.gateway_name="SECURE_WEB_PROXY_NAME"
jsonPayload.authzPolicyInfo.result="DENIED"

Proxy-Transaktionslogs weiterleiten

Sie können Proxy-Transaktionslogs mithilfe von Logsenken an andere Ziele wie Cloud Storage, BigQuery oder Pub/Sub weiterleiten. Weitere Informationen finden Sie unter Logeinträge weiterleiten.

Nächste Schritte