プロキシ トランザクション ログを表示する

プロキシ トランザクション ログには、Secure Web Proxy が処理する各リクエストの詳細情報が記録されます。これらのログには、Secure Web Proxy がユーザーとインターネットの間で仲介するすべてのトランザクションの記録が含まれます。このドキュメントでは、Secure Web Proxy インスタンスが生成するトランザクション ログにアクセスして解釈する方法について説明します。

プロキシ トランザクション ログエントリの種類

プロキシのトランザクション ログエントリには、次の 3 つのタイプがあります。

これらのログは、次のアクションに役立ちます。

  • セキュリティ分析と脅威検出
  • 接続とポリシーに関する問題のトラブルシューティング
  • ウェブアクセスの監査
  • Secure Web Proxy のパフォーマンス分析

HttpRequest

これらのログエントリには、次の情報が含まれています。

名前 タイプ 説明
requestMethod 文字列 リクエスト メソッドのタイプ(GET、HEAD、PUT、POST など)。
requestUrl 文字列 リクエストされた URL のスキーム(http または https)、ホスト名、パス、クエリ部分。例: http://example.com/some/info?color=red。
requestSize

文字列(int64 形式)

HTTP リクエスト メッセージのバイトサイズ(各リクエスト ヘッダーと、リクエスト ボディを含む)。
status 整数 レスポンスを示す HTTP または HTTPS ステータス コード。たとえば、200 OK や 404 Not Found です。
responseSize 文字列(int64 形式) クライアントに返される HTTP ステータス コードのサイズ(バイト単位)。ヘッダーと本文が含まれます。
userAgent 文字列 クライアントが送信するユーザー エージェント(Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705) など)。
remoteIp 文字列 HTTP リクエストを発行したクライアントの IP アドレス(IPv4 または IPv6)。このフィールドにはポート情報を含めることができます。たとえば、192.168.1.1、10.0.0.1:80、FE80::0202:B3FF:FE1E:8329 です。
serverIp 文字列 リクエストが送信された配信元サーバーの IP アドレス(IPv4 または IPv6)。このフィールドにはポート情報を含めることができます。たとえば、192.168.1.1、10.0.0.1:80、FE80::0202:B3FF:FE1E:8329 です。
referrer 文字列 リクエストのリファラー URL(HTTP/1.1 Header Field Definitions で規定されている)。
latency 文字列(Duration 形式) サーバー上でのリクエスト処理のレイテンシ。サーバーがリクエストを受信してからレスポンスを送信するまでの時間です。

レイテンシは秒単位の期間で、小数点以下 9 桁まで指定できます。最後に s を付けます(例: 3.5s)。

cacheLookup ブール値 キャッシュ ルックアップが試行されたかどうかを示します。
cacheHit ブール値 キャッシュ内のエンティティを利用したかどうか(検証あり / 検証なし)。
cacheValidatedWithOriginServer ブール値 キャッシュから提供される前に、配信元サーバーでレスポンスが検証されたかどうかを示します。このフィールドは、cacheHit が True の場合にのみ意味を持ちます。
cacheFillBytes 文字列(int64 形式) 挿入された HTTP ステータス コードのバイト数。
protocol 文字列 リクエストに使用されるプロトコル(HTTP/1.1、HTTP/2、websocket など)。

LoadBalancerLogEntry

これらのログエントリには、次の情報が含まれています。

名前 タイプ 説明
insertId 文字列 一意のログ ID。
jsonPayload.@type 文字列 ログタイプ。ログタイプ値は常に type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry です。
jsonPayload.enforcedGatewaySecurityPolicy.hostname 文字列 リクエストに関連付けられているホスト名。
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.action 文字列 リクエストに対して行われたアクション。
jsonPayload.enforcedGatewaySecurityPolicy.matchedRules.rule 文字列 リクエストに適用されたルールの名前。
jsonPayload.enforcedGatewaySecurityPolicy.clientServiceAccount 文字列 リクエストに関連付けられているサービス アカウント。
jsonPayload.enforcedGatewaySecurityPolicy.clientSecureTags 文字列 リクエストに関連付けられたセキュアタグ。

GatewayLogEntry

これらのログエントリには、次の情報が含まれています。

名前 タイプ 説明
resource_container 文字列 ゲートウェイに関連付けられたコンテナ。
location 文字列 ゲートウェイが定義されているリージョンの名前。
network_name 文字列 ゲートウェイが作成された Virtual Private Cloud(VPC)ネットワークの名前。
gateway_type 文字列 ゲートウェイの列挙型。Secure Web Proxy の場合、値は SECURE_WEB_GATEWAY にする必要があります。
gateway_name 文字列 ゲートウェイ リソースの名前。

プロキシ トランザクション ログの形式

プロキシ トランザクション ログは、projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests というログ名で Cloud Logging に書き込まれます。

各ログエントリの JSON ペイロードには、トランザクションに関する詳細情報が含まれています。ログエントリには、次のキーフィールドが含まれています。

