Visualizzare i log delle transazioni proxy

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 s, ad esempio 3.5s.

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

  1. Nella console Google Cloud , vai alla pagina Esplora log.

    Vai a Esplora log

  2. Selezionare il tuo progetto Google Cloud .

  3. 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_ID con 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:

  1. Nella console Google Cloud , vai alla pagina Esplora log.

    Vai a Esplora log

  2. Espandi una voce di log gateway_requests.

  3. Individua il campo trace di primo livello:

      projects/PROJECT_ID/traces/TRACE_ID
      

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo progetto Google Cloud
    • TRACE_ID: ID traccia a 128 bit (esadecimale di 32 caratteri) dal client o dallo span di traccia. Ad esempio, 4bf92f3577b34da6a3ce929d0e0e4736.
  4. Fai clic sull'URL trace, quindi seleziona Visualizza i dettagli della traccia per andare direttamente alla struttura a cascata della traccia in Cloud Trace.

  5. 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 MCP
    • mcpInfo: dettagli della chiamata MCP JSON-RPC, incluso il metodo (ad esempio tools/call o resources/read) e il nome dello strumento o l'URI della risorsa (parameter)
  • authzPolicyInfo: i risultati della valutazione delle policy di autorizzazione applicate alla transazione, inclusi result (ALLOWED o DENIED) e i nomi delle norme di corrispondenza

  • tls: dettagli TLS e attributi di verifica del certificato client crittografico (mTLS), come clientCertPresent e clientCertSha256Fingerprint

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.

Passaggi successivi