Gemini-Protokolle ansehen

In diesem Dokument wird beschrieben, wie Sie die Erfassung und Speicherung von Eingaben, Kontextinformationen und Antworten, wenn Sie Gemini für Google Cloud Gemini für Google Cloud erhebt keine Daten und sendet sie auch nicht an Cloud Logging alle anderen Interaktionen der Nutzer mit Gemini für Google Cloud, darunter schriftliches Feedback. Die erfassten Daten werden zum Speichern an Cloud Logging gesendet. Sie können diese Daten prüfen, indem Sie nach Logeinträgen mit dem Ressourcentyp cloudaicompanion.googleapis.com/Instance suchen.

Mit dieser Funktion werden keine Prompts oder Antworten in Gemini in Vertex AI protokolliert. Protokolle für Gemini aktivieren in Vertex AI finden Sie unter Audit-Logs zum Datenzugriff aktivieren

Mit IAM-Rollen (Identity and Access Management, Identitäts- und Zugriffsverwaltung) wird festgelegt, ob ein Hauptkonto auf Protokolle zugreifen kann. Sie können Hauptkonten vordefinierte Rollen zuweisen oder benutzerdefinierte Rollen Rollen. Weitere Informationen zu erforderlichen Berechtigungen finden Sie unter Zugriffssteuerung.

Cloud Logging verschlüsselt inaktive Kundendaten standardmäßig. Von Logging in Protokoll-Buckets gespeicherte Daten werden mit Schlüsselverschlüsselungsschlüsseln verschlüsselt. Dieser Vorgang wird als Umschlagverschlüsselung bezeichnet. Der Zugriff auf Ihre Logging-Daten erfordert den Zugriff auf diese Schlüsselverschlüsselungsschlüssel, die Google für Sie verwaltet, ohne dass Sie etwas tun müssen.

Ihre Organisation kann regulatorische, Compliance- oder erweiterte Verschlüsselungsanforderungen haben, die unsere Standardverschlüsselung inaktiver Daten nicht anspricht. Anstatt die Schlüsselverschlüsselungsschlüssel, die Ihre Daten schützen, von Google verwalten zu lassen, können Sie Ihre Schlüssel selbst verwalten.

Spezifische Informationen zur Verwendung von vom Kunden verwalteten Verschlüsselungsschlüsseln (CMEK) einschließlich der Vorteile und Einschränkungen, siehe Vom Kunden verwaltete Verschlüsselungsschlüssel.

Beschränkungen

Die von Gemini in Google Cloud erfassten Logdaten werden nicht Nutzerinteraktionen mit den folgenden Produkten enthalten:
  • Gemini in BigQuery
  • Gemini in Looker
  • Gemini in Google Security Operations
  • Gemini-Bereich in der Google Cloud Console für Database Center

Hinweis

Gemini für Google Cloud-Protokolle aktivieren

Wenden Sie sich an den Google Cloud-Support oder an Ihren Google Cloud-Ansprechpartner und geben Sie die Projekt-ID an, für die Sie Gemini für die Google Cloud-Protokollierung aktivieren möchten.

Gemini for Google Cloud-Protokolle ansehen

Führen Sie einen der folgenden Schritte aus, um Gemini für Google Cloud-Logs aufzurufen:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie in der Symbolleiste ein Google Cloud Console-Projekt aus.
  3. Maximieren Sie in der Symbolleiste das Menü Alle Ressourcen und wählen Sie die Ressource Cloud AI Companion-Instanz aus.

Google Cloud CLI

Führen Sie dazu diesen Befehl aus:

gcloud logging read "resource.type=cloudaicompanion.googleapis.com/Instance" --project PROJECT_ID  --limit 3

Beispiel für Logeinträge

Ein LogEntry ist die Grundeinheit einer Daten in Cloud Logging. In den folgenden Abschnitten finden Sie Listen der Felder in LogEntry für ein Gemini for Google Cloud-Plattformereignis, z. B. Nutzeranfragen und Gemini for Google Cloud-Antworten.

Nutzeranforderungen

Die folgende Tabelle zeigt eine Liste der Felder in einem Nutzeranfrage-Logeintrag.

