Secure Web Proxy を Agent Gateway としてデプロイする

このページでは、Secure Web Proxy インスタンスを Agent Gateway として構成してデプロイする方法について説明します。

概要

Google Cloud にデプロイされたエンタープライズ AI ワークロードでは、データ プライバシー コンプライアンスを維持し、機密データの漏洩を防ぎ、プロンプト インジェクションなどの新たな AI 脅威から保護するために、構造化されたネットワーク境界が必要です。

Agent Gateway は、AI エージェントから大規模言語モデル（LLM）、Model Context Protocol（MCP）ツール、外部 API、リモート エージェント、標準ウェブ宛先へのアウトバウンド トラフィックに対して、一元化されたセキュリティ ガバナンス、ID 適用、コンテンツ ガードレールを提供します。

Google マネージド Agent Gateway または Secure Web Proxy インスタンスをセルフマネージド Agent Gateway としてデプロイできます。どちらのデプロイモデルでも、一元化されたアクセス ポリシー、Agent Registry の統合、コンテンツ ガードレールなど、共通の Gemini Enterprise Agent Platform ガバナンス ソリューションが提供されます。

運用上の好みに応じて、次のデプロイ オプションから選択します。

  • Google マネージド Agent Gateway: ネットワーク プロキシ インフラストラクチャを管理する必要なく、フルマネージドでメンテナンス不要のエクスペリエンスが必要な場合は、このオプションを使用します。詳細については、Google が管理する Agent Gateway をご覧ください。このモデルは、Gemini Enterprise または Gemini Enterprise Agent Platform の Agent Runtime で実行されるエージェント向けに最適化されています。

  • セルフマネージド Agent Gateway としての Secure Web Proxy: VPC ネットワーク境界、プライベート CA 証明書、プロキシ ルーティングを完全に制御して、Google Kubernetes Engine（GKE）または Cloud Run で実行されるエージェントをサポートする場合は、Secure Web Proxy インスタンスを Agent Gateway としてデプロイします。

利点

Secure Web Proxy を Agent Gateway としてデプロイすると、次のメリットがあります。

  • お客様が管理するインフラストラクチャ: 独自の Virtual Private Cloud（VPC）ネットワークで Secure Web Proxy ゲートウェイを管理し、ネットワーク ルーティング、IP アドレス指定、プライベート CA 証明書、TLS 検査を完全に制御できます。

  • 一元化された AI ポリシーの適用: agentGateway リソースに認可ポリシーを定義できます。これにより、Secure Web Proxy ゲートウェイでこれらのポリシーを直接適用して、MCP ツール呼び出しを制限し、AI エージェントの外部宛先をフィルタリングして、Model Armor などのコンテンツ サニタイズ サービスを呼び出すことができます。

  • ランタイム サポート: GKE や Cloud Run などのさまざまなランタイムでホストされている AI エージェントからのアウトバウンド トラフィックを、単一のプロキシ境界を介してルーティングできます。

  • エージェント対応のオブザーバビリティ: Cloud Logging のトランザクション ログには、MCP メソッド、ツール名、Agent Registry の宛先の Uniform Resource Name（URN）など、AI エージェントの実行メタデータ（agentGatewayInfo）が自動的に含まれます。

アーキテクチャ

次の手順は、Secure Web Proxy が Agent Gateway としてアウトバウンド トラフィックを保護する方法を示しています。

  1. Agent Runtime: GKE または Cloud Run で実行される自律型エージェントは、外部 API、モデル プロバイダ、MCP ツールサーバー、リモート エージェント、標準のウェブ宛先へのアウトバウンド接続を開始します。

  2. アウトバウンド トラフィックのルーティング: エージェント トラフィックは、VPC 内プロキシ ルーティングまたはクロス VPC Private Service Connect（PSC）サービス アタッチメントを使用して Secure Web Proxy に転送されます。

  3. ポリシーの評価とコンテンツのサニタイズ: Secure Web Proxy は TLS 接続を終了し、MCP 認可ポリシーを適用します。また、Model Armor や Identity-Aware Proxy（IAP）などの拡張サービスを呼び出して、ペイロードをサニタイズし、クライアント ID を検証します。

始める前に

