Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Visualizzare gli intervalli di traccia di Model Armor

Questo documento descrive gli intervalli di Model Armor all'interno delle tracce e come visualizzarne i dettagli. Per saperne di più sulle tracce, consulta Visualizza le tracce dell'agente.

Informazioni su Cloud Trace e sull'osservabilità degli agenti

Una traccia rappresenta il percorso di una richiesta attraverso le parti della tua applicazione distribuita. In altre parole, ogni traccia rappresenta una singola operazione end-to-end. Poiché le tracce sono composte da intervalli, che sono record per una singola funzione o operazione, ti consentono di seguire il flusso delle richieste ed esaminare i dati sulla latenza. Queste informazioni possono aiutarti a identificare la causa principale di un problema.

Cloud Trace è il sistema di tracciamento distribuito per Google Cloude fornisce funzionalità per esplorare le tracce o per analizzare i dati delle tracce con SQL. Tuttavia, molti serviziGoogle Cloud , come Application Monitoring e Agent Registry, possono visualizzare i dati gestiti da Cloud Trace. Questi servizi ti consentono di visualizzare i dati di traccia nel contesto del servizio che stai utilizzando.

Prima di iniziare

Abilita le API Cloud Trace, Cloud Logging, Telemetry e Model Armor, se non sono già abilitate.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.
Abilita le API
Configura il tracciamento per il tuo agente.
Configura Model Armor su un gateway o su un server MCPGoogle Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare i dati di traccia, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Utente Cloud Trace (roles/cloudtrace.user)
Visualizzatore log (roles/logging.viewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per informazioni su altri ruoli di cui potresti avere bisogno, consulta Controllo dell'accesso a Cloud Trace e Controllo dell'accesso a Cloud Logging.

Payload supportati

Per un elenco dei payload supportati, consulta Payload supportati e non supportati.

Per una richiesta che contiene un payload non supportato, Model Armor genera uno span con un errore.

Nomi e attributi degli intervalli di Model Armor

Sono disponibili i seguenti intervalli di Model Armor:

Intervallo principale: apply_guardrail "Google Cloud Model Armor"
Intervallo secondario: Request Path
Intervallo secondario: Response Path

Le sezioni seguenti elencano tutti i possibili attributi di uno span di Model Armor. Non tutti gli attributi sono presenti in ogni intervallo. Questi nomi degli attributi sono soggetti a modifiche.

Attributi degli intervalli padre

L'intervallo principale, apply_guardrail "Google Cloud Model Armor", ha i seguenti attributi:

cloud.provider: il cloud provider associato all'operazione.
cloud.region: la regione Google Cloud in cui si è verificata l'operazione.
gcp.project_id: l'ID del progetto in cui si è verificata l'operazione.
rpc.system: il framework o il protocollo di chiamata di procedura remota (RPC) sottostante utilizzato per l'operazione, ad esempio grpc.
service.name: il servizio Google Cloud associato all'operazione. Per gli intervalli di Model Armor, il valore di questo campo è modelarmor.

Attributi del percorso della richiesta

L'intervallo secondario Request Path ha i seguenti attributi:

gen_ai.security.target.type: il tipo di contenuto o azione a cui viene applicato il guardrail. Nell'intervallo Request Path, questo valore è sempre input.
gen_ai.security.decision.type: il verdetto o l'azione applicata da Model Armor. Un valore modify indica che Model Armor ha oscurato (anonimizzato) i dati sensibili dal contenuto in base al template fornito.
gen_ai.security.decision.code: un codice numerico per la decisione di sicurezza.
gen_ai.security.decision.reason: un motivo della decisione leggibile dall'utente.
gen_ai.security.policy.id: il nome completo della risorsa del template Model Armor nel formato projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name: il nome del template Model Armor utilizzato per l'operazione.
gcp.modelarmor.filter.match.state: indica se i contenuti hanno violato uno dei filtri di Model Armor (chiamati anche rilevatori).
gcp.modelarmor.violations: i filtri di Model Armor violati dai contenuti. Un valore deidentified indica che Model Armor ha oscurato i dati sensibili dai contenuti in base al template fornito.
gcp.modelarmor.rai.violations: le categorie di AI responsabile che i contenuti hanno violato. Per saperne di più, consulta Filtro di sicurezza dell'AI responsabile.
gcp.modelarmor.sdp.info_types: i tipi di dati sensibili (come EMAIL_ADDRESS o PHONE_NUMBER) identificati dai filtri di Sensitive Data Protection.
error.type: un identificatore dell'errore riscontrato.

Attributi del percorso di risposta

L'intervallo secondario Response Path ha i seguenti attributi:

gen_ai.security.target.type: il tipo di contenuto o azione a cui viene applicato il guardrail. Nell'intervallo Response Path, questo valore è sempre output.
gen_ai.security.decision.type: il verdetto o l'azione applicata da Model Armor. Un valore modify indica che Model Armor ha oscurato (anonimizzato) i dati sensibili dal contenuto in base al template fornito.
gen_ai.security.decision.code: un codice numerico per la decisione di sicurezza.
gen_ai.security.decision.reason: un motivo della decisione leggibile dall'utente.
gen_ai.security.policy.id: il nome completo della risorsa del template Model Armor nel formato projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name: il nome del template Model Armor utilizzato per l'operazione.
gcp.modelarmor.filter.match.state: indica se i contenuti hanno violato uno dei filtri di Model Armor (chiamati anche rilevatori).
gcp.modelarmor.violations: i filtri di Model Armor violati dai contenuti. Un valore deidentified indica che Model Armor ha oscurato i dati sensibili dai contenuti in base al template fornito.
gcp.modelarmor.rai.violations: le categorie di AI responsabile che i contenuti hanno violato. Per saperne di più, consulta Filtro di sicurezza dell'AI responsabile.
gcp.modelarmor.sdp.info_types: i tipi di dati sensibili (come EMAIL_ADDRESS o PHONE_NUMBER) identificati dai filtri di Sensitive Data Protection.
error.type: un identificatore dell'errore riscontrato.

Visualizza i dettagli di un intervallo di Model Armor

Per visualizzare uno span di Model Armor e i relativi dettagli, inclusi gli attributi e il DAG, segui questi passaggi:

Nella console Google Cloud , vai a Registro degli agenti.
Vai ad Agent Registry
Seleziona il progetto.
Fai clic sul nome dell'agente.
Fai clic sulla scheda Tracce.
Fai clic sull'ID di una traccia che vuoi visualizzare. Se la traccia include uno span di Model Armor, la traccia include lo span apply_guardrail "Google Cloud Model Armor".
Esplora la traccia:
- Per visualizzare la traccia come grafo diretto aciclico (DAG), fai clic sulla visualizzazione Grafico. Questa visualizzazione rappresenta la traccia di esecuzione di un agente come un diagramma nodo-link. I DAG enfatizzano le relazioni di causa-effetto e le dipendenze tra i diversi intervalli di traccia e mostrano come un'operazione ne attiva un'altra. Ogni nodo nel grafico è uno span.
- Per visualizzare la traccia come sequenza temporale, fai clic sulla visualizzazione Cronologia. Ogni barra nella cronologia rappresenta un intervallo.
Fai clic su un intervallo per visualizzarne gli attributi.

In alternativa, fai clic su Visualizza in Cloud Trace per visualizzare tutti gli intervalli nel progetto tramite Esplora tracce. Applica i filtri degli span per cercare lo span apply_guardrail "Google Cloud Model Armor".