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 |
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
Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.
Wählen Sie Ihr Google Cloud Projekt aus.
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_IDdurch 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:
Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.
Maximieren Sie einen beliebigen
gateway_requests-Logeintrag.Suchen Sie das Feld
traceauf oberster Ebene:projects/PROJECT_ID/traces/TRACE_ID
Ersetzen Sie Folgendes:
PROJECT_ID: ID Ihres Projekts in Google CloudTRACE_ID: 128-Bit-Trace-ID (32-stellige Hexadezimalzahl) von Ihrem Client oder Trace-Span. Beispiel:4bf92f3577b34da6a3ce929d0e0e4736
Klicken Sie auf die URL
traceund wählen Sie dann Trace-Details ansehen aus, um direkt zum Trace-Wasserfalldiagramm in Cloud Trace zu gelangen.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 SkilldestinationUrn: Informationen zum Ziel-URN, z. B. die MCP-ServeradressemcpInfo: Details zum MCP-JSON-RPC-Aufruf, einschließlich der Methode (z. B.tools/calloderresources/read) und des Toolnamens oder Ressourcen-URI (parameter)
authzPolicyInfo: Bewertungsergebnisse der Autorisierungsrichtlinien, die auf die Transaktion angewendet werden, einschließlichresult(ALLOWEDoderDENIED) und der Namen der übereinstimmenden Richtlinientls: TLS-Details und Attribute zur Überprüfung des kryptografischen Clientzertifikats (mTLS), z. B.clientCertPresentundclientCertSha256Fingerprint
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.