Configurar el registro de Gemini Code Assist Standard y Enterprise

En este documento se describe cómo configurar el registro estándar y Enterprise de Gemini Code Assist en un proyecto mediante la Google Cloud consola o una API.

Limitaciones

En Gemini Standard y Enterprise, el registro de datos de registro se limita a las interacciones de los usuarios con Gemini Code Assist en el IDE. Google Cloud

Además, Gemini para Google Cloud no registra datos de Gemini Code Assist Standard y Enterprise si el usuario desactiva la telemetría de VS Code.

Antes de empezar

Comprueba que tu Google Cloud proyecto esté asociado a una cuenta de facturación.

Verificar permisos de gestión de identidades y accesos

Para configurar el registro de Gemini Code Assist Standard y Enterprise, puedes conceder el rol predefinido de gestión de identidades y accesos (IAM) Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin), que incluye todos los permisos necesarios para trabajar con todos los ajustes de administrador de Gemini for Google Cloud.

También puedes actualizar cualquier rol de gestión de identidades y accesos personalizado. Debes tener permisos de gestión de identidades y accesos específicos, que se detallan en las secciones siguientes.

Configurar el registro de Gemini Code Assist

En las siguientes secciones se indican los pasos necesarios para habilitar la recogida y el almacenamiento de la actividad de Gemini Code Assist Standard y Enterprise en Cloud Logging, entre los que se incluyen los siguientes:

  • Registros de peticiones y respuestas de Gemini Code Assist Standard y Enterprise, como las entradas de los usuarios, la información contextual y las respuestas.

  • Registros de metadatos de Gemini Code Assist Standard y Enterprise, como metadatos de telemetría y líneas de código aceptadas por el usuario.

Para obtener más información sobre ambos tipos de registros, consulta Ver registros de Gemini.

Habilitar el registro de Gemini Code Assist

Selecciona una de las opciones siguientes:

Consola

  1. Comprueba que hayas habilitado la API Cloud Logging en el proyecto.

  2. Verifica que tienes los siguientes permisos de gestión de identidades y accesos en el proyecto propietario de la suscripción:

    • 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. En la Google Cloud consola, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

  4. En el menú de navegación de la izquierda, haz clic en Configuración.

    Se carga la página Configuración.

  5. (Opcional) Haz clic en Registro de metadatos de Code Assist para registrar los metadatos generados por los usuarios de Gemini Code Assist Standard y Enterprise en el proyecto.

  6. (Opcional) Haz clic en Registro de peticiones y respuestas de Code Assist para registrar las peticiones y las respuestas generadas por los usuarios de Gemini Code Assist Standard y Enterprise en el proyecto.

  7. Haz clic en Guardar cambios.

API

Para habilitar el registro de Gemini Code Assist Standard y Enterprise, usa el recurso loggingSettings para definir los ajustes de registro que quieras y el recurso loggingSettings.settingBindings para vincular los ajustes a un proyecto:

  1. Comprueba que hayas habilitado la API Cloud Logging en el proyecto.

  2. Verifica que tienes los siguientes permisos de gestión de identidades y accesos en el proyecto propietario de la suscripción:

    • 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 el ajuste y un valor específico para el ajuste:

    1. Obtén el token:

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

  4. Habilita los registros de Gemini Code Assist Standard y Enterprise. Los registros de usuario y los registros de metadatos se habilitan con los campos log_prompts_and_responses y log_metadata, respectivamente. Si no quieres habilitar uno de los campos, exclúyelo de la solicitud.

    1. Ejecuta el siguiente comando para crear el ajuste:

      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"

      Haz los cambios siguientes:

      • CONTAINER_PROJECT_NAME: introduce el ID del proyecto en el que se almacena el recurso de vinculación. Es el proyecto principal del enlace.
      • LOGS_SETTING_ID: introduce un nombre único para el ajuste, como gcalm.

      Si el comando se ejecuta correctamente, devuelve un cuerpo de respuesta que muestra los valores log_prompts_and_responses y log_metadata definidos como 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. Ejecuta el siguiente comando para crear el enlace de configuración de los registros de Gemini Code Assist Standard y 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"

    Haz los cambios siguientes:

    • TARGET_PROJECT_NAME: introduce el proyecto de destino al que se debe vincular el enlace. Suele ser el mismo que el proyecto del contenedor. Sin embargo, puedes vincular un ajuste a varios proyectos para que no se tenga que duplicar el recurso de ajuste.
    • LOGS_BINDING_ID: Usa el mismo LOGS_SETTING_ID que cuando creaste el ajuste, pero añade b1. Por ejemplo, usa gcalmb1.

    Si el comando se ejecuta correctamente, devuelve los metadatos de la operación en el siguiente 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
}

Inhabilitar el registro de Gemini Code Assist

Selecciona una de las opciones siguientes:

Consola

  1. Verifica que tienes los siguientes permisos de gestión de identidades y accesos en el proyecto propietario de la suscripción:

    • 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. En la Google Cloud consola, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

  3. En el menú de navegación de la izquierda, haz clic en Configuración.

    Se carga la página Configuración.

  4. Haga clic en Registro de metadatos de Code Assist para desactivar el registro de los metadatos del uso de Gemini Code Assist Standard y Enterprise en el proyecto.

  5. Haz clic en Guardar cambios.

API

Para inhabilitar el registro de Gemini Code Assist Standard y Enterprise, usa el método loggingSetting.

  1. Verifica que tienes los siguientes permisos de gestión de identidades y accesos en el proyecto propietario de la suscripción:

    • 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 el ajuste y un valor específico para el ajuste:

    1. Obtén el token:

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

  3. Ejecuta el siguiente comando para inhabilitar los ajustes de los registros de Gemini Code Assist Standard y 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"

    Haz los cambios siguientes:

    • CONTAINER_PROJECT_NAME: introduce el ID del proyecto principal.

    • LOGS_SETTING_ID: introduce el nombre del ajuste, como gcalm.

      Si el comando se ejecuta correctamente, devuelve un cuerpo de respuesta que muestra los valores log_prompts_and_responses y log_metadata definidos como 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
}

Siguientes pasos