Logging für Gemini Code Assist Standard und Enterprise konfigurieren

In diesem Dokument wird beschrieben, wie Sie die Protokollierung für Gemini Code Assist Standard und Enterprise für ein Projekt über die Google Cloud Konsole oder eine API konfigurieren.

Beschränkungen

Die Aufzeichnung von Google Cloud Protokolldaten für Gemini Standard und Enterprise ist auf Nutzerinteraktionen mit Gemini Code Assist in der IDE beschränkt.

Außerdem werden in Gemini für Google Cloud keine Daten für Gemini Code Assist Standard und Enterprise protokolliert, wenn die VS Code-Telemetrie vom Nutzer deaktiviert wurde.

Hinweise

Prüfen Sie, ob Ihr Google Cloud -Projekt mit einem Rechnungskonto verknüpft ist.

Optional: IAM-Berechtigungen gewähren

Zum Konfigurieren der Protokollierung für Gemini Code Assist Standard und Enterprise benötigen Sie bestimmte IAM-Berechtigungen (Identity and Access Management), die in den folgenden Abschnitten beschrieben werden. Achten Sie darauf, dass diese Berechtigungen benutzerdefinierten IAM-Rollen hinzugefügt werden.

Alternativ können Sie die vordefinierte IAM-Rolle Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin) zuweisen, die alle erforderlichen Berechtigungen für die Arbeit mit allen Administratoreinstellungen für Gemini for Google Cloudenthält.

Gemini Code Assist-Logging konfigurieren

In den folgenden Abschnitten finden Sie die erforderlichen Schritte, um die Erfassung und Speicherung von Gemini Code Assist Standard- und Enterprise-Aktivitäten in Cloud Logging zu aktivieren. Dazu gehören:

  • Gemini Code Assist Standard- und Enterprise-Prompts und ‑Antwortprotokolle, z. B. Nutzereingaben, Kontextinformationen und Antworten.

  • Metadatenlogs für Gemini Code Assist Standard und Enterprise, z. B. Telemetriedaten und vom Nutzer akzeptierte Codezeilen.

Weitere Informationen zu beiden Logtypen finden Sie unter Gemini-Logs ansehen.

Logging für Gemini Code Assist aktivieren

Wählen Sie eine der folgenden Optionen aus:

Console

  1. Prüfen Sie, ob Sie die Cloud Logging API im Projekt aktiviert haben.

  2. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen (Identity and Access Management) für das Projekt haben, zu dem das Abo gehört:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. Rufen Sie in der Google Cloud Console die Seite Admin für Gemini auf.

    Zu Gemini für Google Cloud

    Die Seite Gemini for Google Cloud wird geladen.

  4. Klicken Sie im linken Navigationsmenü auf Einstellungen.

    Die Seite Einstellungen wird geladen.

  5. Optional: Klicken Sie auf Logging für Code Assist-Metadaten, um die Metadaten aufzuzeichnen, die von Nutzern von Gemini Code Assist Standard und Enterprise im Projekt generiert wurden.

  6. Optional: Klicken Sie auf Logging für Code Assist-Prompts und ‑Antworten, um die Prompts und Antworten aufzuzeichnen, die von Nutzern von Gemini Code Assist Standard und Enterprise im Projekt generiert wurden.

  7. Klicken Sie auf Änderungen speichern.

API

