Il est possible qu'une partie ou l'ensemble des informations de cette page ne s'appliquent pas au Cloud de confiance S3NS. Pour en savoir plus, consultez Différences par rapport à Google Cloud.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Afficher les spans de trace Model Armor

Ce document décrit les étendues Model Armor dans les traces et explique comment afficher leurs détails. Pour en savoir plus sur les traces, consultez Afficher les traces de l'agent.

À propos de Cloud Trace et de l'observabilité des agents

Un trace représente le chemin d'une requête dans les différentes parties de votre application distribuée. Autrement dit, chaque trace représente une seule opération de bout en bout. Les traces étant composées de segments, qui sont des enregistrements pour une fonction ou une opération unique, elles vous permettent de suivre le flux des requêtes et d'examiner les données de latence. Ces informations peuvent vous aider à identifier l'origine d'un problème.

Cloud Trace est le système de traçage distribué pour Cloud de Confiance by S3NS. Il fournit des fonctionnalités permettant d'explorer les traces ou d'analyser les données de trace avec SQL. Toutefois, de nombreux servicesCloud de Confiance , tels que Application Monitoring et Agent Registry, peuvent afficher les données gérées par Cloud Trace. Ces services vous permettent d'afficher les données de trace dans le contexte du service que vous utilisez.

Avant de commencer

Activez les API Cloud Trace, Cloud Logging, Télémétrie et Model Armor, si ce n'est pas déjà fait.
Rôles requis pour activer les API
Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.
Activer les API
Configurez le traçage pour votre agent.
Configurez Model Armor sur une passerelle ou sur un Cloud de Confianceserveur MCP.

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les données de trace, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

Utilisateur Cloud Trace (roles/cloudtrace.user)
Lecteur de journaux (roles/logging.viewer)

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les autres rôles dont vous pourriez avoir besoin, consultez Contrôle des accès Cloud Trace et Contrôle des accès Cloud Logging.

Charges utiles acceptées

Pour obtenir la liste des charges utiles acceptées, consultez Charges utiles acceptées et non acceptées.

Pour une requête contenant une charge utile non acceptée, Model Armor génère une étendue avec une erreur.

Noms et attributs des segments Model Armor

Les étendues Model Armor suivantes sont disponibles :

Portée parente : apply_guardrail "Google Cloud Model Armor"
Portée enfant : Request Path
Portée enfant : Response Path

Les sections suivantes listent tous les attributs possibles d'une étendue Model Armor. Tous les attributs ne sont pas présents dans chaque étendue. Ces noms d'attributs sont susceptibles d'être modifiés.

Attributs de span parent

L'étendue parente, apply_guardrail "Google Cloud Model Armor", possède les attributs suivants :

cloud.provider : fournisseur de services cloud associé à l'opération.
cloud.region : région Cloud de Confiance by S3NS dans laquelle l'opération a eu lieu.
gcp.project_id : ID du projet dans lequel l'opération a eu lieu.
rpc.system : framework ou protocole d'appel de procédure à distance (RPC) sous-jacent utilisé pour l'opération, par exemple grpc.
service.name : service Cloud de Confiance associé à l'opération. Pour les spans Model Armor, la valeur de ce champ est modelarmor.

Attributs du chemin de requête

L'étendue enfant Request Path comporte les attributs suivants :

gen_ai.security.target.type : type de contenu ou d'action auquel la barrière de sécurité s'applique. Dans le segment Request Path, il s'agit toujours de input.
gen_ai.security.decision.type : verdict ou action appliquée par Model Armor. La valeur modify indique que Model Armor a masqué (désidentifié) les données sensibles du contenu conformément au modèle fourni.
gen_ai.security.decision.code : code numérique pour la décision de sécurité.
gen_ai.security.decision.reason : raison de la décision, lisible par l'utilisateur.
gen_ai.security.policy.id : nom complet de la ressource du modèle Model Armor au format projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name : nom du modèle Model Armor utilisé pour l'opération.
gcp.modelarmor.filter.match.state : indique si le contenu a enfreint l'un des filtres Model Armor (également appelés détecteurs).
gcp.modelarmor.violations : filtres Model Armor enfreints par le contenu. Une valeur deidentified indique que Model Armor a masqué les données sensibles du contenu conformément au modèle fourni.
gcp.modelarmor.rai.violations : catégories d'IA responsable que le contenu a enfreintes. Pour en savoir plus, consultez Filtre de sécurité de l'IA responsable.
gcp.modelarmor.sdp.info_types : types de données sensibles (tels que EMAIL_ADDRESS ou PHONE_NUMBER) identifiés par les filtres Sensitive Data Protection.
error.type : identifiant de l'erreur rencontrée.

Attributs du chemin de réponse

L'étendue enfant Response Path comporte les attributs suivants :

gen_ai.security.target.type : type de contenu ou d'action auquel la barrière de sécurité s'applique. Dans le segment Response Path, la valeur est toujours output.
gen_ai.security.decision.type : verdict ou action appliquée par Model Armor. La valeur modify indique que Model Armor a masqué (désidentifié) les données sensibles du contenu conformément au modèle fourni.
gen_ai.security.decision.code : code numérique pour la décision de sécurité.
gen_ai.security.decision.reason : raison de la décision, lisible par l'utilisateur.
gen_ai.security.policy.id : nom complet de la ressource du modèle Model Armor au format projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name : nom du modèle Model Armor utilisé pour l'opération.
gcp.modelarmor.filter.match.state : indique si le contenu a enfreint l'un des filtres Model Armor (également appelés détecteurs).
gcp.modelarmor.violations : filtres Model Armor enfreints par le contenu. Une valeur deidentified indique que Model Armor a masqué les données sensibles du contenu conformément au modèle fourni.
gcp.modelarmor.rai.violations : catégories d'IA responsable que le contenu a enfreintes. Pour en savoir plus, consultez Filtre de sécurité de l'IA responsable.
gcp.modelarmor.sdp.info_types : types de données sensibles (tels que EMAIL_ADDRESS ou PHONE_NUMBER) identifiés par les filtres Sensitive Data Protection.
error.type : identifiant de l'erreur rencontrée.

Afficher les détails d'une étendue Model Armor

Pour afficher un segment Model Armor et ses détails (y compris ses attributs et son DAG), procédez comme suit :

Dans la console Cloud de Confiance , accédez à Agent Registry.
Accéder au registre d'agents
Sélectionnez votre projet.
Cliquez sur le nom de l'agent.
Cliquez sur l'onglet Traces.
Cliquez sur l'ID d'une trace que vous souhaitez afficher. Si la trace implique un segment Model Armor, la trace inclut le segment apply_guardrail "Google Cloud Model Armor".
Explorez la trace :
- Pour afficher la trace sous forme de graphe orienté acyclique (DAG), cliquez sur la vue Graphique. Cette vue représente la trace d'exécution d'un agent sous la forme d'un diagramme de nœuds et de liens. Les DAG mettent en évidence les relations de causalité et les dépendances entre les différentes portées de trace, et montrent comment une opération déclenche la suivante. Chaque nœud du graphique est une étendue.
- Pour afficher la trace sous forme de chronologie, cliquez sur la vue Chronologie. Chaque barre de la chronologie représente un segment.
Cliquez sur un segment pour afficher ses attributs.

Vous pouvez également cliquer sur Afficher dans Cloud Trace pour afficher tous les spans de votre projet dans l'explorateur Trace. Appliquez des filtres d'étendue pour rechercher l'étendue apply_guardrail "Google Cloud Model Armor".