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 è limitata alle interazioni degli utenti con Gemini Code Assist all'interno dell'IDE. Google Cloud

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.

(Facoltativo) Concedi autorizzazioni IAM

Per configurare la registrazione di Gemini Code Assist Standard ed Enterprise, devi disporre di autorizzazioni Identity and Access Management (IAM) specifiche, descritte in dettaglio nelle sezioni seguenti. Assicurati che queste autorizzazioni vengano aggiunte ai ruoli IAM personalizzati.

In alternativa, puoi concedere il ruolo Amministratore impostazioni Gemini in Google Cloud (roles/cloudaicompanion.settingsAdmin) predefinito IAM, che include tutte le autorizzazioni necessarie per utilizzare tutte le impostazioni di amministrazione di Gemini in Google Cloud Google Cloud.

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:

  • Log di prompt e risposte di Gemini Code Assist Standard ed Enterprise, come input 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 Identity and Access Management (IAM) nel 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 per 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 logging 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 Identity and Access Management (IAM) nel 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. Attiva 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 è lo stesso del 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 Identity and Access Management (IAM) nel 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 per 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 Identity and Access Management (IAM) nel 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