Logging für Gemini Code Assist Standard und Enterprise konfigurieren

In diesem Dokument wird beschrieben, wie Sie das Standard- und Enterprise-Logging für Gemini Code Assist für ein Projekt mit der Google API Console oder einer API konfigurieren.

Beschränkungen

Bei Gemini Standard und Enterprise in Google Cloud ist die Aufzeichnung von Protokolldaten auf Nutzerinteraktionen mit Gemini Code Assist in der IDE beschränkt.

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

Hinweis

Ihr Google Cloud-Projekt muss mit einem Rechnungskonto verknüpft sein.

Optional: IAM-Berechtigungen gewähren

Wenn Sie die Protokollierung für Gemini Code Assist Standard und Enterprise konfigurieren möchten, benötigen Sie bestimmte Berechtigungen für die Identitäts- und Zugriffsverwaltung. Diese werden in den folgenden Abschnitten beschrieben. 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) gewähren. Diese Rolle umfasst alle erforderlichen Berechtigungen, die für die Arbeit mit allen Administratoreinstellungen von Gemini for Google Cloud erforderlich sind.

Optional: Berechtigungen an Einstellungen und Ziele binden

Wenn Sie die Administratoreinstellungen für Gemini Code Assist Standard und Enterprise in der Google API Console konfigurieren, können Sie diesen Abschnitt überspringen.

Wenn Sie die Standard- und Enterprise-Administratoreinstellungen von Gemini Code Assist mit der Gemini for Google Cloud API konfigurieren möchten, müssen Sie zuerst Einstellungen und dann Bindungen erstellen, um diese Einstellungen und Ziele (z. B. Instanz, Thema oder Projekte) für bestimmte Produkte zu „binden“ (z. B. Gemini Cloud Assist oder Gemini Code Assist).

Alle Berechtigungen zum Erstellen und Aktualisieren von Einstellungen gelten auf Projektebene.

Logging für Gemini Code Assist konfigurieren

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

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

  • Metadatenprotokolle von Gemini Code Assist Standard und Enterprise, z. B. Telemetriemetadaten und vom Nutzer akzeptierte Codezeilen.

Weitere Informationen zu beiden Protokolltypen finden Sie unter Gemini-Protokolle ansehen.

Logging für Gemini Code Assist aktivieren

Wählen Sie eine der folgenden Optionen aus:

Console

  1. Achten Sie darauf, dass die Cloud Logging API im Projekt aktiviert ist.

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

    • 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 API Console die Seite Verwaltung 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 Logging für Gemini Code Assist Standard und Enterprise aktivieren möchten, verwenden Sie die Methode loggingSetting.

  1. Achten Sie darauf, dass die Cloud Logging API im Projekt aktiviert ist.

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

    • 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. Rufe das Token ab:

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

  4. Aktivieren Sie die Metadatenprotokolle für Gemini Code Assist Standard und Enterprise.

    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_metadata": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=SETTING_ID"

      Ersetzen Sie Folgendes:

      • CONTAINER_PROJECT_NAME: Geben Sie die ID des übergeordneten Projekts ein.
      • SETTING_ID: Geben Sie einen eindeutigen Namen für die Einstellung ein, z. B. gcalm1 für Gemini Code Assist log metadata.

      Wenn der Befehl erfolgreich ausgeführt wurde, wird ein Antworttext zurückgegeben, in dem log_metadata auf true festgelegt ist:

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

    2. Führen Sie den folgenden Befehl aus, um die Bindung für Gemini Code Assist-Standard- und Enterprise-Metadatenprotokolle 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/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"

    Ersetzen Sie Folgendes:

    • TARGET_PROJECT_NAME: Geben Sie das Zielprojekt ein, auf das die Einstellung angewendet werden soll.
    • SETTING_ID: Verwenden Sie dieselbe SETTING_ID, die Sie beim Erstellen der Einstellung verwendet haben, fügen Sie aber b1 an. Verwenden Sie beispielsweise gcalmb1 anstelle von Gemini Code Assist log metadata.

    Wenn der Befehl erfolgreich ist, gibt er die Vorgangsmetadaten im folgenden Format zurück:

    {
  "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>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

  5. Aktivieren Sie Nutzerprotokolle für Gemini Code Assist Standard und Enterprise.

    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,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=SETTING_ID"

      Ersetzen Sie Folgendes:

      • CONTAINER_PROJECT_NAME: Geben Sie die ID des übergeordneten Projekts ein.
      • SETTING_ID: Geben Sie einen eindeutigen Namen für die Einstellung ein, z. B. gcapar1 für Gemini Code Assist prompts and responses.

      Wenn der Befehl erfolgreich ausgeführt wurde, wird ein Antworttext zurückgegeben, in dem log_prompts_and_responses auf true festgelegt ist:

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

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

      curl \
  -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/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"

    Ersetzen Sie Folgendes:

    • TARGET_PROJECT_NAME: Geben Sie das Zielprojekt ein, auf das die Einstellung angewendet werden soll.
    • SETTING_ID: Verwenden Sie dieselbe SETTING_ID, die Sie beim Erstellen der Einstellung verwendet haben, fügen Sie aber b1 an. Verwenden Sie beispielsweise gcaparb1 anstelle von Gemini Code Assist prompts and responses.

    Wenn der Befehl erfolgreich ist, gibt er die Vorgangsmetadaten im folgenden Format zurück:

    {
  "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>SETTING_ID</var>/settingBindings/<var>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. Sie benötigen die folgenden IAM-Berechtigungen (Identity and Access Management) für das Projekt, zu dem das Abo gehört:

    • 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 API Console die Seite Verwaltung 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 aus der Nutzung von Gemini Code Assist Standard und Enterprise im Projekt zu deaktivieren.

  5. Klicken Sie auf Änderungen speichern.

API

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

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

    • 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. Rufe das Token ab:

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

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

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

    Ersetzen Sie Folgendes:

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

    • SETTING_ID: Geben Sie den Namen der vorhandenen Einstellung ein, z. B. gcalm1 für Gemini Code Assist log metadata.

      Wenn der Befehl erfolgreich ausgeführt wurde, wird ein Antworttext zurückgegeben, in dem log_metadata auf false festgelegt ist:

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

  4. Führen Sie den folgenden Befehl aus, um die Einstellung für Gemini Code Assist-Standard- und Enterprise-Nutzerprotokolle zu deaktivieren:

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

    Ersetzen Sie Folgendes:

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

    • SETTING_ID: Geben Sie den Namen der vorhandenen Einstellung ein, z. B. gcapar1 für Gemini Code Assist prompts and responses.

      Wenn der Befehl erfolgreich ausgeführt wurde, wird ein Antworttext zurückgegeben, in dem log_prompts_and_responses auf false festgelegt ist:

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

Nächste Schritte