Secure Web Proxy インスタンスを Agent Gateway としてデプロイする前に、次の前提条件を完了します。

  1. 次の必要な Google Cloud API を有効にします。

    gcloud services enable \
    networkservices.googleapis.com \
    networksecurity.googleapis.com \
    privateca.googleapis.com \
    certificatemanager.googleapis.com \
    serviceextensions.googleapis.com \
    agentregistry.googleapis.com \
    compute.googleapis.com

  2. 次の必要な Identity and Access Management（IAM）ロールがあることを確認します。

  3. デプロイ用に次の環境変数を構成します。

    export PROJECT_ID="my-project-id"
export PROJECT_NUMBER="my-project-number"
export REGION="us-central1"
export NETWORK_NAME="swp-vpc"
export PROXY_SUBNET_NAME="swp-proxy-subnet"
export PSC_NAT_SUBNET_NAME="swp-psc-nat-subnet"
export CA_POOL_NAME="swp-ca-pool"
export ROOT_CA_NAME="swp-root-ca"
export TLS_INSPECTION_POLICY_NAME="swp-tls-inspection-policy"
export SECURE_WEB_PROXY_NAME="swp-agent-gateway"
export SWP_IP_ADDRESS="10.129.0.10"
export SWP_CERTIFICATE_NAME="swp-cert"
export SERVER_TLS_POLICY_NAME="swp-server-tls-policy"
export GATEWAY_SECURITY_POLICY_NAME="swp-security-policy"
export SERVICE_ATTACHMENT_NAME="swp-service-attachment"
export AGENT_GATEWAY_NAME="my-agent-gateway"

  4. 省略可: Agent Runtime が、プロジェクト間の GKE クラスタや Cloud Run クラスタなど、個別の VPC ネットワークまたはマネージド環境で動作している場合は、Private Service Connect サービス アタッチメントを介して Secure Web Proxy を公開する必要があります。

TLS インスペクションを設定する

Secure Web Proxy は、TLS 接続を終了して HTTP ヘッダーを検査し、MCP メソッドを評価して、ペイロードをサニタイズします。

TLS 検査を構成するには、次の操作を行って、プライベート認証局（CA）プール、ルート CA、tlsInspectionPolicy リソースを作成します。

  1. プライベート CA プールを作成する。

    gcloud privateca pools create CA_POOL_NAME \
    --location=REGION \
    --tier=devops \
    --project=PROJECT_ID

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

    • CA_POOL_NAME: CA プールの名前
    • REGION: CA プールが作成されるリージョン
    • PROJECT_ID: Google Cloud プロジェクトの ID

  2. プライベート CA プールにルート CA を作成します。

    gcloud privateca roots create ROOT_CA_NAME \
    --pool=CA_POOL_NAME \
    --location=REGION \
    --subject="CN=Agent Gateway SWP Root CA, O=MyOrganization" \
    --auto-enable \
    --project=PROJECT_ID

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

    • ROOT_CA_NAME: ルート CA の名前
    • CA_POOL_NAME: CA プールの名前
    • REGION: ルート CA が作成されるリージョン
    • PROJECT_ID: Google Cloud プロジェクトの ID

    注: Cloud Run や GKE などのクライアント ワークロードが、TLS 検査中にこの CA プールによって発行された証明書を信頼できるようにするには、ルート CA 証明書をエクスポートして、ワークロードのトラストストアに追加します。たとえば、AGENT_GATEWAY_ROOT_CERTIFICATES 環境変数を設定できます。

  3. ネットワーク セキュリティ サービス アカウントに証明書をリクエストする権限を付与します。

    gcloud privateca pools add-iam-policy-binding CA_POOL_NAME \
    --location=REGION \
    --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-networksecurity." \
    --role="roles/privateca.certificateRequester" \
    --project=PROJECT_ID

  4. tls-inspection-policy.yaml という名前のファイルに tlsInspectionPolicy リソースを作成します。

    name: projects/PROJECT_ID/locations/REGION/tlsInspectionPolicies/TLS_INSPECTION_POLICY_NAME
caPool: projects/PROJECT_ID/locations/REGION/caPools/CA_POOL_NAME

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

    • PROJECT_ID: Google Cloud プロジェクトの ID
    • REGION: TlsInspectionPolicy が作成されるリージョン
    • TLS_INSPECTION_POLICY_NAME: TlsInspectionPolicy リソースの名前
    • CA_POOL_NAME: CA プールの名前

  5. ポリシーをインポートするには、gcloud network-security tls-inspection-policies import コマンドを実行します。

    gcloud network-security tls-inspection-policies import TLS_INSPECTION_POLICY_NAME \
    --source=tls-inspection-policy.yaml \
    --location=REGION \
    --project=PROJECT_ID