Feld Werte und Hinweise
LogEntry.resource.type Gemini für den Ressourcentyp von Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container Eindeutige ID des Ressourcencontainers, in dem Gemini für Google Cloud verwendet wurde.
LogEntry.resource.labels.location Standort, an dem Gemini for Google Cloud verwendet wurde.
LogEntry.resource.labels.instance_id Eindeutige ID der Ressource, in der Gemini für Google Cloud verwendet wurde.
LogEntry.labels.method Kann eine der folgenden Optionen sein, je nachdem, was logEntry aufgerufen hat:

CompleteTask: z. B. eine Chatanfrage von Gemini Code Assist oder einem anderen Gemini für Google Cloud-Dienst.

GenerateCode: z. B. eine Anfrage zum Generieren von Code, z. B. mit einer Codetransformationsanfrage in Gemini Code Assist.

CompleteCode: z. B. eine Anfrage zum Vervollständigen von Code bei der Arbeit in der IDE, z. B. mit Inline-Vorschlägen in Gemini Code Assist.
LogEntry.labels.product Gemini für Google Cloud-Dienstname. Wenn das Gemini für Google Cloud-Produkt Gemini Code Assist ist, ist dieser Wert code_assist. Andernfalls ist der Wert unknown.
LogEntry.labels.request_id Eine eindeutige Kennung, um eine Anfrage mit einem Antwortprotokolleintrag zu korrelieren.
LogEntry.labels.user_id Die Kennung des Nutzers, der diese Anfrage initiiert hat.
LogEntry.jsonPayload Die Nutzlast des Logeintrags.
LogEntry.logName Identifiziert das Protokoll.

Das folgende Beispiel zeigt einen Beispiel-Logeintrag für ein Ereignis einer Chat-Eingabeaufforderung.

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "my-user@example.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "taskCompletionRequest":
      input: {
        messages: [{
          author: "USER"
          content: "What are some best practices to save cost on my Google Cloud bill?"
        }]
        preamble: ""
      }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

Das folgende Beispiel zeigt einen RequestLog-Beispieleintrag für einen beliebigen Code. Generierung von Prompts, Gemini für Google Cloud in einer Codedatei auffordern, Gemini für Google Cloud mit ausgewähltem Code per Chat auffordern, und Inline-Codevorschlag:

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "my-user@example.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "codeGenerationRequest":
      input: {
        prompt: "Generate some great Python for me."
      }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

Antworten von Gemini für Google Cloud

In der folgenden Tabelle sind die Antwortfelder und Beschreibungen von Gemini für Google Cloud aufgeführt.

Feld Werte und Hinweise
LogEntry.resource.type Ressourcentyp von Gemini für Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container Die eindeutige ID des Ressourcencontainers, in dem Gemini für Google Cloud verwendet wurde.
LogEntry.resource.labels.location Standort, an dem Gemini for Google Cloud verwendet wurde.
LogEntry.resource.labels.instance_id Die eindeutige ID der Ressource, in der Gemini for Google Cloud verwendet wurde.
LogEntry.labels.method Dabei kann es sich um folgende Anfragen handeln, je nachdem, was aufgerufen wurde: logEntry:

CompleteTask, z. B. eine Chatanfrage von Gemini Code Assist oder einem anderen Gemini für Google Cloud-Dienst.

GenerateCode z. B. eine Anfrage zum Generieren von Code, z. B. über eine Anfrage zur Codetransformation in Gemini Code Assist.

CompleteCode: z. B. eine Anfrage zum Vervollständigen von Code bei der Arbeit in der IDE, z. B. mit Inline-Vorschlägen in Gemini Code Assist.
LogEntry.labels.product Name des Gemini for Google Cloud-Dienstes. Wenn das Gemini for Google Cloud-Produkt Gemini Code Assist ist, ist dieser Wert code_assist. Andernfalls ist der Wert unknown.
LogEntry.labels.request_id Eine eindeutige Kennung, um eine Anfrage mit einem Antwortprotokolleintrag zu korrelieren.
LogEntry.labels.user_id Die Kennung des Nutzers, der diese Anfrage initiiert hat.
LogEntry.jsonPayload Die Nutzlast des Logeintrags.
LogEntry.logName Identifiziert das Protokoll.

Nächste Schritte