Consulta los registros de Gemini para Google Cloud

En este documento, se describe cómo habilitar la recopilación y el almacenamiento de la actividad en Gemini para Google Cloud , lo que incluye lo siguiente:

• Registros de Gemini para Google Cloud indicaciones y respuestas, como entradas del usuario, información contextual y respuestas
• Gemini para los registros de metadatos de Google Cloud , como los metadatos de telemetría y las líneas de código aceptadas por el usuario.

Si necesitas generar métricas de Gemini Code Assist, consulta Supervisa el uso de Gemini para Google Cloud .

Gemini para Google Cloud no recopila ni envía a Cloud Logging ninguna otra interacción que el usuario pueda haber tenido con Gemini para Google Cloud, incluidos los comentarios escritos. Los datos recopilados se envían a Cloud Logging para su almacenamiento. Puedes revisar estos datos buscando entradas de registro con el tipo de recurso cloudaicompanion.googleapis.com/Instance.

Esta función no registra las instrucciones ni las respuestas en Gemini en Vertex AI. Para habilitar los registros de Gemini en Vertex AI, consulta Habilita los registros de auditoría de acceso a los datos.

Los roles de Identity and Access Management (IAM) controlan la capacidad de una principal para acceder a los registros. Puedes otorgar roles predefinidos a las entidades principales o crear roles personalizados. Para obtener más información sobre los permisos obligatorios, consulta Control de acceso.

De forma predeterminada, Cloud Logging encripta el contenido del cliente almacenado en reposo. Los datos que Logging almacena en los buckets de registros se encriptan con claves de encriptación de claves, un proceso conocido como encriptación de sobre. Acceder a tus datos de registro requiere acceso a esas claves de encriptación de claves, que Google administra sin que tengas que realizar ninguna acción.

Tu organización puede tener requisitos de encriptación avanzados, regulatorios o relacionados con el cumplimiento que nuestra encriptación en reposo predeterminada no proporciona. Para cumplir con los requisitos de tu organización, en lugar de que Google administre las claves de encriptación que protegen tus datos, puedes administrar tus claves.

Para obtener información específica sobre el uso de las claves de encriptación administradas por el cliente (CMEK), incluidas las ventajas y limitaciones, consulta Claves de encriptación administradas por el cliente.

Limitaciones

La grabación de datos de registro de Gemini en Google Cloud se limita a las interacciones del usuario con Gemini Code Assist dentro del IDE.

Además, si el usuario final desactiva el parámetro de configuración de telemetría de VS Code, Gemini para Google Cloud no registrará metadatos. Sin embargo, los registros de instrucciones y respuestas se siguen generando cuando los administradores habilitan el registro de instrucciones y respuestas.

Antes de comenzar

• Para obtener los permisos que necesitas para ver los registros de Gemini para Google Cloud , pídele a tu administrador que te otorgue el rol de IAM Visualizador de registros (roles/logging.viewer) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

  También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

• Revisa los precios de Cloud Logging y los precios de Gemini para Google Cloud antes de habilitar Gemini para el registro de Google Cloud .

• Habilita el registro de Gemini para Google Cloud .

Consulta los registros de usuarios y los registros de metadatos de Gemini para Google Cloud

Para ver los registros de usuarios y los registros de metadatos de Gemini, haz una de las siguientes acciones: Google Cloud

gcloud logging read "resource.type=cloudaicompanion.googleapis.com/Instance" --project PROJECT_ID  --limit 3

Gemini para registros de Google Cloud

Un LogEntry es la unidad básica de datos en Cloud Logging. En las siguientes secciones, se proporcionan listas de los campos que se encuentran en LogEntry para un evento de la plataforma de Gemini para Google Cloud , como solicitudes del usuario y respuestas de Gemini para Google Cloud .

Solicitudes del usuario

En la siguiente tabla, se muestra una lista de los campos que se encuentran en una entrada de registro de solicitud del usuario.

En el siguiente ejemplo, se muestra una entrada de registro de ejemplo para un evento de instrucción de chat.

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "my-user@example.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "taskCompletionRequest":
      input: {
        messages: [{
          author: "USER"
          content: "What are some best practices to save cost on my Google Cloud bill?"
        }]
        preamble: ""
      }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

En el siguiente ejemplo, se muestra una entrada de RequestLog para las indicaciones de sugerencia de código intercalado automáticas y pedirle a Gemini que Google Cloud en un archivo de código.

Los datos de la instrucción para las sugerencias de código intercalado usan el objeto codeCompletionRequest (como se muestra en el siguiente ejemplo), mientras que la generación activada manualmente usa codeGenerationRequest.

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "my-user@example.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "codeCompletionRequest": {
      "input_data_context": {
        "additional_context": {
          "files": [
            {
              "language": "go",
              "path": "{/path/to/../current-file.go",
              "segments": [
                {
                  "content": "...Prefix Text..."
                },
                {
                  "content": "...Suffix Text..."
                }
              ],
              "state": ["EDITED"]
            },
            {
              "language": "go",
              "path": "/path/to/../recent-file.go",
              "segments": [
                {
                  "content": "...File Text..."
                }
              ],
              "state": ["RECENTLY_OPENED"]
            }
          ]
        }
      }
    }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

