Afficher les journaux des transactions du proxy

Les journaux de transactions du proxy fournissent des informations détaillées sur chaque requête traitée par Secure Web Proxy. Ces journaux incluent un enregistrement de chaque transaction que Secure Web Proxy effectue entre les utilisateurs et Internet. Ce document explique comment accéder aux journaux de transactions générés par vos instances Secure Web Proxy et comment les interpréter.

Types d'entrées de journal des transactions de proxy

Les entrées de journal des transactions du proxy sont de trois types :

Ces journaux sont utiles pour les actions suivantes :

  • Analyse de la sécurité et détection des menaces
  • Résoudre les problèmes de connectivité et de règles
  • Auditer l'accès au Web
  • Analyse des performances de Secure Web Proxy

HttpRequest

Ces entrées de journal contiennent les informations suivantes :

Nom Type Description
requestMethod Chaîne Type de méthode de requête, par exemple GET, HEAD, PUT ou POST.
requestUrl Chaîne Scheme (http ou https), nom d'hôte, chemin d'accès et partie de la requête de l'URL demandée. Par exemple, http://example.com/some/info?color=red.
requestSize

Chaîne (format int64)

Taille, en octets, du message de requête HTTP, y compris les en-têtes de requête et le corps de la requête.
status Integer Code d'état HTTP ou HTTPS qui indique la réponse. Par exemple, 200 OK ou 404 Not Found.
responseSize Chaîne (format int64) Taille, en octets, du code d'état HTTP renvoyé au client, y compris les en-têtes et le corps.
userAgent Chaîne User-agent envoyé par le client, par exemple Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705).
remoteIp Chaîne Adresse IP (IPv4 ou IPv6) du client qui a émis la requête HTTP. Ce champ peut inclure des informations sur le port. Par exemple, 192.168.1.1, 10.0.0.1:80 et FE80::0202:B3FF:FE1E:8329.
serverIp Chaîne Adresse IP (IPv4 ou IPv6) du serveur d'origine auquel la requête a été envoyée. Ce champ peut inclure des informations sur le port. Par exemple, 192.168.1.1, 10.0.0.1:80 et FE80::0202:B3FF:FE1E:8329.
referrer Chaîne URL de provenance de la requête, telle que définie dans les définitions de champs d'en-tête HTTP/1.1.
latency Chaîne (format Duration) Latence de traitement des requêtes sur le serveur, entre la réception de la requête et l'envoi de la réponse.

La latence est une durée en secondes avec un maximum de neuf chiffres après la virgule et se termine par s, par exemple 3.5s.

cacheLookup Booléen Indique si une recherche dans le cache a été tentée.
cacheHit Booléen Indique si une entité a été diffusée à partir du cache (avec ou sans validation).
cacheValidatedWithOriginServer Booléen Indique si la réponse a été validée avec le serveur d'origine avant d'être diffusée à partir du cache. Ce champ n'est pertinent que si cacheHit est défini sur True.
cacheFillBytes Chaîne (format int64) Nombre d'octets de code d'état HTTP insérés.
protocol Chaîne Protocole utilisé pour la requête, tel que HTTP/1.1, HTTP/2 et websocket.

LoadBalancerLogEntry

Ces entrées de journal contiennent les informations suivantes :

Nom Type Description
insertId Chaîne Identifiant unique du journal.
jsonPayload.@type Chaîne Type de journal. La valeur du type de journal est toujours type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry.
jsonPayload.enforcedGatewaySecurityPolicy.hostname Chaîne Nom d'hôte associé à la requête.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action Chaîne Action effectuée sur la requête.
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.rule Chaîne Nom de la règle appliquée à la requête.
jsonPayload.enforcedGatewaySecurityPolicy.clientServiceAccount Chaîne Compte de service associé à la requête.
jsonPayload.enforcedGatewaySecurityPolicy.clientSecureTags Chaîne Tags sécurisés associés à la requête.

GatewayLogEntry

Ces entrées de journal contiennent les informations suivantes :

Nom Type Description
resource_container Chaîne Conteneur associé à la passerelle.
location Chaîne Nom de la région dans laquelle la passerelle est définie.
network_name Chaîne Nom du réseau cloud privé virtuel (VPC) dans lequel la passerelle a été créée.
gateway_type Chaîne Type d'énumération de la passerelle. Pour Secure Web Proxy, la valeur doit être SECURE_WEB_GATEWAY.
gateway_name Chaîne Nom de la ressource de passerelle.

Format des journaux de transactions du proxy

Les journaux de transactions du proxy sont écrits dans Cloud Logging avec le nom de journal projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests.

La charge utile JSON de chaque entrée de journal contient des informations détaillées sur la transaction. Les entrées de journal contiennent les champs clés suivants :

