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
<a name="q-admin-user-telemetry"></a>

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](user-activity-metrics.md). 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 saber mais sobre essa configuração, consulte [Optando por não compartilhar sua telemetria do lado do cliente](opt-out-IDE.md#opt-out-IDE-telemetry).

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?](subscribe-understanding-profile.md) e [Regiões compatíveis com o console do Q Developer e o perfil do Q Developer](q-admin-setup-subscribe-regions.md#qdev-console-and-profile-regions).
+ Esteja na AWS conta em que os usuários estão inscritos. Se os usuários estiverem inscritos em várias AWS contas, você deverá criar buckets em cada uma dessas contas. Cross-account buckets não são suportados.
+ (Opcional, mas recomendado) Ser diferente do bucket que você pode estar usando para [registro em log de prompts](q-admin-prompt-logging.md).
+ 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 {{bucketName}}{{region}},{{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 você estiver configurando 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingEncryption.html) 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](id-based-policy-examples-admins.md#q-admin-setup-admin-users).

1. Escolha **Configurações**.

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

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

1. 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/`