Monitorare il traffico tramite Agent Gateway

Anteprima privata - Agent Gateway

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Questa funzionalità offre funzionalità per governare e proteggere gli agenti AI, pertanto si applicano i Termini specifici dei servizi "Servizi di AI agentica". Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Per richiedere l'accesso a Agent Gateway con Agent Runtime, consulta la pagina di richiesta di accesso.

Utilizza questa pagina per scoprire come visualizzare i log e monitorare le richieste e le decisioni di controllo dell'accesso dell'accesso per il traffico instradato tramite il deployment del gateway dell'agente.

Logging

I log del gateway dell'agente vengono generati utilizzando la risorsa monitorata networkservices.googleapis.com/Gateway.

Puoi utilizzare questi log per monitorare le richieste di accesso al gateway. Sono inclusi i log creati quando il gateway dell'agente viene implementato in modalità di prova.

Visualizzare i log per un gateway specifico

Per visualizzare i log di un gateway specifico, completa i seguenti passaggi.

Query dalla console

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

   Vai a Esplora log

2. Fai clic sul pulsante di attivazione/disattivazione Mostra query.

3. Incolla quanto segue nel campo della query.

   resource.type="networkservices.googleapis.com/Gateway"
   resource.labels.location="REGION"
   resource.labels.gateway_name="AGENT_GATEWAY_NAME"
   

   Sostituisci quanto segue:

   • REGION: la regione del gateway.
   • AGENT_GATEWAY_NAME: il nome del gateway.

4. Fai clic su Esegui query.

Informazioni registrate nei log

Le voci di log di Agent Gateway contengono informazioni utili per monitorare ed eseguire il debug del traffico da e verso il gateway.

Campo	Formato campo	Tipo di campo: obbligatorio o facoltativo	Descrizione
				severity insertID timestamp receiveTimestamp trace traceSampled logName	LogEntry	Obbligatorio	I campi generali come descritti in una voce di log.
httpRequest	HttpRequest	Obbligatorio	Un protocollo comune per il logging delle richieste HTTP.
resource	MonitoredResource	Obbligatorio	MonitoredResource è il tipo di risorsa associato a una voce di log. Il tipo di risorsa per Agent Gateway è networkservices.googleapis.com/Gateway.
jsonPayload	oggetto (formato Struct)	Obbligatorio	Il payload della voce di log espresso come oggetto JSON. L'oggetto JSON contiene i seguenti campi di Agent Gateway: agentGatewayInfo: include informazioni sulle richieste del gateway dell'agente. mcpInfo: include informazioni sul metodo MCP della richiesta (ad esempio "tools/list" o "tools/call") e sul parametro principale associato al metodo, se presente. Ad esempio, nel caso del metodo "tools/call", il parametro è il nome dello strumento. agentRegistryResource: il nome della risorsa del registry degli agenti del server MCP, dell'agente o dell'endpoint corrispondente alla richiesta.

Monitoraggio

Agent Gateway esporta alcune metriche di Service Extensions in Cloud Monitoring. Se deleghi l'autorizzazione a Service Extensions, puoi utilizzare queste metriche per monitorare il traffico verso e da Service Extensions. Per maggiori dettagli, vedi Logging e monitoraggio per i callout di Cloud Load Balancing.