Nom Type Description
destination_ip Chaîne Adresse IP résolue de la destination.
instance Chaîne Nom de l'instance Secure Web Proxy qui a traité la requête.
mtls_info Objet Informations sur le handshake mTLS, le cas échéant.
policy_evaluation_results Objet Informations sur les règles qui ont été mises en correspondance et l'action qui en résulte, par exemple allow ou deny.
request_host Chaîne Nom d'hôte demandé.
request_method Chaîne Méthode HTTP, telle que GET ou POST.
request_path Chaîne Chemin d'accès de la requête.
request_port Integer Port de destination.
request_protocol Chaîne Version du protocole HTTP.
request_scheme Chaîne Scheme de la requête d'URL, tel que http ou https.
request_time Horodatage Date et heure auxquelles le proxy a reçu la requête. Le code temporel est spécifié au format ISO 8601 : YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. Exemple : 2025-06-03T11:52:26.452Z
response_code Integer Code d'état HTTP renvoyé au client.
response_size Integer Taille du corps de la réponse, mesurée en octets.
response_time Horodatage Date et heure auxquelles le proxy a envoyé la réponse au client. Le code temporel est spécifié au format ISO 8601 : YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset. Exemple : 2025-06-03T11:52:26.452Z
source_ip Chaîne Adresse IP client.
source_port Integer Port source du client.
tls_cipher_suite Chaîne Suite de chiffrement utilisée pour la connexion TLS.
tls_version Chaîne Version TLS utilisée pour la connexion.

Surveiller les journaux de transactions du proxy

  1. Dans la console Google Cloud , accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

  2. Sélectionnez votre projet Google Cloud .

  3. Utilisez la requête suivante pour afficher tous les journaux de transactions Secure Web Proxy :

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

    Remplacez PROJECT_ID par l'ID de votre projetGoogle Cloud cible.

    Voici quelques exemples de requêtes que vous pouvez utiliser pour afficher des détails spécifiques :

    • Recherchez toutes les demandes refusées.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
      jsonPayload.policy_evaluation_results.policy_action="DENY"
      
    • Recherchez les requêtes provenant d'une adresse IP source spécifique.

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
      jsonPayload.source_ip="192.0.2.1"
      
    • Recherchez les requêtes envoyées à un hôte spécifique.

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

Corréler les journaux de transactions du proxy avec Cloud Trace

Lorsque le traçage distribué est activé sur votre passerelle Secure Web Proxy, vous pouvez mettre en corrélation les entrées de journal des transactions du proxy avec les segments de trace dans Trace en procédant comme suit :

  1. Dans la console Google Cloud , accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

  2. Développez une entrée de journal gateway_requests.

  3. Recherchez le champ trace de premier niveau :

      projects/PROJECT_ID/traces/TRACE_ID
      

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud
    • TRACE_ID : ID de trace 128 bits (32 caractères hexadécimaux) de votre client ou de votre segment de trace. Exemple : 4bf92f3577b34da6a3ce929d0e0e4736.
  4. Cliquez sur l'URL trace, puis sélectionnez Afficher les détails de la trace pour accéder directement à la cascade de traces dans Cloud Trace.

  5. Pour filtrer les journaux d'un ID de trace connu à partir d'un client instrumenté par OpenTelemetry, exécutez la requête suivante dans l'explorateur de journaux :

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

Pour en savoir plus, consultez Présentation du traçage distribué et Tracer le trafic sortant avec Cloud Trace.

Entrées de journal des transactions Agent Gateway

Lorsque vous déployez Secure Web Proxy en tant qu'Agent Gateway, les journaux de transactions sont enregistrés sous la ressource surveillée networkservices.googleapis.com/Gateway standard.

En plus des métadonnées de requête HTTP standards, le champ jsonPayload inclut les champs spécialisés suivants pour le trafic agentique :

  • agentGatewayInfo : détails de la transaction de l'agent :

    • agentRegistryResource : nom complet de la ressource de la cible Agent Registry correspondante, par exemple un serveur ou une compétence MCP (Model Content Platform)
    • destinationUrn : informations sur l'URN de destination, telles que l'adresse du serveur MCP
    • mcpInfo : détails de l'appel MCP JSON-RPC, y compris la méthode (par exemple, tools/call ou resources/read) et le nom de l'outil ou l'URI de la ressource (parameter)
  • authzPolicyInfo : résultats de l'évaluation des règles d'autorisation appliquées à la transaction, y compris result (ALLOWED ou DENIED) et les noms des règles correspondantes

  • tls : détails TLS et attributs de validation du certificat client cryptographique (mTLS), tels que clientCertPresent et clientCertSha256Fingerprint

Filtrer les journaux de transactions Agent Gateway

Pour afficher les requêtes traitées par Secure Web Proxy pour une Agent Gateway dans l'explorateur de journaux, utilisez une requête semblable à celle-ci :

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

Remplacez SECURE_WEB_PROXY_NAME par le nom de votre passerelle Secure Web Proxy.

Pour filtrer les requêtes refusées par vos règles d'autorisation, utilisez la requête suivante :

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

Acheminer les journaux de transactions du proxy

Vous pouvez acheminer les journaux de transactions du proxy vers d'autres destinations telles que Cloud Storage, BigQuery ou Pub/Sub à l'aide de récepteurs de journaux. Pour en savoir plus, consultez Entrées de journal de routage.

Étape suivante