Visualizar a atividade de usuários específicos no Amazon Q Developer - Amazon Q Developer

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Visualizar a atividade de usuários específicos no Amazon Q Developer

Você pode configurar o Amazon Q para coletar a telemetria de atividade do usuário de assinantes individuais do Amazon Q Developer em sua organização e apresentar essas informações em um relatório. O relatório fornece informações sobre como usuários específicos estão usando o Amazon Q.

O Amazon Q gera o relatório todos os dias à meia-noite (00:00) do Tempo Universal Coordenado (UTC) e o salva em um arquivo CSV no seguinte caminho:

s3://bucketName/prefix/AWSLogs/accountId/QDeveloperLogs/by_user_analytic/region/year/month/day/00/accountId_by_user_analytic_timestamp.csv

O arquivo CSV é disposto da seguinte forma:

  • Cada linha mostra um usuário que interagiu com o Amazon Q naquele dia.

  • Cada coluna mostra uma métrica, conforme descrito em Métricas do relatório de atividade do usuário. As métricas são calculadas com base na telemetria do usuário coletada ao longo do dia.

Se mais de mil usuários interagirem com o Amazon Q durante o dia, o Amazon Q dividirá os dados em vários arquivos CSV contendo mil usuários cada, com sufixos part_1, part_2 e assim por diante.

nota

Ao habilitar os relatórios de atividade do usuário, o Amazon Q coleta a telemetria, independentemente de como o desenvolvedor definiu a configuração Permitir que o Amazon Q envie dados de uso à AWS no IDE. Essa configuração controla se a telemetria pode ser usada pela corporação AWS , não pela sua organização. Para obter mais informações sobre essa configuração, consulte Optando por não compartilhar sua telemetria do lado do cliente.

Use as instruções a seguir para habilitar os relatórios de atividade do usuário.

Pré-requisito

Crie um bucket do Amazon S3 para armazenar o arquivo CSV do relatório de atividade do usuário. O bucket deve:

  • Esteja na AWS região em que o perfil Amazon Q Developer foi instalado. O perfil foi instalado quando você atribuiu usuários da força de trabalho do Centro de Identidade do IAM ao Amazon Q Developer Pro pela primeira vez. Para obter mais informações sobre esse perfil e suas regiões compatíveis, consulte O que é o perfil do Amazon Q Developer? e Regiões compatíveis com o console do Q Developer e o perfil do Q Developer.

  • Esteja na AWS conta em que os usuários estão inscritos. Se os usuários estiverem inscritos em várias contas da AWS , será preciso criar buckets em cada uma dessas contas. Não há suporte para buckets entre contas.

  • (Opcional, mas recomendado) Ser diferente do bucket que você pode estar usando para registro em log de prompts.

  • Incluir um prefixo, também conhecido como subpasta, onde o Amazon Q salvará o arquivo CSV. O arquivo CSV não pode ser salvo na raiz do bucket.

  • Tenha uma política de bucket como a que segue. Substitua bucketNameregion,accountId,, e prefix por suas próprias informações.

    JSON
    {
    "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": "111122223333"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:codewhisperer:us-east-1:111122223333:*"
                }
            }
        }
    ]
}

    Se estiver configurando o SSE-KMS no bucket, adicione a política abaixo na chave 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 saber mais sobre como proteger os dados em seu bucket do Amazon S3, consulte Proteger dados com criptografia no Guia do usuário do Amazon Simple Storage Service.

Como habilitar relatórios de atividade do usuário

  1. Abra o console do Amazon Q Developer.

    Para usar o console do Amazon Q Developer Pro, você deve ter as permissões definidas em Permitir que administradores usem o console do Amazon Q Developer.

  2. Escolha Settings.

  3. Em Relatórios de atividade do usuário do Q Developer, escolha Editar.

  4. Habilite a opção Coletar métricas granulares por usuário.

  5. Em Local do S3, insira o URI do Amazon S3 que você usará para armazenar os relatórios CSV. Exemplo: s3://amzn-s3-demo-bucket/user-activity-reports/