Secure Web Proxy をデプロイする

相互 TLS（mTLS）が構成された Secure Web Proxy ゲートウェイを作成します。

  1. ゲートウェイをデプロイするリージョンに、VPC ネットワークのプロキシ専用サブネットがあることを確認します。

    gcloud compute networks subnets create PROXY_SUBNET_NAME \
    --purpose=REGIONAL_MANAGED_PROXY \
    --role=ACTIVE \
    --region=REGION \
    --network=NETWORK_NAME \
    --range=10.129.0.0/23

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

    • PROXY_SUBNET_NAME: プロキシ専用サブネットの名前
    • NETWORK_NAME: VPC ネットワークの名前
    • REGION: サブネットが作成されるリージョン

  2. 省略可: プロキシ専用サブネット範囲から使用可能な IP アドレス（10.129.0.0/23 内の 10.129.0.10 など）を選択して、SWP_IP_ADDRESS に割り当てます。

    注: swp.yaml ファイルに addresses フィールドを追加しない場合、Secure Web Proxy はプロキシ専用サブネットから IP アドレスを自動的に割り振ります。

  3. Secure Web Proxy ゲートウェイが受信クライアント エージェント接続を安全に受け入れるようにするには、Certificate Manager でリージョン SSL / TLS サーバー証明書を作成します。

    1. セルフマネージド証明書と秘密鍵を生成します。

      openssl req -x509 -newkey rsa:2048 -nodes \
    -keyout "swp.key" \
    -out "swp.crt" \
    -days 365 \
    -subj "/CN=SWP_IP_ADDRESS"

      SWP_IP_ADDRESS は、Secure Web Proxy ゲートウェイの IP アドレスに置き換えます。

    2. 証明書を Certificate Manager にアップロードするには、gcloud certificate-manager certificates create コマンドを実行します。

      gcloud certificate-manager certificates create SWP_CERTIFICATE_NAME \
    --location=REGION \
    --certificate-file="swp.crt" \
    --private-key-file="swp.key" \
    --project=PROJECT_ID

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

      • SWP_CERTIFICATE_NAME: 証明書リソースの名前
      • REGION: 証明書が作成されるリージョン
      • PROJECT_ID: Google Cloudプロジェクトの ID

  4. フロントエンド mTLS を有効にするには、ServerTlsPolicy リソースを作成します。Cloud Run などのワークロードが ID 証明書を IAP などのサービスに渡せるようにするには、clientValidationMode: ALLOW_INVALID_OR_MISSING_CLIENT_CERT を使用してポリシーを構成します。

    注: IAP を使用する場合は、clientValidationTrustConfig フィールドに値を設定しないでください。このフィールドはサポートされていません。

    1. server-tls-policy.yaml という名前のファイルを作成し、次の内容を追加します。

      name: projects/PROJECT_ID/locations/REGION/serverTlsPolicies/SERVER_TLS_POLICY_NAME
mtlsPolicy:
  clientValidationMode: ALLOW_INVALID_OR_MISSING_CLIENT_CERT

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

      • PROJECT_ID: Google Cloud プロジェクトの ID
      • REGION: ServerTlsPolicy が作成されるリージョン
      • SERVER_TLS_POLICY_NAME: ServerTlsPolicy リソースの名前

    2. ポリシーをインポートするには、gcloud network-security server-tls-policies import コマンドを実行します。

      gcloud network-security server-tls-policies import SERVER_TLS_POLICY_NAME \
    --source=server-tls-policy.yaml \
    --location=REGION \
    --project=PROJECT_ID

  5. tlsInspectionPolicy を接続するゲートウェイ セキュリティ ポリシーを作成します。

    1. gateway-security-policy.yaml という名前のファイルを作成し、次の内容を追加します。

      name: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/GATEWAY_SECURITY_POLICY_NAME
tlsInspectionPolicy: projects/PROJECT_ID/locations/REGION/tlsInspectionPolicies/TLS_INSPECTION_POLICY_NAME

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

      • PROJECT_ID: Google Cloud プロジェクトの ID
      • REGION: GatewaySecurityPolicy が作成されるリージョン
      • GATEWAY_SECURITY_POLICY_NAME: GatewaySecurityPolicy リソースの名前
      • TLS_INSPECTION_POLICY_NAME: TlsInspectionPolicy リソースの名前

    2. ポリシーをインポートするには、gcloud network-security gateway-security-policies import コマンドを実行します。

      gcloud network-security gateway-security-policies import GATEWAY_SECURITY_POLICY_NAME \
    --source=gateway-security-policy.yaml \
    --location=REGION \
    --project=PROJECT_ID

  6. swp.yaml という名前の Secure Web Proxy 仕様ファイルを作成します。

    name: projects/PROJECT_ID/locations/REGION/gateways/SECURE_WEB_PROXY_NAME
