Gemini-Protokolle ansehen

In diesem Dokument wird beschrieben, wie Sie die Erhebung und Speicherung von Nutzereingaben, Kontextinformationen und Antworten aktivieren können, wenn Sie Gemini für Google Cloud verwenden. 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 an Cloud Logging Speicherplatz. Sie können diese Daten prüfen, indem Sie nach Logeinträgen mit dem Ressourcentyp cloudaicompanion.googleapis.com/Instance suchen.

Diese Funktion protokolliert keine Prompts oder Antworten in Gemini in Vertex AI. Informationen zum Aktivieren von Logs für Gemini 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 erstellen. Weitere Informationen zu erforderlichen Berechtigungen finden Sie unter Zugriffssteuerung.

Cloud Logging verschlüsselt inaktive Kundendaten standardmäßig. Von Logging in Log-Buckets gespeicherte Daten werden verschlüsselt mit Schlüsselverschlüsselungsschlüsseln, ein Verfahren, das als Umschlagverschlüsselung bezeichnet wird. 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. Um die Anforderungen Ihrer Organisation zu erfüllen, verwaltet Google die Verschlüsselungsschlüssel, die Ihre Daten schützen, können Sie Ihre Schlüssel 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

Hinweise

Gemini für Google Cloud-Logging aktivieren

Wenden Sie sich an den Google Cloud-Support oder Ihren Google Cloud-Ansprechpartner. durch die Projekt-ID, für die Sie Gemini für Google Cloud-Logging 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 aus. Cloud AI Companion-Instanz.

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 eine Liste der gefundenen Felder. im LogEntry für ein Gemini for Google Cloud Platform-Ereignis wie Nutzeranfragen und Antworten von Gemini für Google Cloud.

Nutzeranforderungen

Die folgende Tabelle enthält eine Liste der Felder in einem Logeintrag für Nutzeranfragen.

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 für 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 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 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 dieser Wert unknown.
LogEntry.labels.request_id Eine eindeutige Kennung, um eine Anfrage einem Antwortlogeintrag zuzuordnen.
LogEntry.labels.user_id Die ID 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 Chat-Prompt-Ereignis.

{
  "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-Eintrag für alle Prompts zur Codegenerierung, einschließlich Gemini for Google Cloud in einer Codedatei, Gemini for Google Cloud mit ausgewähltem Code über den Chat 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 for 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 Gemini für den Ressourcentyp von Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container Die eindeutige ID des Ressourcencontainers, in dem Gemini for Google Cloud verwendet wurde.
LogEntry.resource.labels.location Standort, an dem Gemini für 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 für Google Cloud-Produkt Gemini Code Assist ist, ist dieser Wert code_assist. Andernfalls ist dieser Wert unknown.
LogEntry.labels.request_id Eine eindeutige Kennung, um eine Anfrage einem Antwortlogeintrag zuzuordnen.
LogEntry.labels.user_id Die ID des Nutzers, der diese Anfrage initiiert hat.
LogEntry.jsonPayload Die Nutzlast des Logeintrags.
LogEntry.logName Identifiziert das Protokoll.

Nächste Schritte