Habilitar los informes de actividad de los usuarios en Amazon Q Developer

Puede configurar Amazon Q para recopilar la telemetría de la actividad de los usuarios de los suscriptores de Amazon Q Developer de su organización y presentar esa información en un informe. El informe te proporciona información sobre el uso de Amazon Q en tu base de usuarios.

Amazon Q genera el informe todos los días a medianoche y lo guarda en un archivo CSV en la siguiente ruta:

s3://bucketName/prefix/month/day/timestamp-report.csv

El archivo CSV se presenta de la siguiente manera:

• Cada fila muestra un usuario que interactuó con Amazon Q ese día.

• Cada columna muestra una métrica, tal y como se describe enMétricas del informe de actividad de los usuarios. Las métricas se calculan en función de la telemetría del usuario recopilada a lo largo del día.

Si el archivo CSV supera 1 MB, Amazon Q divide los datos en varios archivos CSV del día.

nota

Al habilitar los informes de actividad de los usuarios, Amazon Q recopila la telemetría independientemente de cómo haya configurado el desarrollador la AWS configuración Habilitar Amazon Q para enviar datos de uso en su IDE. Esta configuración controla si la telemetría puede ser utilizada por la AWS empresa, no por su organización. Para obtener más información sobre esta configuración, consulte Desactivación del envío de la telemetría del cliente.

Utilice las siguientes instrucciones para habilitar los informes de actividad de los usuarios.

Requisito previo

Cree un bucket de Amazon S3 para almacenar el archivo CSV del informe de actividad del usuario. El bucket debe:

• estar en la región Este de EE. UU. (Norte de Virginia), independientemente de la ubicación de su IAM Identity Center.

• Esté en la AWS cuenta a la que están suscritos los usuarios. Si los usuarios están suscritos en varias AWS cuentas, debes crear grupos en cada una de esas cuentas. No se admiten los depósitos entre cuentas.

• (Opcional pero recomendado) Debe ser diferente del depósito que podría estar utilizando para el registro rápido.

• Incluye un prefijo, también conocido como subcarpeta, donde Amazon Q guardará el archivo CSV. El archivo CSV no se puede guardar en la raíz del depósito.

• Tenga una política de buckets como la que se indica a continuación. Sustituya bucketName regionaccountId,, y prefix por su propia información.

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Sid": "QDeveloperLogsWrite",
              "Effect": "Allow",
              "Principal": {
                  "Service": "q.amazonaws.com"
              },
              "Action": [
                  "s3:PutObject"
              ],
              "Resource": [
                  "arn:aws:s3:::bucketName/prefix/*"
              ],
              "Condition": {
                  "StringEquals": {
                      "aws:SourceAccount": "accountId"
                  },
                  "ArnLike": {
                      "aws:SourceArn": "arn:aws:codewhisperer:region:accountId:*"
                  } 
              }
          }
      ]
  }

  Si va a configurar SSE-KMS en el bucket, agregue la siguiente política a la clave de KMS:

  {
      "Effect": "Allow",
      "Principal": {
          "Service": "q.amazonaws.com"
      },
      "Action": "kms:GenerateDataKey",
      "Resource": "*",
      "Condition": {
          "StringEquals": {
            "aws:SourceAccount": "accountId" 
          },
          "ArnLike": {
             "aws:SourceArn": "arn:aws:codewhisperer:region:accountId:*"
          }
      }
  }                

  Para obtener información sobre cómo proteger los datos de su bucket de Amazon S3, consulte Protección de los datos mediante el cifrado en la Guía del usuario de Amazon Simple Storage Service.

Para habilitar los informes de actividad de los usuarios

1. Abra la consola de Amazon Q Developer.

   Para utilizar la consola Amazon Q Developer, debe tener los permisos definidos enPermitir a los administradores utilizar la consola Amazon Q Developer.

2. Elija Configuración.

3. En los informes de actividad de los usuarios de Q Developer, selecciona Editar.

4. Selecciona Recopilar métricas granulares por usuario.

5. En la ubicación de S3, introduzca el URI de Amazon S3 que utilizará para almacenar los informes CSV. Ejemplo: s3://amzn-s3-demo-bucket/user-activity-reports/