I log delle transazioni del proxy forniscono informazioni dettagliate su ogni richiesta elaborata da Secure Web Proxy. Questi log includono un record di ogni transazione che Secure Web Proxy media tra gli utenti e internet. Questo documento spiega come accedere e interpretare i log delle transazioni generati dalle istanze di Secure Web Proxy.
Tipi di voci di log delle transazioni proxy
Le voci di log delle transazioni proxy sono di tre tipi:
Questi log sono utili per le seguenti azioni:
- Analisi della sicurezza e rilevamento delle minacce
- Risoluzione dei problemi di connettività e delle norme
- Controllo dell'accesso web
- Analisi delle prestazioni di Secure Web Proxy
HttpRequest
Queste voci di log contengono le seguenti informazioni:
| Nome | Tipo | Descrizione |
|---|---|---|
requestMethod
|
Stringa | Tipo di metodo di richiesta, ad esempio GET, HEAD,
PUT o POST.
|
requestUrl
|
Stringa | Schema (http o https), nome host, percorso e parte della query dell'URL richiesto. Ad esempio, http://example.com/some/info?color=red.
|
requestSize
|
Stringa (formato int64) |
Dimensioni, in byte, del messaggio di richiesta HTTP, incluse le intestazioni della richiesta e il corpo della richiesta. |
status
|
Numero intero | Codice di stato HTTP o HTTPS che indica la risposta. Ad esempio, 200 OK o 404 Not Found.
|
responseSize
|
Stringa (formato int64) | Dimensioni, in byte, del codice di stato HTTP inviato al client, incluse le intestazioni e il corpo. |
userAgent
|
Stringa | User agent inviato dal client, ad esempio Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461;
.NET CLR 1.0.3705).
|
remoteIp
|
Stringa | Indirizzo IP (IPv4 o IPv6) del client che ha inviato la richiesta HTTP. Questo campo può includere informazioni sulla porta. Ad esempio, 192.168.1.1, 10.0.0.1:80 e FE80::0202:B3FF:FE1E:8329.
|
serverIp
|
Stringa | Indirizzo IP (IPv4 o IPv6) del server di origine a cui è stata inviata la richiesta. Questo campo può includere informazioni sulla porta. Ad esempio, 192.168.1.1, 10.0.0.1:80 e FE80::0202:B3FF:FE1E:8329.
|
referrer
|
Stringa | URL referrer della richiesta, come definito in HTTP/1.1 Header Field Definitions. |
latency
|
Stringa (formato Duration) | Latenza di elaborazione della richiesta sul server, dal momento in cui la richiesta è stata ricevuta fino all'invio della risposta.
La latenza è una durata in secondi con un massimo di nove cifre frazionarie e termina con |
cacheLookup
|
Booleano | Indica se è stato tentato un controllo della cache. |
cacheHit
|
Booleano | Indica se un'entità è stata pubblicata dalla cache (con o senza convalida). |
cacheValidatedWithOriginServer
|
Booleano | Indica se la risposta è stata convalidata con il server di origine prima di essere fornita dalla cache. Questo campo è significativo solo se cacheHit è True.
|
cacheFillBytes
|
Stringa (formato int64) | Numero di byte del codice di stato HTTP inseriti. |
protocol
|
Stringa | Protocollo utilizzato per la richiesta, ad esempio HTTP/1.1, HTTP/2 e websocket.
|
LoadBalancerLogEntry
Queste voci di log contengono le seguenti informazioni:
| Nome | Tipo | Descrizione |
|---|---|---|
insertId
|
Stringa | ID log univoco. |
jsonPayload.@type
|
Stringa | Tipo di log. Il valore del tipo di log è sempre type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry.
|
jsonPayload.enforcedGatewaySecurityPolicy.hostname
|
Stringa | Nome host associato alla richiesta. |
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action
|
Stringa | Azione intrapresa in merito alla richiesta. |
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.rule
|
Stringa | Nome della regola applicata alla richiesta. |
jsonPayload.enforcedGatewaySecurityPolicy.clientServiceAccount
|
Stringa | Service account associato alla richiesta. |
jsonPayload.enforcedGatewaySecurityPolicy.clientSecureTags
|
Stringa | Tag sicuri associati alla richiesta. |
GatewayLogEntry
Queste voci di log contengono le seguenti informazioni:
| Nome | Tipo | Descrizione |
|---|---|---|
resource_container
|
Stringa | Container associato al gateway. |
location
|
Stringa | Nome della regione in cui è definito il gateway. |
network_name
|
Stringa | Nome della rete Virtual Private Cloud (VPC) in cui è stato creato il gateway. |
gateway_type
|
Stringa | Tipo di enum del gateway. Per Secure Web Proxy, il valore deve essere SECURE_WEB_GATEWAY.
|
gateway_name
|
Stringa | Nome della risorsa gateway. |
Formato dei log delle transazioni del proxy
I log delle transazioni del proxy vengono scritti in Cloud Logging con il nome log projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests.
Il payload JSON di ogni voce di log contiene informazioni dettagliate sulla transazione. Le voci di log contengono i seguenti campi chiave:
| Nome | Tipo | Descrizione |
|---|---|---|
destination_ip |
Stringa | Indirizzo IP risolto della destinazione. |
instance |
Stringa | Nome dell'istanza di Secure Web Proxy che ha elaborato la richiesta. |
mtls_info |
Oggetto | Informazioni sull'handshake mTLS, se applicabile. |
policy_evaluation_results |
Oggetto | Informazioni sulle regole che hanno trovato corrispondenza e sull'azione risultante, ad esempio allow o deny. |
request_host |
Stringa | Nome host richiesto. |
request_method |
Stringa | Metodo HTTP, ad esempio GET o POST. |
request_path |
Stringa | Percorso della richiesta. |
request_port |
Numero intero | Porta di destinazione. |
request_protocol |
Stringa | Versione del protocollo HTTP. |
request_scheme |
Stringa | Schema della richiesta URL, ad esempio http o https. |
request_time |
Timestamp | Data e ora in cui il proxy ha ricevuto la richiesta. Il timestamp
è specificato nel formato ISO 8601:
YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. Ad esempio, 2025-06-03T11:52:26.452Z. |
response_code |
Numero intero | Codice di stato HTTP restituito al client. |
response_size |
Numero intero | Dimensioni del corpo della risposta, misurate in byte. |
response_time |
Timestamp | Data e ora in cui il proxy ha inviato la risposta al client.
Il timestamp è specificato nel formato ISO 8601:
YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. Ad esempio, 2025-06-03T11:52:26.452Z. |
source_ip |
Stringa | Indirizzo IP client. |
source_port |
Numero intero | Porta di origine del client. |
tls_cipher_suite |
Stringa | Suite di crittografia utilizzata per la connessione TLS. |
tls_version |
Stringa | Versione TLS utilizzata per la connessione. |
Monitora i log delle transazioni del proxy
Nella console Google Cloud , vai alla pagina Esplora log.
Selezionare il tuo progetto Google Cloud .
Utilizza la seguente query per visualizzare tutti i log delle transazioni di Secure Web Proxy:
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
Sostituisci
PROJECT_IDcon l'ID del progettoGoogle Cloud di destinazione.Ecco alcune query di esempio che puoi utilizzare per visualizzare dettagli specifici:
Trova tutte le richieste rifiutate.
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests" jsonPayload.policy_evaluation_results.policy_action="DENY"
Trova le richieste provenienti da un indirizzo IP di origine specifico.
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests" jsonPayload.source_ip="192.0.2.1"
Trova le richieste inviate a un host specifico.
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests" jsonPayload.request_host="example.com"
Correlare i log delle transazioni del proxy con Cloud Trace
Quando il tracciamento distribuito è abilitato sul gateway Secure Web Proxy, puoi correlare le voci di log delle transazioni del proxy con gli intervalli di traccia in Trace seguendo questi passaggi:
Nella console Google Cloud , vai alla pagina Esplora log.
Espandi una voce di log
gateway_requests.Individua il campo
tracedi primo livello:projects/PROJECT_ID/traces/TRACE_ID
Sostituisci quanto segue:
PROJECT_ID: l'ID del tuo progetto Google CloudTRACE_ID: ID traccia a 128 bit (esadecimale di 32 caratteri) dal client o dallo span di traccia. Ad esempio,4bf92f3577b34da6a3ce929d0e0e4736.
Fai clic sull'URL
trace, quindi seleziona Visualizza i dettagli della traccia per andare direttamente alla struttura a cascata della traccia in Cloud Trace.Per filtrare i log per un ID traccia noto da un client OpenTelemetry, esegui questa query in Esplora log:
logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests" trace="projects/PROJECT_ID/traces/TRACE_ID"
Per saperne di più, consulta la panoramica del tracciamento distribuito e Traccia il traffico in uscita con Cloud Trace.
Voci di log delle transazioni di Agent Gateway
Quando esegui il deployment di Secure Web Proxy come Agent Gateway, i log delle transazioni vengono registrati nella risorsa monitorata networkservices.googleapis.com/Gateway standard.
Oltre ai metadati delle richieste HTTP standard, il campo jsonPayload include i seguenti campi specializzati per il traffico degli agenti:
agentGatewayInfo: dettagli sulla transazione dell'agente:agentRegistryResource: il nome completo della risorsa della destinazione Agent Registry corrispondente, ad esempio un server o una skill Model Content Platform (MCP)destinationUrn: informazioni sull'URN di destinazione, ad esempio l'indirizzo del server MCPmcpInfo: dettagli della chiamata MCPJSON-RPC, incluso il metodo (ad esempiotools/calloresources/read) e il nome dello strumento o l'URI della risorsa (parameter)
authzPolicyInfo: i risultati della valutazione delle policy di autorizzazione applicate alla transazione, inclusiresult(ALLOWEDoDENIED) e i nomi delle norme di corrispondenzatls: dettagli TLS e attributi di verifica del certificato client crittografico (mTLS), comeclientCertPresenteclientCertSha256Fingerprint
Filtra i log delle transazioni di Agent Gateway
Per visualizzare le richieste elaborate da Secure Web Proxy per un Agent Gateway in Esplora log, utilizza una query simile alla seguente:
resource.type="networkservices.googleapis.com/Gateway" resource.labels.gateway_name="SECURE_WEB_PROXY_NAME" jsonPayload.agentGatewayInfo:*
Sostituisci SECURE_WEB_PROXY_NAME con il nome del gateway Secure Web Proxy.
Per filtrare le richieste rifiutate dalle policy di autorizzazione, utilizza la seguente query:
resource.type="networkservices.googleapis.com/Gateway" resource.labels.gateway_name="SECURE_WEB_PROXY_NAME" jsonPayload.authzPolicyInfo.result="DENIED"
Instrada i log delle transazioni del proxy
Puoi instradare i log delle transazioni proxy ad altre destinazioni come Cloud Storage, BigQuery o Pub/Sub utilizzando i sink di log. Per saperne di più, consulta Instrada le voci di log.