名前 タイプ 説明
destination_ip 文字列 解決された宛先の IP アドレス。
instance 文字列 リクエストを処理した Secure Web Proxy インスタンスの名前。
mtls_info オブジェクト mTLS handshake に関する情報(該当する場合)。
policy_evaluation_results オブジェクト 一致したルールと、その結果として実行されたアクション(allow、deny など)に関する情報。
request_host 文字列 リクエストされたホスト名。
request_method 文字列 HTTP メソッド(GET、POST など)。
request_path 文字列 リクエストのパス。
request_port Integer 宛先ポート。
request_protocol 文字列 HTTP プロトコル バージョン。
request_scheme 文字列 URL リクエストのスキーム(http、https など)。
request_time タイムスタンプ プロキシがリクエストを受信した日時。タイムスタンプは ISO 8601 形式(YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset)で指定します。例: 2025-06-03T11:52:26.452Z
response_code Integer クライアントに返される HTTP ステータス コード。
response_size Integer レスポンス本文のサイズ(バイト単位)。
response_time タイムスタンプ プロキシがクライアントにレスポンスを送信した日時。タイムスタンプは ISO 8601 形式(YYYY-MM-DDTHH:MM:SS.MsMsMsZoneOffset)で指定します。例: 2025-06-03T11:52:26.452Z
source_ip 文字列 クライアントの IP アドレス。
source_port Integer クライアントの送信元ポート。
tls_cipher_suite 文字列 TLS 接続に使用される暗号スイート。
tls_version 文字列 接続に使用される TLS のバージョン。

プロキシ トランザクション ログをモニタリングする

  1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

    [ログ エクスプローラ] に移動

  2. Google Cloud プロジェクトを選択します。

  3. 次のクエリを使用して、すべての Secure Web Proxy トランザクション ログを表示します。

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

    PROJECT_ID は、ターゲットGoogle Cloud プロジェクトの ID に置き換えます。

    特定の詳細を表示するために使用できるサンプルクエリをいくつか紹介します。

    • 拒否されたリクエストをすべて検索します。

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
      jsonPayload.policy_evaluation_results.policy_action="DENY"
      
    • 特定の送信元 IP アドレスからのリクエストを検索します。

      logName="projects/PROJECT_ID/logs/networkservices.googleapis.com%2Fgateway_requests"
      jsonPayload.source_ip="192.0.2.1"
      
    • 特定のホストへのリクエストを検索します。

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

プロキシ トランザクション ログを Cloud Trace に関連付ける

Secure Web Proxy ゲートウェイで分散トレースが有効になっている場合は、次の手順でプロキシ トランザクション ログエントリを Trace のトレーススパンに関連付けることができます。

  1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

    [ログ エクスプローラ] に移動

  2. gateway_requests ログエントリを開きます。

  3. 最上位の trace フィールドを見つけます。

      projects/PROJECT_ID/traces/TRACE_ID
      

    次のように置き換えます。

    • PROJECT_ID: Google Cloud プロジェクトの ID
    • TRACE_ID: クライアントまたはトレーススパンの 128 ビット(32 文字の 16 進数)のトレース ID。例: 4bf92f3577b34da6a3ce929d0e0e4736
  4. trace URL をクリックし、[トレースの詳細を表示] を選択して、Cloud Trace のトレース ウォーターフォールに直接移動します。

  5. OpenTelemetry で計測されたクライアントから既知のトレース ID のログをフィルタするには、ログ エクスプローラで次のクエリを実行します。

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

詳細については、分散トレースの概要と Cloud Trace でアウトバウンド トラフィックをトレースするをご覧ください。

Agent Gateway のトランザクション ログエントリ

Secure Web Proxy を Agent Gateway としてデプロイすると、トランザクション ログは標準の networkservices.googleapis.com/Gateway モニタリング対象リソースに記録されます。

jsonPayload フィールドには、標準の HTTP リクエスト メタデータに加えて、エージェント トラフィック用の次の特殊なフィールドが含まれています。

  • agentGatewayInfo: エージェント トランザクションの詳細。

    • agentRegistryResource: 一致した Agent Registry ターゲットの完全なリソース名(Model Content Platform(MCP)サーバーやスキルなど)
    • destinationUrn: 宛先 URN に関する情報(MCP サーバー アドレスなど)
    • mcpInfo: MCP JSON-RPC 呼び出しの詳細。メソッド(tools/call や resources/read など)、ツール名、リソース URI(parameter)が含まれます。
  • authzPolicyInfo: トランザクションに適用される認可ポリシーの評価結果。result(ALLOWED または DENIED)と一致ポリシーの名前が含まれます。

  • tls: TLS の詳細と暗号化クライアント証明書(mTLS)の検証属性(clientCertPresent、clientCertSha256Fingerprint など)

Agent Gateway のトランザクション ログをフィルタする

ログ エクスプローラで Secure Web Proxy が Agent Gateway に対して処理するリクエストを表示するには、次のようなクエリを使用します。

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

SECURE_WEB_PROXY_NAME は、Secure Web Proxy ゲートウェイの名前に置き換えます。

認可ポリシーによって拒否されたリクエストをフィルタするには、次のクエリを使用します。

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

プロキシ トランザクション ログを転送する

ログシンクを使用すると、プロキシ トランザクション ログを Cloud Storage、BigQuery、Pub/Sub などの他の宛先に転送できます。詳細については、ログエントリをルーティングするをご覧ください。

次のステップ