Einige oder alle Informationen auf dieser Seite gelten möglicherweise nicht für Cloud de Confiance von S3NS. Weitere Informationen finden Sie unter Unterschiede zu Google Cloud.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Model Armor-Trace-Spans ansehen

In diesem Dokument werden die Model Armor-Spans in Traces und das Aufrufen ihrer Details beschrieben. Weitere Informationen zu Traces finden Sie unter Agent-Traces ansehen.

Cloud Trace und Agent-Beobachtbarkeit

Ein Trace stellt den Pfad einer Anfrage über alle Teile Ihrer verteilten Anwendung hinweg dar. Jeder Trace steht also für einen einzelnen End-to-End-Vorgang. Da Traces aus Spans bestehen, die Datensätze für eine einzelne Funktion oder einen einzelnen Vorgang sind, können Sie den Fluss von Anfragen nachvollziehen und Latenzdaten untersuchen. Diese Informationen können Ihnen helfen, die Ursache eines Problems zu ermitteln.

Cloud Trace ist das System für verteiltes Tracing für Cloud de Confiance by S3NS. Es bietet Funktionen zum Untersuchen von Traces oder zum Analysieren von Trace-Daten mit SQL. VieleCloud de Confiance -Dienste wie Application Monitoring und die Agent-Registrierung können jedoch die von Cloud Trace verwalteten Daten anzeigen. Mit diesen Diensten können Sie Tracedaten im Kontext des von Ihnen verwendeten Dienstes ansehen.

Hinweis

Aktivieren Sie die APIs Cloud Trace, Cloud Logging, Telemetry und Model Armor, falls sie noch nicht aktiviert sind.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen
APIs aktivieren
Tracing für Ihren Agenten einrichten
Model Armor auf einem Gateway oder auf einem Cloud de Confiance-MCP-Server konfigurieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Aufrufen von Tracedaten haben:

Cloud Trace User (roles/cloudtrace.user)
Loganzeige (roles/logging.viewer)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Informationen zu anderen Rollen, die Sie möglicherweise benötigen, finden Sie unter Cloud Trace-Zugriffssteuerung und Cloud Logging-Zugriffssteuerung.

Unterstützte Nutzlasten

Eine Liste der unterstützten Nutzlasten finden Sie unter Unterstützte und nicht unterstützte Nutzlasten.

Bei einer Anfrage mit einer nicht unterstützten Nutzlast generiert Model Armor einen Bereich mit einem Fehler.

Model Armor-Spannennamen und ‑attribute

Die folgenden Model Armor-Bereiche sind verfügbar:

Übergeordneter Bereich: apply_guardrail "Google Cloud Model Armor"
Zeitraum für untergeordnete Elemente: Request Path
Zeitraum für untergeordnete Elemente: Response Path

In den folgenden Abschnitten sind alle möglichen Attribute eines Model Armor-Spans aufgeführt. Nicht alle Attribute sind in jedem Zeitraum vorhanden. Diese Attributnamen können sich ändern.

Attribute für übergeordnete Spannen

Der übergeordnete Span apply_guardrail "Google Cloud Model Armor" hat die folgenden Attribute:

cloud.provider: Der Cloud-Anbieter, der dem Vorgang zugeordnet ist.
cloud.region: die Cloud de Confiance by S3NS Region, in der der Vorgang ausgeführt wurde.
gcp.project_id: die ID des Projekts, in dem der Vorgang ausgeführt wurde.
rpc.system: das zugrunde liegende Remote-Prozeduraufruf (RPC)-Framework oder -Protokoll, das für den Vorgang verwendet wurde, z. B. grpc.
service.name: Der Cloud de Confiance -Dienst, der dem Vorgang zugeordnet ist. Bei Model Armor-Spannen ist der Wert dieses Felds modelarmor.

Attribute für den Anfragepfad

Der untergeordnete Request Path-Span hat die folgenden Attribute:

gen_ai.security.target.type: Der Inhaltstyp oder die Aktion, auf die die Richtlinie angewendet wird. Im Request Path-Zeitraum ist dies immer input.
gen_ai.security.decision.type: Das Ergebnis oder die Aktion, die von Model Armor angewendet wurde. Der Wert modify gibt an, dass Model Armor sensible Daten aus dem Inhalt gemäß der bereitgestellten Vorlage pseudonymisiert hat.
gen_ai.security.decision.code: Ein numerischer Code für die Sicherheitsentscheidung.
gen_ai.security.decision.reason: ein für Nutzer lesbarer Grund für die Entscheidung.
gen_ai.security.policy.id: Der vollständige Ressourcenname der Model Armor-Vorlage im Format projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name: Der Name der Model Armor-Vorlage, die für den Vorgang verwendet wurde.
gcp.modelarmor.filter.match.state: Gibt an, ob die Inhalte gegen einen der Model Armor-Filter (auch Detectors genannt) verstoßen haben.
gcp.modelarmor.violations: die Model Armor-Filter, gegen die die Inhalte verstoßen haben. Der Wert deidentified gibt an, dass Model Armor vertrauliche Daten aus dem Inhalt gemäß der bereitgestellten Vorlage entfernt hat.
gcp.modelarmor.rai.violations: Die Kategorien für verantwortungsbewusste Anwendung von KI, gegen die der Inhalt verstoßen hat. Weitere Informationen finden Sie unter Sicherheitsfilter für die verantwortungsbewusste Anwendung von KI.
gcp.modelarmor.sdp.info_types: die von Sensitive Data Protection-Filtern identifizierten Typen sensibler Daten (z. B. EMAIL_ADDRESS oder PHONE_NUMBER).
error.type: Eine Kennung für den aufgetretenen Fehler.

Attribute des Antwortpfads

Der untergeordnete Response Path-Span hat die folgenden Attribute:

gen_ai.security.target.type: Der Inhaltstyp oder die Aktion, auf die die Richtlinie angewendet wird. Im Response Path-Bereich ist dies immer output.
gen_ai.security.decision.type: Das Ergebnis oder die Aktion, die von Model Armor angewendet wurde. Der Wert modify gibt an, dass Model Armor sensible Daten gemäß der bereitgestellten Vorlage aus dem Inhalt entfernt (anonymisiert) hat.
gen_ai.security.decision.code: Ein numerischer Code für die Sicherheitsentscheidung.
gen_ai.security.decision.reason: ein für Nutzer lesbarer Grund für die Entscheidung.
gen_ai.security.policy.id: Der vollständige Ressourcenname der Model Armor-Vorlage im Format projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name: Der Name der Model Armor-Vorlage, die für den Vorgang verwendet wurde.
gcp.modelarmor.filter.match.state: Gibt an, ob die Inhalte gegen einen der Model Armor-Filter (auch Detectors genannt) verstoßen haben.
gcp.modelarmor.violations: die Model Armor-Filter, gegen die die Inhalte verstoßen haben. Der Wert deidentified gibt an, dass Model Armor vertrauliche Daten aus dem Inhalt gemäß der bereitgestellten Vorlage entfernt hat.
gcp.modelarmor.rai.violations: Die Kategorien für verantwortungsbewusste Anwendung von KI, gegen die der Inhalt verstoßen hat. Weitere Informationen finden Sie unter Sicherheitsfilter für die verantwortungsbewusste Anwendung von KI.
gcp.modelarmor.sdp.info_types: die von Sensitive Data Protection-Filtern identifizierten Typen sensibler Daten (z. B. EMAIL_ADDRESS oder PHONE_NUMBER).
error.type: Eine Kennung für den aufgetretenen Fehler.

Details eines Model Armor-Bereichs ansehen

So rufen Sie einen Model Armor-Span und seine Details auf, einschließlich seiner Attribute und seines DAG:

Rufen Sie in der Cloud de Confiance Console die Agent-Registrierung auf.
Zur Agent Registry
Wählen Sie Ihr Projekt aus.
Klicken Sie auf den Namen des Agents.
Klicken Sie auf den Tab Traces.
Klicken Sie auf die ID eines Traces, den Sie aufrufen möchten. Wenn der Trace einen Model Armor-Span umfasst, enthält er den apply_guardrail "Google Cloud Model Armor"-Span.
Trace ansehen:
- Wenn Sie den Trace als gerichteten azyklischen Graphen (Directed Acyclic Graph, DAG) ansehen möchten, klicken Sie auf die Ansicht Graph. In dieser Ansicht wird der Ausführungs-Trace eines Agents als Knoten-Link-Diagramm dargestellt. DAGs betonen die kausalen Beziehungen und Abhängigkeiten zwischen verschiedenen Trace-Spans und zeigen, wie ein Vorgang den nächsten auslöst. Jeder Knoten im Diagramm ist ein Bereich.
- Klicken Sie auf die Ansicht Zeitachse, um den Trace als Zeitachse anzusehen. Jeder Balken in der Zeitachse steht für einen Zeitraum.
Klicken Sie auf einen Bereich, um seine Attribute aufzurufen.

Alternativ können Sie auf In Cloud Trace ansehen klicken, um alle Spans in Ihrem Projekt über den Trace Explorer aufzurufen. Zeitraumfilter anwenden, um nach dem apply_guardrail "Google Cloud Model Armor"-Zeitraum zu suchen.