Respuestas de Gemini para Google Cloud

En la siguiente tabla, se muestran los campos de respuesta y las descripciones de Gemini para Google Cloud .

Registros de metadatos de Gemini para Google Cloud

Para que se generen los registros de metadatos, se debe habilitar el parámetro de configuración de telemetría de la extensión de Gemini Code Assist para las extensiones de VS Code y de IntelliJ. Además, para VS Code, también se debe habilitar el parámetro de configuración de recopilación de telemetría global.

Los registros de metadatos de Gemini para Google Cloud siguen la misma estructura que los registros de Gemini para Google Cloud , pero especifican campos diferentes. En la siguiente tabla, se muestra una lista de los campos que se encuentran en una entrada de registro de solicitud del usuario:

En el siguiente ejemplo, se muestra una entrada de registro de codeExposure:

{
  insertId: "whfrqgc1gj"
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog"
    clientName: "CloudCodeVscode"
    clientVersion: "1.93.1"
    codeExposure: {
      originalRequestId: "cac019824a0b25ba"
      programmingLanguage: "python"
    }
  requestId: "0c5178fe-446f-4ab6-b996-520dec100cf8"
  }
  labels: {
    method: "Export.Metrics"
    product: "code_assist"
    user_id: "user@company.com"
  }
  logName: "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata"
  receiveTimestamp: "2025-02-03T23:34:35.662837985Z"
  resource: {
    labels: {
      instance_id: "default"
      location: "global"
      resource_container: "my-project-id"
    }
  type: "cloudaicompanion.googleapis.com/Instance"
  }
  severity: "INFO"
  timestamp: "2025-02-03T23:34:35.021564463Z"
}

En el siguiente ejemplo, se muestra una entrada de registro de codeAcceptance:

{
  insertId: "whfrqgc1gk"
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog"
    clientName: "CloudCodeVscode"
    clientVersion: "1.93.1"
    codeAcceptance: {
      linesCount: 2
      originalRequestId: "cac019824a0b25ba"
      programmingLanguage: "python"
    }
    requestId: "ddf11040-c315-452e-b7cd-928c3f97984e"
  }
  labels: {
    method: "Export.Metrics"
    product: "code_assist"
    user_id: "user@company.com"
  }
  logName: "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata"
  receiveTimestamp: "2025-02-03T23:34:37.632662272Z"
  resource: {
    labels: {
      instance_id: "default"
      location: "global"
      resource_container: "my-project-id"
    }
    type: "cloudaicompanion.googleapis.com/Instance"
  }
  severity: "INFO"
  timestamp: "2025-02-03T23:34:36.778692483Z"
} 

En el siguiente ejemplo, se muestra una entrada de registro de chatExposure:

{
  insertId: "3diaj2c208"
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog"
    clientName: "CloudCodeVscode"
    clientVersion: "1.93.1"
    chatExposure: {
      originalRequestId: "cac019824a0b25ba"
    }
  requestId: "0c5178fe-446f-4ab6-b996-520dec100cf8"
  }
  labels: {
    method: "Export.Metrics"
    product: "code_assist"
    user_id: "user@company.com"
  }
  logName: "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata"
  receiveTimestamp: "2025-02-03T23:34:35.662837985Z"
  resource: {
    labels: {
      instance_id: "default"
      location: "global"
      resource_container: "my-project-id"
    }
  type: "cloudaicompanion.googleapis.com/Instance"
  }
  severity: "INFO"
  timestamp: "2025-02-03T23:34:35.021564463Z"
}

Cómo calcular el porcentaje de aceptación del código

Para calcular la tasa de aceptación con los registros de metadatos de Gemini Code Assist, busca la cantidad total de IDs únicos de los eventos con codeAcceptance.originalRequestId y divídela por la cantidad total de IDs únicos de los eventos con codeExposure.originalRequestId. Puedes refinar aún más este cálculo por lenguaje de programación y por usuario con los campos de eventos de registro de metadatos respectivos.

Cómo calcular las líneas de código aceptadas

Para calcular las líneas de código aceptadas, busca el valor máximo de codeAcceptance.linesCount para un codeAcceptance.originalRequestId único. Luego, agrega el valor de linesCount para todos los eventos codeAcceptance finales de cada originalRequestId para calcular la cantidad total de líneas de código aceptadas. Puedes refinar aún más este cálculo por lenguaje de programación y por usuario con los campos de eventos de registro de metadatos respectivos.

¿Qué sigue?

• Obtén información para ver, analizar y supervisar tus registros en Google Cloud.
• Obtén más información para supervisar el uso de Gemini para Google Cloud.