Hinweis:Diese Dokumentation gilt für die Standard-, Plus-, Pay-as-you-go- und Frontline-Version von Gemini Enterprise. Die Dokumentation für die Business-Version finden Sie in der Gemini Enterprise-Hilfe für die Business-Version.
Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.
Mit Cloud Logging auf Audit-Logs zur Nutzung von Gemini Enterprise zugreifen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird beschrieben, wie Sie Audit-Logs zur Nutzung für Gemini Enterprise einrichten und darauf zugreifen.
Wichtige Konzepte
In diesem Abschnitt werden wichtige Konzepte im Zusammenhang mit der Beobachtbarkeit in Gemini Enterprise vorgestellt.
Konzept
Beschreibung
Audit-Logs zur Nutzung
Audit-Logs zur Nutzung sind Aufzeichnungen von Verwaltungsaktivitäten und Zugriffen in Ihren Google Cloud -Ressourcen. Sie enthalten detaillierte Informationen darüber, wer welche Aktion wann und von wo aus ausgeführt hat. Diese Logs sind für Sicherheitsaudits, Compliance und das Verständnis der Nutzung Ihrer Ressourcen unerlässlich.
Hinweis
Bevor Sie Audit-Logs konfigurieren, müssen Sie Folgendes haben:
Zum Aktivieren des Audit-Loggings benötigen Sie die IAM-Rolle Gemini Enterprise Admin (roles/discoveryengine.agentspaceAdmin).
Für den Zugriff auf Cloud Logging benötigen Sie die IAM-Rolle Loganzeige (roles/logging.viewer).
Sie müssen eine Gemini Enterprise-App erstellt haben. Informationen zum Erstellen einer App finden Sie unter App erstellen.
Logdaten
In der folgenden Tabelle sind die von Gemini Enterprise protokollierten Nutzungsdaten zusammengefasst.
Die Felder sind folgendermaßen beschriftet:
Sensibel: Das Feld kann Prompts, Antworten oder andere Kundeninhalte enthalten. Sie werden nur protokolliert, wenn die Einstellung Logging von Prompt-Eingaben und Antwortausgaben aktivieren aktiviert ist. Wenn die Einstellung deaktiviert ist, werden Textwerte durch <elided> ersetzt und andere Werte weggelassen. Weitere Informationen finden Sie unter Beobachtbarkeitseinstellungen aktivieren.
Nicht vertraulich: Das Feld wird unabhängig davon protokolliert, ob die Einstellung aktiviert ist oder nicht.
Teilweise sensibel: Nur die aufgeführten Unterfelder sind sensibel. Alle anderen Unterfelder sind nicht sensibel.
Dienstpfad
In Logs erfasste Daten
SearchService.Search
Protokolliert die Daten zu den Quellen, die für die Fundierung oder als LLM-Eingabe verwendet werden.
Anfrage:
query (sensibel)
user_info (teilweise sensibel). Nur die folgenden untergeordneten Felder sind sensibel:
time_zone
precise_location
Antwort:
attribution_token (nicht sensibel)
results.id (nicht sensibel)
results.document.name (nicht sensibel)
AssistantService.Assist
Protokolliert die Anfrage und Antwort des Gemini Enterprise-Assistenten.
answer.replies.grounded_content.text_grounding_metadata.references (teilweise sensibel). Alle Unterfelder sind vertraulich, mit Ausnahme von document_metadata.document und document_metadata.uri.
answer.skipped_reasons (nicht sensibel)
agent_info.agent (nicht sensibel)
agent_info.display_name (sensibel)
agent_info.core_assistant (nicht sensibel)
agent_info.agent_kind (nicht sensibel)
agent_info.spiffe_id (nicht sensibel)
AssistantService.StreamAssist
Anfrage:
name (nicht sensibel)
query.text (sensibel)
query.parts (sensibel)
agents_spec (teilweise sensibel). Nur die folgenden untergeordneten Felder sind sensibel:
answer.replies.grounded_content.text_grounding_metadata.references (teilweise sensibel). Alle Unterfelder sind vertraulich, mit Ausnahme von document_metadata.document und document_metadata.uri.
answer.skipped_reasons (nicht sensibel)
agent_info.agent (nicht sensibel)
agent_info.display_name (sensibel)
agent_info.core_assistant (nicht sensibel)
agent_info.agent_kind (nicht sensibel)
agent_info.spiffe_id (nicht sensibel)
model_info.model (nicht sensibel)
model_info.requested_model (nicht sensibel)
model_info.model_selection_mode (nicht sensibel)
model_info.model ist das Modell, das der Assistent für die Runde ausgeführt hat. Wenn in der Anfrage kein Modell angepinnt wird, ist model_selection_modeMODEL_SELECTION_MODE_AUTO und requested_model ist leer. Wenn in der Anfrage ein Modell angepinnt wird, ist model_selection_modeMODEL_SELECTION_MODE_EXPLICIT und requested_model enthält das angeforderte Modell.
Ein Turn kann an einen spezialisierten Agenten übergeben werden, der ein anderes Modell ausführt. model_info.model meldet das Modell dieses Agenten nicht und eine Runde, die ihre gesamte Arbeit in einem solchen Agenten erledigt, lässt model_info.model leer.
ConversationSearchService.AnswerQuery
Anfrage:
serving_config (nicht sensibel)
query.query_id (nicht sensibel)
query.text (sensibel)
session (nicht sensibel)
user_pseudo_id (nicht sensibel)
end_user_spec (teilweise sensibel). Nur die folgenden untergeordneten Felder sind sensibel:
answer (teilweise sensibel). Nur die folgenden untergeordneten Felder sind sensibel:
answer_text
grounding_supports
references
blob_attachments
steps.actions
answer_query_token (nicht sensibel)
EngineService.CreateEngine
Anfrage:
engine_id (nicht sensibel)
engine.name (nicht sensibel)
engine.create_time (nicht sensibel)
engine.display_name (nicht sensibel)
engine.update_time (nicht sensibel)
engine.data_store_ids (nicht sensibel)
engine.data_stores (nicht sensibel)
Antwort:
engine_id (nicht sensibel)
engine.name (nicht sensibel)
engine.create_time (nicht sensibel)
engine.display_name (nicht sensibel)
engine.update_time (nicht sensibel)
engine.data_store_ids (nicht sensibel)
engine.data_stores (nicht sensibel)
EngineService.UpdateEngine
Anfrage:
engine.name (nicht sensibel)
engine.create_time (nicht sensibel)
engine.display_name (nicht sensibel)
engine.update_time (nicht sensibel)
engine.data_store_ids (nicht sensibel)
engine.data_stores (nicht sensibel)
update_mask (nicht sensibel)
Antwort:
engine.name (nicht sensibel)
engine.create_time (nicht sensibel)
engine.display_name (nicht sensibel)
engine.update_time (nicht sensibel)
engine.data_store_ids (nicht sensibel)
engine.data_stores (nicht sensibel)
AgentService.SetIamPolicy
Anfrage:
policy.bindings.roles (nicht sensibel)
policy.bindings.members (nicht sensibel)
Antwort:
policy.bindings.roles (nicht sensibel)
policy.bindings.members (nicht sensibel)
AgentService.CreateAgent
Anfrage:
parent (nicht sensibel)
agent_id (nicht sensibel)
agent.name (nicht sensibel)
agent.display_name (sensibel)
agent.create_time (nicht sensibel)
agent.update_time (nicht sensibel)
agent.definition_case (nicht sensibel)
Antwort:
agent.name (nicht sensibel)
agent.display_name (sensibel)
agent.create_time (nicht sensibel)
agent.update_time (nicht sensibel)
agent.definition_case (nicht sensibel)
AgentService.UpdateAgent
Anfrage:
agent.name (nicht sensibel)
agent.display_name (sensibel)
agent.create_time (nicht sensibel)
agent.update_time (nicht sensibel)
agent.definition_case (nicht sensibel)
update_mask (nicht sensibel)
Antwort:
agent.name (nicht sensibel)
agent.display_name (sensibel)
agent.create_time (nicht sensibel)
agent.update_time (nicht sensibel)
agent.definition_case (nicht sensibel)
AgentService.DeleteAgent
Anfrage:
name (nicht sensibel)
Antwort:
Es werden keine Felder protokolliert
GroundedGenerationService.GenerateGroundedContent
Anfrage:
contents (sensibel)
location (nicht sensibel)
generation_spec (teilweise sensibel). Nur die folgenden untergeordneten Felder sind sensibel:
language_code
system_instruction (sensibel)
safety_settings (nicht sensibel)
user_labels (sensibel)
grounding_spec.explicit_search_queries (sensibel)
grounding_spec.grounding_sources (teilweise sensibel). Nur die folgenden untergeordneten Felder sind sensibel:
inline_source
search_source.filter
api_source.manifest.api_spec.open_api_yaml
elastic_source.search_template
elastic_source.num_hits
parallel_ai_source.custom_configs
exa_ai_source.custom_configs
Antwort:
content (sensibel)
grounding_metadata (teilweise sensibel). Nur die folgenden untergeordneten Felder sind sensibel:
support_chunks, außer source und index
google_maps_support_chunks, außer source und index
api_calls.request_payload
api_calls.response_body
api_calls.uri
grounding_score (nicht sensibel)
DataConnectorService.UpdateDataConnector
Anfrage:
data_connector.name (nicht sensibel)
data_connector.create_time (nicht sensibel)
data_connector.update_time (nicht sensibel)
data_connector.data_source (nicht sensibel)
data_connector.refresh_interval (nicht sensibel)
data_connector.bap_config (nicht sensibel)
Antwort:
data_connector.name (nicht sensibel)
data_connector.create_time (nicht sensibel)
data_connector.update_time (nicht sensibel)
data_connector.data_source (nicht sensibel)
data_connector.refresh_interval (nicht sensibel)
data_connector.bap_config (nicht sensibel)
AssistantService.AddContextFile
Anfrage:
name (nicht sensibel)
file_name (sensibel)
Antwort:
session (nicht sensibel)
file_id (nicht sensibel)
AssistantService.UploadSessionFile
Anfrage:
name (nicht sensibel)
blob.filename (sensibel)
Antwort:
file_id (nicht sensibel)
UserEventService.WriteUserEvent
Anfrage:
Alle Felder im Anfragetext (teilweise vertraulich). Nur die folgenden untergeordneten Felder sind sensibel:
user_event.user_info.time_zone
user_event.user_info.precise_location
user_event.filter
user_event.attributes
user_event.panel.documents
user_event.panels.documents
user_event.search_info.search_query
user_event.completion_info.selected_suggestion
user_event.feedback.comment
user_event.feedback.conversation_info.query
Antwort:
Es werden keine Felder protokolliert
CoscientistService.CoscientistRunCompletion
Wird einmal protokolliert, wenn ein Co-Scientist-Lauf erfolgreich abgeschlossen wurde. Im Gegensatz zu den anderen Zeilen ist dieser Eintrag nicht das Protokoll einer API-Anfrage.
log_metadata.name ist der Ressourcenname der Co-Scientist-Instanz. Eine angehaltene und fortgesetzte Instanz erzeugt einen Eintrag, der die gesamte Instanz abdeckt. Informationen zum Abfragen dieser Einträge finden Sie unter Co-Scientist-Ausführungen überwachen.
coscientist_run_info:
starter_user_principal (nicht vertraulich): Der Nutzer, der die Ausführung gestartet hat, als E-Mail-Adresse oder andere Hauptkonto-ID. Bei einem geforkten Lauf der Nutzer, der ihn geforkt hat.
start_time (nicht vertraulich): Zeitpunkt, zu dem die Instanz erstellt wurde.
duration (nicht sensibel): Zeit von start_time bis zum Abschluss der Ausführung, einschließlich der Zeit, in der die Ausführung pausiert wurde.
input_token_count (nicht sensibel): Eingabe-Tokens, die die Instanz in allen Ausführungen verwendet hat. Dies ist die Nutzung, nicht die Kosten. Gleichen Sie die Ausgaben mit Cloud Billing ab.
output_token_count (nicht sensibel): Ausgabe-Tokens, die die Instanz in allen Ausführungen verwendet hat.
Auf Audit-Logs zur Nutzung zugreifen
So greifen Sie auf alle Audit-Logs zur Nutzung von Gemini Enterprise zu und rufen sie auf:
Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.
Wählen Sie das Google Cloud -Projekt aus, für das Sie das Audit-Logging aktiviert haben.
Wenn Sie nur Gemini Enterprise-Logs anzeigen möchten, geben Sie die folgende Abfrage in das Feld des Abfrageeditors ein und klicken Sie auf Abfrage ausführen:
Sie können den Zugriff auf die Logs in Cloud Logging steuern. Eine ausführliche Anleitung zu Methoden der Zugriffssteuerung, einschließlich der Verwendung von IAM-Bedingungen für den detaillierten Zugriff, finden Sie unter Zugriffssteuerung mit IAM.
Standardzugriffssteuerung
Standardmäßig sendet Gemini Enterprise Cloud Logging-Daten an den Bucket _Default. Die folgenden IAM-Rollen steuern den Zugriff auf diesen Bucket:
Wenn Ihr Projekt Logs mit unterschiedlichen Vertraulichkeitsstufen enthält, können Sie mehrere Google Cloud - und Cloud Logging-Tools verwenden, um eine detailliertere Zugriffssteuerung zu konfigurieren.
Sie können die detaillierte Zugriffssteuerung mit den folgenden Optionen konfigurieren:
Option
Beschreibung
IAM-Bedingungen
Detaillierte Zugriffssteuerung mit IAM-Bedingungen einrichten Weitere Informationen finden Sie unter Logging-Rollen.
Logansichten
Verwenden Sie Logansichten, um den Nutzerzugriff auf eine Teilmenge von Logs in einem Log-Bucket zu beschränken. Weitere Informationen finden Sie unter Logansichten für einen Log-Bucket konfigurieren.
Logsenken
Verwenden Sie Logsenken, um vertrauliche Logs an ein separates Projekt mit restriktiverem IAM-Zugriff weiterzuleiten. Weitere Informationen finden Sie unter Logs an unterstützte Ziele weiterleiten.
Verwenden Sie die Zugriffssteuerung auf Feldebene, um den Zugriff auf bestimmte Felder in Logeinträgen auszublenden oder einzuschränken. Weitere Informationen finden Sie unter Zugriff auf Feldebene konfigurieren.