type: SECURE_WEB_GATEWAY
addresses:
  - "SWP_IP_ADDRESS"
ports:
  - 443
routingMode: EXPLICIT_ROUTING_MODE
certificateUrls:
  - projects/PROJECT_ID/locations/REGION/certificates/SWP_CERTIFICATE_NAME
serverTlsPolicy: projects/PROJECT_ID/locations/REGION/serverTlsPolicies/SERVER_TLS_POLICY_NAME
network: projects/PROJECT_ID/global/networks/NETWORK_NAME
subnetwork: projects/PROJECT_ID/regions/REGION/subnetworks/PROXY_SUBNET_NAME
gatewaySecurityPolicy: projects/PROJECT_ID/locations/REGION/gatewaySecurityPolicies/GATEWAY_SECURITY_POLICY_NAME

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

    • PROJECT_ID: Google Cloud プロジェクトの ID
    • REGION: Secure Web Proxy ゲートウェイが作成されるリージョン
    • SECURE_WEB_PROXY_NAME: Secure Web Proxy ゲートウェイの名前
    • SWP_IP_ADDRESS: Secure Web Proxy ゲートウェイの IP アドレス
    • SWP_CERTIFICATE_NAME: Secure Web Proxy ゲートウェイに関連付けられている証明書の名前
    • SERVER_TLS_POLICY_NAME: ServerTlsPolicy リソースの名前
    • NETWORK_NAME: VPC ネットワークの名前
    • PROXY_SUBNET_NAME: プロキシ専用サブネットの名前
    • GATEWAY_SECURITY_POLICY_NAME: GatewaySecurityPolicy リソースの名前

  7. Secure Web Proxy ゲートウェイをインポートするには、gcloud network-services gateways import コマンドを実行します。

    gcloud network-services gateways import SECURE_WEB_PROXY_NAME \
    --source=swp.yaml \
    --location=REGION \
    --project=PROJECT_ID

ワークロードのダウンタイムを発生させずに、既存の Secure Web Proxy ゲートウェイでこれらのフィールドを変更するには、次の操作を行います。

  1. 新しい名前と必要な構成で別の Secure Web Proxy ゲートウェイを作成します。

  2. 新しい Secure Web Proxy ゲートウェイを参照するように agentGateway リソース（selfManaged.resourceUris）を更新します。

  3. 新しい Secure Web Proxy ゲートウェイを指すように EgressRouting リソースを更新します。

  4. 新しいゲートウェイがトラフィック ルートを正常に管理していることを確認したら、agentGateway リソースから古い Secure Web Proxy ゲートウェイを削除し、古いゲートウェイ リソースを削除します。

Secure Web Proxy インスタンスを Agent Gateway に関連付ける

Secure Web Proxy インスタンスを agentGateway リソースに関連付けるには、次の操作を行います。

  1. agent-gateway.yaml という名前の構成ファイルを作成します。

    name: projects/PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_NAME
selfManaged:
  resourceUris:
    - //networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/gateways/SECURE_WEB_PROXY_NAME
registries:
  - //agentregistry.googleapis.com/projects/PROJECT_ID/locations/REGION

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

    • PROJECT_ID: Google Cloud プロジェクトの ID
    • REGION: Agent Gateway が作成されるリージョン
    • AGENT_GATEWAY_NAME: Agent Gateway の名前
    • SECURE_WEB_PROXY_NAME: Secure Web Proxy インスタンスの名前

    省略可: registries フィールドは、Agent Gateway を Agent Registry に関連付けます。宛先またはツールの解決に Agent Registry を使用しない場合は、registries フィールドを指定しないでください。

  2. agentGateway リソースをインポートするには、gcloud beta network-services agent-gateways import コマンドを実行します。

    gcloud beta network-services agent-gateways import AGENT_GATEWAY_NAME \
    --source=agent-gateway.yaml \
    --location=REGION \
    --project=PROJECT_ID

拡張機能のバインディングと認可ポリシーを構成する

