本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
您可以将 Amazon Q 配置为收集组织中 Amazon Q Developer 订阅者的用户活动遥测数据，并在报告中提供该信息。该报告可让您深入了解整个用户群中Amazon Q的使用情况。
Amazon Q 每天午夜生成报告，并将其保存在 CSV 文件中，路径如下：
s3://bucketName/prefix/month/day/timestamp-report.csv
CSV 文件的布局如下所示：
-
每行显示当天与 Amazon Q 互动的用户。
-
每列都显示一个指标，如中所述用户活动报告指标。指标是根据一天中收集的用户遥测数据计算的。
如果 CSV 文件超过 1 MB，Amazon Q 会将当天的数据拆分成几个 CSV 文件。
注意
当您启用用户活动报告时，无论开发者在其 IDE 中如何 AWS设置 “启用 Amazon Q 以发送使用数据”，Amazon Q 都会收集遥测数据。该设置控制着AWS 公司而不是您的组织是否可以使用遥测技术。有关该设置的更多信息，请参阅 选择不共享您的客户端遥测数据。
按照以下说明启用用户活动报告。
先决条件
创建一个 Amazon S3 存储桶来保存用户活动报告 CSV 文件。该存储桶必须满足以下要求：
-
无论您的 IAM Identity Center 位于何处，存储桶必须位于美国东部（弗吉尼亚州北部）区域。
-
在用户订阅的 AWS 账户中。如果用户订阅了多个 AWS 账户，则您必须在每个账户中创建存储桶。不支持跨账户存储桶。
-
（可选，但建议使用）与您可能用于提示日志记录的存储桶不同。
-
添加前缀（也称为子文件夹），Amazon Q 将在其中保存 CSV 文件。CSV 文件无法保存在存储桶的根目录中。
-
具备如下存储桶策略。用您自己的信息替换
bucketNameregionaccountId、、和prefix。{ "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:*" } } } ] }如果在存储桶上配置 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 用户指南》中的利用加密来保护数据。
启用用户活动报告
-
打开 Amazon Q 开发者版控制台。
要使用 Amazon Q 开发者控制台，您必须拥有中定义的权限允许管理员使用 Amazon Q 开发者控制台。
-
选择设置。
-
在 Q Developer 用户活动报告下，选择编辑。
-
切换为每位用户收集精细指标。
-
在 S3 位置下，输入您将用于保存 CSV 报告的亚马逊 S3 URI。示例：
s3://amzn-s3-demo-bucket/user-activity-reports/
