在 Amazon Q 开发者版中查看特定用户的活动 - Amazon Q 开发者版

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

在 Amazon Q 开发者版中查看特定用户的活动

您可以将 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 互动的一位用户。

  • 每列显示一个指标，如用户活动报告指标中所述。指标是根据一天中收集的用户遥测数据计算的。

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

注意

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

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

先决条件

创建一个 Amazon S3 存储桶来存放用户活动报告 CSV 文件。该存储桶必须满足以下要求：

  • 请位于安装了 Amazon Q 开发者配置文件的地 AWS 区。此配置文件是在您首次为 IAM Identity Center 员工用户订阅 Amazon Q 开发者版专业套餐时安装的。有关此配置文件及支持它的区域的更多信息，请参阅什么是 Amazon Q 开发者版配置文件？和 Q 开发者版控制台与 Q 开发者版配置文件支持的区域。

  • 在用户订阅的 AWS 账户中。如果在多个 AWS 账户中订阅了用户，则您必须在每个账户中创建存储桶。不支持跨账户存储桶。

  • （可选但建议采纳）与您可能用于提示日志记录的存储桶不同。

  • 包括前缀（也称为子文件夹），Amazon Q 将在其中保存 CSV 文件。CSV 文件无法保存在存储桶的根目录中。

  • 具备如下存储桶策略。用您自己的信息替换bucketNameregionaccountId、、和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 用户指南》中的利用加密来保护数据。

启用用户活动报告

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

    要使用 Amazon Q 开发者版控制台，您必须具备支持管理员使用 Amazon Q 开发者版控制台中定义的权限。

  2. 选择设置。

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

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

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