アウトバウンド AI エージェント トラフィックを管理するには、agentGateway リソースに拡張機能バインディングと認可ポリシーを構成します。プロキシは、基盤となる Secure Web Proxy Gateway リソースに直接接続されているポリシーを無視します。

Agent Gateway は、次の 2 つのガバナンス レイヤをサポートしています。

  • 拡張機能バインディング: Service Extensions を使用して、IAP や Model Armor などの外部セキュリティ サービスとガバナンス サービスを Agent Gateway に直接接続します。

  • 認可ポリシー: L7 MCP メソッドの制限と L4 ネットワーク ルールを適用します。

拡張機能バインディングを Agent Gateway にアタッチする

Service Extensions の拡張機能バインディングを使用して、マネージド サービスを Agent Gateway にバインドし、エージェントのインタラクションを検査、認証、制御します。

ステップ 1: Identity-Aware Proxy（IAP）を Agent Gateway にバインドする

トラフィックがターゲット ツールに到達する前にエージェントの呼び出し元の ID を検証し、アクセス ポリシーを適用するには、次の操作を行って IAP を Agent Gateway にバインドします。

  1. ext-binding-iap.yaml という名前の構成ファイルを作成します。

    name: ext-binding-iap
target:
  resources:
  - "//networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_NAME"
failOpen: false
producerExtension: iap.googleapis.com
matchConditions:
- to:
    destination:
      resources:
      - prefix: "urn:mcp"
    notDestinations:
      hosts:
      - suffix: ".googleapis.com"

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

    • PROJECT_ID: Google Cloud プロジェクトの ID
    • REGION: 拡張機能バインディングが作成されるリージョン
    • AGENT_GATEWAY_NAME: Agent Gateway の名前

  2. 拡張機能バインディングをインポートするには、gcloud beta service-extensions extension-bindings import コマンドを実行します。

    gcloud beta service-extensions extension-bindings import ext-binding-iap \
    --source=extension-binding-iap.yaml \
    --location=REGION

詳細については、IAP に認可を委任するをご覧ください。

ステップ 2: プロンプトとレスポンスのサニタイズに Model Armor をバインドする

プロンプト インジェクション、有害なコンテンツ、機密データの漏洩から保護するには、次の操作を行って Model Armor を Agent Gateway にバインドします。

  1. ext-binding-model-armor.yaml という名前の構成ファイルを作成します。

    name: ext-binding-model-armor
target:
  resources:
  - "//networkservices.googleapis.com/projects/PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_NAME"
failOpen: false
producerExtension: modelarmor.googleapis.com
producerMetadata:
  model_armor_settings: '[
    {
      "request_template_id": "projects/PROJECT_ID/locations/REGION/templates/REQUEST_TEMPLATE_ID",
      "response_template_id": "projects/PROJECT_ID/locations/REGION/templates/RESPONSE_TEMPLATE_ID"
    }
  ]'
matchConditions:
- to:
    destination:
      resources:
      - prefix: "urn:mcp"

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

    • PROJECT_ID: Google Cloud プロジェクトの ID
    • REGION: 拡張機能バインディングが作成されるリージョン
    • AGENT_GATEWAY_NAME: Agent Gateway の名前
    • REQUEST_TEMPLATE_ID: Model Armor リクエスト テンプレートの ID
    • RESPONSE_TEMPLATE_ID: Model Armor レスポンス テンプレートの ID

  2. 拡張機能バインディングをインポートするには、gcloud beta service-extensions extension-bindings import コマンドを実行します。

    gcloud beta service-extensions extension-bindings import ext-binding-model-armor \
    --source=extension-binding-model-armor.yaml \
    --location=REGION

詳細については、Model Armor に認可を委任すると、Secure Web Proxy の認可ポリシーを設定するの例 3: 拡張機能バインディングを使用して Model Armor でディープ ペイロード検査を有効にするをご覧ください。

認可ポリシーを使用して MCP ツールを制限する

エージェント ツールの検出と実行を承認済みのツールに制限するには、次の操作を行って認可ポリシーを作成してインポートします。

  1. authz-policy-restrict-mcp-tools.yaml という名前の構成ファイルを作成します。

    name: authz-policy-restrict-mcp-tools
target:
  resources:
  - "projects/PROJECT_ID/locations/REGION/agentGateways/AGENT_GATEWAY_NAME"
policyProfile: REQUEST_AUTHZ
httpRules:
- to:
    operations:
    - mcp:
        baseProtocolMethodsOption: MATCH_BASE_PROTOCOL_METHODS
        methods:
        - name: "tools/list"
        - name: "tools/call"
          params:
          - exact: "get_weather"
          - exact: "get_location"