Wenn Sie das Logging für Gemini Code Assist Standard und Enterprise aktivieren möchten, verwenden Sie die loggingSettings-Ressource, um die gewünschten Logging-Einstellungen zu definieren, und die loggingSettings.settingBindings-Ressource, um die Einstellungen an ein Projekt zu binden:

  1. Prüfen Sie, ob Sie die Cloud Logging API im Projekt aktiviert haben.

  2. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen (Identity and Access Management) für das Projekt haben, zu dem das Abo gehört:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. Erstellen Sie die Einstellung und einen einstellungsspezifischen Wert:

    1. Token abrufen:

      TOKEN=$(gcloud auth print-access-token)

  4. Aktivieren Sie Logs für Gemini Code Assist Standard und Enterprise. Nutzer- und Metadatenlogs werden mit den Feldern log_prompts_and_responses bzw. log_metadata aktiviert. Wenn Sie eines der Felder nicht aktivieren möchten, schließen Sie es aus der Anfrage aus.

    1. Führen Sie den folgenden Befehl aus, um die Einstellung zu erstellen:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "log_prompts_and_responses": true,
    "log_metadata": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=LOGS_SETTING_ID"

      Ersetzen Sie Folgendes:

      • CONTAINER_PROJECT_NAME: Geben Sie die Projekt-ID des Projekts ein, in dem die Bindungsressource gespeichert ist. Dies ist das übergeordnete Projekt der Bindung.
      • LOGS_SETTING_ID: Geben Sie einen eindeutigen Namen für die Einstellung ein, z. B. gcalm.

      Wenn der Befehl erfolgreich ausgeführt wurde, wird ein Antworttext zurückgegeben, in dem log_prompts_and_responses und log_metadata auf true gesetzt sind:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": true,
  "log_metadata": true
}

    2. Führen Sie den folgenden Befehl aus, um die Bindung für die Einstellung für Gemini Code Assist Standard- und Enterprise-Protokolle zu erstellen:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "projects/TARGET_PROJECT_NAME"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID/settingBindings?setting_binding_id=LOGS_BINDING_ID"

    Ersetzen Sie Folgendes:

    • TARGET_PROJECT_NAME: Geben Sie das Zielprojekt ein, an das die Bindung gebunden werden soll. Das ist oft dasselbe wie das Containerprojekt. Sie können eine Einstellung jedoch an mehrere Projekte binden, sodass die Einstellungsressource nicht dupliziert werden muss.
    • LOGS_BINDING_ID: Verwenden Sie dieselbe LOGS_SETTING_ID, die Sie beim Erstellen der Einstellung verwendet haben, hängen Sie aber b1 an. Verwenden Sie zum Beispiel gcalmb1.

    Wenn der Befehl erfolgreich ist, werden die Vorgangsmetadaten im folgenden Format zurückgegeben:

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/loggingSettings/<var>LOGS_SETTING_ID</var>/settingBindings/<var>LOGS_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Logging für Gemini Code Assist deaktivieren

Wählen Sie eine der folgenden Optionen aus:

Console

  1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen (Identity and Access Management) für das Projekt haben, zu dem das Abo gehört:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.delete
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsDelete
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  2. Rufen Sie in der Google Cloud Console die Seite Admin für Gemini auf.

    Zu Gemini für Google Cloud

    Die Seite Gemini for Google Cloud wird geladen.

  3. Klicken Sie im linken Navigationsmenü auf Einstellungen.

    Die Seite Einstellungen wird geladen.

  4. Klicken Sie auf Logging für Code Assist-Metadaten, um die Aufzeichnung der Metadaten der Nutzung von Gemini Code Assist Standard und Enterprise im Projekt zu deaktivieren.

  5. Klicken Sie auf Änderungen speichern.

API

Wenn Sie das Logging für Gemini Code Assist Standard und Enterprise deaktivieren möchten, verwenden Sie die Methode loggingSetting.

  1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen (Identity and Access Management) für das Projekt haben, zu dem das Abo gehört:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • serviceusage.services.enable

  2. Erstellen Sie die Einstellung und einen einstellungsspezifischen Wert:

    1. Token abrufen:

      TOKEN=$(gcloud auth print-access-token)

  3. Führen Sie den folgenden Befehl aus, um die Einstellungen für die Protokolle von Gemini Code Assist Standard und Enterprise zu deaktivieren:

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "log_prompts_and_responses": false,
      "log_metadata": false,
      } ' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_metadata_id=LOGS_SETTING_ID"

    Ersetzen Sie Folgendes:

    • CONTAINER_PROJECT_NAME: Geben Sie die ID des übergeordneten Projekts ein.

    • LOGS_SETTING_ID: Geben Sie den Namen der vorhandenen Einstellung ein, z. B. gcalm.

      Wenn der Befehl erfolgreich ausgeführt wurde, wird ein Antworttext zurückgegeben, in dem log_prompts_and_responses und log_metadata auf false gesetzt sind:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": false,
  "log_metadata": false
}

Nächste Schritte