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 segments 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

Une trace représente le chemin d'une requête à travers les parties de votre application distribuée. Autrement dit, chaque trace représente une seule opération de bout en bout. Comme les traces sont composées de segments, qui sont des enregistrements pour une seule fonction ou opération, 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 Google Cloud. Il fournit des fonctionnalités permettant d'explorer les traces ou d'analyser les données de trace avec SQL. Toutefois, de nombreux servicesGoogle Cloud , 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, Telemetry et Model Armor si elles ne le sont pas déjà.
Rôles requis pour activer les API
Pour activer des API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le 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 serveur MCPGoogle Cloud.

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)
Visionneuse 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 compatibles

Pour obtenir la liste des charges utiles compatibles, consultez Charges utiles compatibles et non compatibles.

Pour une requête contenant une charge utile non compatible, Model Armor génère un span avec une erreur.

Noms et attributs des segments Model Armor

Les segments Model Armor suivants sont disponibles :

Segment parent : apply_guardrail "Google Cloud Model Armor"
Segment enfant : Request Path
Segment enfant : Response Path

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

Attributs de segment parent

Le segment parent, 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 Google Cloud 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 Google Cloud associé à l'opération. Pour les segments Model Armor, la valeur de ce champ est modelarmor.

Attributs de chemin de requête

Le segment enfant Request Path possède les attributs suivants :

gen_ai.security.target.type : type de contenu ou d'action auquel la protection est appliquée. Dans l'intervalle Request Path, la valeur est toujours input.
gen_ai.security.decision.type : verdict ou action appliqué par Model Armor. La valeur modify indique que Model Armor a masqué (anonymisé) les données sensibles du contenu conformément au modèle fourni.
gen_ai.security.decision.code : code numérique de la décision de sécurité.
gen_ai.security.decision.reason : raison de la décision, dans un format 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 que le contenu a enfreints. La 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 de chemin de réponse

Le segment enfant Response Path possède les attributs suivants :

gen_ai.security.target.type : type de contenu ou d'action auquel la protection est appliquée. Dans l'intervalle Response Path, il s'agit toujours de output.
gen_ai.security.decision.type : verdict ou action appliqué par Model Armor. La valeur modify indique que Model Armor a masqué (anonymisé) les données sensibles du contenu conformément au modèle fourni.
gen_ai.security.decision.code : code numérique de la décision de sécurité.
gen_ai.security.decision.reason : raison de la décision, dans un format 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 que le contenu a enfreints. La 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'un span 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 Google Cloud , 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, elle 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 liens entre nœuds. Les DAG mettent en évidence les relations de cause à effet et les dépendances entre les différents segments de trace, et montrent comment une opération en déclenche une autre. Chaque nœud du graphique est un segment.
- 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 segments de votre projet via l'explorateur Trace. Appliquez des filtres de segment pour rechercher le segment apply_guardrail "Google Cloud Model Armor".