Configurare il logging di Gemini Code Assist Standard ed Enterprise

Questo documento descrive come configurare la registrazione standard ed Enterprise di Gemini Code Assist per un progetto utilizzando la console Google Cloud o un'API.

Limitazioni

La registrazione dei dati di log di Gemini Standard ed Enterprise in Google Cloud è limitata alle interazioni degli utenti con Gemini Code Assist all'interno dell'IDE.

Inoltre, Gemini in Google Cloud non registra i dati per Gemini Code Assist Standard ed Enterprise se la telemetria di VS Code è disattivata dall'utente.

Prima di iniziare

Verifica che il tuo progetto Google Cloud sia collegato a un account di fatturazione.

Verifica le autorizzazioni IAM

Per configurare la registrazione di Gemini Code Assist Standard ed Enterprise, puoi concedere il ruolo predefinito di Identity and Access Management Amministratore delle impostazioni di Gemini in Google Cloud (roles/cloudaicompanion.settingsAdmin), che include tutte le autorizzazioni richieste per utilizzare tutte le impostazioni di amministratore di Gemini in Google Cloud.

In alternativa, puoi aggiornare qualsiasi ruolo IAM personalizzato. Devi disporre di autorizzazioni IAM specifiche, descritte nelle sezioni seguenti.

Configurare la registrazione di Gemini Code Assist

Le sezioni seguenti forniscono i passaggi necessari per attivare la raccolta e l'archiviazione dell'attività di Gemini Code Assist Standard ed Enterprise in Cloud Logging, tra cui:

  • Prompt e log delle risposte di Gemini Code Assist Standard ed Enterprise, come input dell'utente, informazioni contestuali e risposte.

  • Log dei metadati di Gemini Code Assist Standard ed Enterprise, ad esempio metadati di telemetria e righe di codice accettate dall'utente.

Per maggiori dettagli su entrambi i tipi di log, vedi Visualizzare i log di Gemini.

Abilitare la registrazione per Gemini Code Assist

Seleziona una delle seguenti opzioni:

Console

  1. Verifica di aver abilitato l'API Cloud Logging nel progetto.

  2. Verifica di disporre delle seguenti autorizzazioni IAM sul progetto proprietario dell'abbonamento:

    • 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. Nella console Google Cloud, vai alla pagina Amministrazione di Gemini.

    Vai a Gemini in Google Cloud

    Viene caricata la pagina Gemini in Google Cloud.

  4. Fai clic su Impostazioni nel menu di navigazione a sinistra.

    Viene caricata la pagina Impostazioni.

  5. (Facoltativo) Fai clic su Logging per i metadati di Code Assist per registrare i metadati generati dagli utenti di Gemini Code Assist Standard ed Enterprise nel progetto.

  6. (Facoltativo) Fai clic su Logging per prompt e risposte di Code Assist per registrare i prompt e le risposte generati dagli utenti di Gemini Code Assist Standard ed Enterprise nel progetto.

  7. Fai clic su Salva modifiche.

API

Per attivare la registrazione per Gemini Code Assist Standard ed Enterprise, utilizza la risorsa loggingSettings per definire le impostazioni di registrazione che preferisci e la risorsa loggingSettings.settingBindings per associare le impostazioni a un progetto:

  1. Verifica di aver abilitato l'API Cloud Logging nel progetto.

  2. Verifica di disporre delle seguenti autorizzazioni IAM sul progetto proprietario dell'abbonamento:

    • 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. Crea l'impostazione e un valore specifico per l'impostazione:

    1. Ottieni il token:

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

  4. Abilita i log di Gemini Code Assist Standard ed Enterprise. I log utente e i log dei metadati sono abilitati con i campi log_prompts_and_responses e log_metadata, rispettivamente. Se non vuoi attivare uno dei campi, escludilo dalla richiesta.

    1. Esegui questo comando per creare l'impostazione:

      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"

      Sostituisci quanto segue:

      • CONTAINER_PROJECT_NAME: inserisci l'ID progetto del progetto in cui è archiviata la risorsa di binding. Questo è il progetto padre dell'associazione.
      • LOGS_SETTING_ID: inserisci un nome univoco per l'impostazione, ad esempio gcalm.

      Se il comando ha esito positivo, restituisce un corpo della risposta che mostra log_prompts_and_responses e log_metadata impostati su true:

      {
  "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. Esegui questo comando per creare l'associazione dell'impostazione dei log di Gemini Code Assist Standard ed Enterprise:

      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"

    Sostituisci quanto segue:

    • TARGET_PROJECT_NAME: inserisci il progetto di destinazione a cui deve essere associata l'associazione. Spesso questo corrisponde al progetto contenitore. Tuttavia, puoi associare un'impostazione a più progetti in modo che la risorsa di impostazione non debba essere duplicata.
    • LOGS_BINDING_ID: utilizza lo stesso LOGS_SETTING_ID quando hai creato l'impostazione, ma aggiungi b1. Ad esempio, usa gcalmb1.

    Se il comando ha esito positivo, restituisce i metadati dell'operazione nel seguente formato:

    {
  "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
}

Disattivare la registrazione per Gemini Code Assist

Seleziona una delle seguenti opzioni:

Console

  1. Verifica di disporre delle seguenti autorizzazioni IAM sul progetto proprietario dell'abbonamento:

    • 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. Nella console Google Cloud, vai alla pagina Amministrazione di Gemini.

    Vai a Gemini in Google Cloud

    Viene caricata la pagina Gemini in Google Cloud.

  3. Fai clic su Impostazioni nel menu di navigazione a sinistra.

    Viene caricata la pagina Impostazioni.

  4. Fai clic su Logging per i metadati di Code Assist per disattivare la registrazione dei metadati relativi all'utilizzo di Gemini Code Assist Standard ed Enterprise nel progetto.

  5. Fai clic su Salva modifiche.

API

Per disattivare la registrazione per Gemini Code Assist Standard ed Enterprise, utilizza il metodo loggingSetting.

  1. Verifica di disporre delle seguenti autorizzazioni IAM sul progetto proprietario dell'abbonamento:

    • 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. Crea l'impostazione e un valore specifico per l'impostazione:

    1. Ottieni il token:

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

  3. Esegui questo comando per disattivare le impostazioni dei log di Gemini Code Assist Standard ed Enterprise:

      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"

    Sostituisci quanto segue:

    • CONTAINER_PROJECT_NAME: inserisci l'ID progetto principale.

    • LOGS_SETTING_ID: inserisci il nome dell'impostazione esistente, ad esempio gcalm.

      Se il comando ha esito positivo, restituisce un corpo della risposta che mostra log_prompts_and_responses e log_metadata impostati su false:

      {
  "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
}

Passaggi successivi