本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon Q 开发者版中查看特定用户的活动
<a name="q-admin-user-telemetry"></a>

您可以将 Amazon Q 配置为收集组织中各个 Amazon Q 开发者版订阅用户的用户活动遥测数据，并在报告中提供该信息。该报告可让您深入了解特定用户如何使用 Amazon Q。

Amazon Q 在协调世界时（UTC）每天午夜（00:00）生成报告，并将其保存在 CSV 文件中，路径如下：

`s3://{{bucketName}}/{{prefix}}/AWSLogs/{{accountId}}/QDeveloperLogs/by_user_analytic/{{region}}/{{year}}/{{month}}/{{day}}/00/{{accountId}}_by_user_analytic_{{timestamp}}.csv`

该 CSV 文件的布局如下：
+ 每行显示当天与 Amazon Q 互动的一位用户。
+ 每列显示一个指标，如[用户活动报告指标](user-activity-metrics.md)中所述。指标是根据一天中收集的用户遥测数据计算的。

如果当天有超过 1000 名用户与 Amazon Q 互动，Amazon Q 会将数据拆分到若干 CSV 文件中，每个文件包含 1000 个用户，后缀为 `part_1`、`part_2` 等。

**注意**  
当您启用用户活动报告时，无论开发者在其 IDE 中如何设定**启用 Amazon Q 以向 AWS发送使用情况数据**设置，Amazon Q 都会收集遥测数据。该设置控制着 *AWS 公司*而不是您的组织是否可以使用遥测数据。有关该设置的更多信息，请参阅 [选择不共享您的客户端遥测数据](opt-out-IDE.md#opt-out-IDE-telemetry)。

按照以下说明操作来启用用户活动报告。

**先决条件**

创建一个 Amazon S3 存储桶来存放用户活动报告 CSV 文件。该存储桶必须满足以下要求：
+ 请位于安装了 Amazon Q 开发者配置文件的地 AWS 区。此配置文件是在您首次为 IAM Identity Center 员工用户订阅 Amazon Q 开发者版专业套餐时安装的。有关此配置文件及支持它的区域的更多信息，请参阅[什么是 Amazon Q 开发者版配置文件？](subscribe-understanding-profile.md)和 [Q 开发者版控制台与 Q 开发者版配置文件支持的区域](q-admin-setup-subscribe-regions.md#qdev-console-and-profile-regions)。
+ 在用户订阅的 AWS 账户中。如果用户订阅了多个 AWS 账户，则您必须在每个账户中创建存储桶。 Cross-account 不支持存储桶。
+ （可选但建议采纳）与您可能用于[提示日志记录](q-admin-prompt-logging.md)的存储桶不同。
+ 包括前缀（也称为子文件夹），Amazon Q 将在其中保存 CSV 文件。CSV 文件无法保存在存储桶的根目录中。
+ 具备如下存储桶策略。用您自己的信息替换{{bucketName}}{{region}}{{accountId}}、、和{{prefix}}。

------
#### [ 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}}:*"
                  }
              }
          }
      ]
  }
  ```

------

  如果您在存储桶 SSE-KMS 上进行配置，请在 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}}:*"
          }
      }
  }
  ```

  要了解如何保护 Amazon S3 存储桶中的数据，请参阅《Amazon Simple Storage Service 用户指南》**中的[利用加密来保护数据](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingEncryption.html)。

**启用用户活动报告**

1. 打开 Amazon Q 开发者版控制台。

   要使用 Amazon Q 开发者版控制台，您必须具备[支持管理员使用 Amazon Q 开发者版控制台](id-based-policy-examples-admins.md#q-admin-setup-admin-users)中定义的权限。

1. 选择**设置**。

1. 在 **Q 开发者版用户活动报告**下，选择**编辑**。

1. 切换**为每位用户收集精细指标**。

1. 在 **S3 位置**下，输入您将用于保留 CSV 报告的 Amazon S3 URI。示例：`s3://amzn-s3-demo-bucket/user-activity-reports/`