action: ALLOW

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

    • PROJECT_ID: Google Cloud プロジェクトの ID
    • REGION: 認可ポリシーが作成されるリージョン
    • AGENT_GATEWAY_NAME: Agent Gateway の名前

  2. 認可ポリシーをインポートするには、gcloud network-security authz-policies import コマンドを実行します。

    gcloud network-security authz-policies import authz-policy-restrict-mcp-tools \
    --source=authz-policy-restrict-mcp-tools.yaml \
    --location=REGION \
    --project=PROJECT_ID

Agent Gateway 経由でエージェントをルーティングする

Agent Gateway を構成して認可ポリシーをアタッチしたら、アウトバウンド トラフィックを Secure Web Proxy インスタンスに転送するように Agent Runtime 環境を構成する必要があります。アウトバウンド トラフィック ルーティングは、ネットワーク層で透過的に動作し、エージェント アプリケーション コードを変更することなく、リクエストをゲートウェイにリダイレクトします。

AI ワークロードの実行場所に応じて、次のドキュメント アセットを参照してアウトバウンド ルーティングを構成します。

  • GKE: Cloud Service Mesh アンビエント ネットワーキングを使用して、ノードレベルでアウトバウンド エージェント トラフィックをインターセプトし、HTTP CONNECT トンネルを介して Secure Web Proxy インスタンスに転送します。クラスタにルーティング ポリシーを構成するには、Secure Web Proxy を介してアンビエント下り（外向き）トラフィックをルーティングすると GKE 用 Agent Gateway をご覧ください。
  • Cloud Run: アウトバウンド エージェント トラフィックを VPC ネットワークに送信するようにダイレクト VPC 下り（外向き）を構成します。VPC ネットワークでは、Cloud Run アンビエント ネットワーキングが、エージェントの ID を含む HTTP CONNECT トンネルを介してリクエストを Secure Web Proxy インスタンスにリダイレクトします。アウトバウンド トラフィックのルーティングを設定するには、VPC ネットワークを使用したダイレクト VPC と Cloud Run 用 Agent Gateway をご覧ください。

テレメトリー、ロギング、モニタリング

Secure Web Proxy ゲートウェイが Agent Gateway リソースに関連付けられている場合、トランザクション ログは標準の Secure Web Proxy networkservices.googleapis.com/Gateway モニタリング対象リソースの下に出力されます。ロギングはデフォルトで有効になっており、サンプリング レートは 1.0 です。

ロギング

Cloud Logging のログエントリは LoadBalancerLogEntry 形式を使用し、次の AI エージェントとセキュリティ ペイロード フィールドが含まれています。

  • agentGatewayInfo: エージェント トランザクションに関するメタデータが含まれます。

    • agentRegistryResource: 一致した Agent Registry ターゲットの完全なリソース名（MCP サーバーやスキルなど）
    • destinationUrn: 宛先 URN に関する情報
    • mcpInfo: MCP JSON-RPC 呼び出しの詳細（tools/call や resources/read などのメソッド、ツール名、リソース URI など）

  • authzPolicyInfo: 認可評価の結果（ALLOWED または DENIED）と一致ポリシーの名前

  • tls: TLS ネゴシエーションの詳細と暗号化クライアント証明書（mTLS）の検証属性（clientCertPresent、clientCertSha256Fingerprint など）

モニタリング指標

Agent Gateway は、次の指標を Cloud Monitoring にエクスポートします。

  • MCP の期間:

    • gcp.mcp.server.operation.duration: MCP ツールサーバーが実行するオペレーションのレイテンシ
    • gcp.mcp.client.operation.duration: MCP クライアント呼び出しのエンドツーエンドの往復時間

  • HTTP レイテンシ:

    • http.server.request.duration: ゲートウェイが処理する受信エージェント リクエストの実行レイテンシ
    • http.client.request.duration: プロキシから外部の宛先へのアウトバウンド リクエストのレイテンシ

  • トラフィック スループット:

    • gcp.server.request.total_size と gcp.server.response.total_size: ゲートウェイが送受信するリクエストとレスポンスのサイズ（バイト単位）
    • gcp.client.request.total_size と gcp.client.response.total_size: ゲートウェイが外部の宛先に送信するリクエストとレスポンスのサイズ（バイト単位）

次のステップ