Appearance
用户活动报表适合需要做成本归因、合规审计和团队采用度分析的企业。管理员启用后，Kiro 会按 IDE、CLI、Plugin 等客户端每天生成 CSV，把每位订阅用户的消息量、会话数、credits 消耗和 overage 使用情况写入指定 S3 路径，便于后续接入 BI 或审计流程。
Kiro CLI Enterprise 用户活动报表：按人追踪团队使用情况
当 Kiro 在团队内正式推广后，管理员通常需要回答三个问题：谁在用、用了多少、是否已经接近或超过 plan 限额。用户活动报表就是为这个场景准备的。它不会只给一个汇总数字，而是按用户输出明细，方便你把 Kiro 使用情况和团队、项目或成本中心关联起来。
报表会生成在哪里
开启后，Kiro 每天 02:00 UTC 按客户端类型生成一次用户活动报表。客户端类型包括 IDE、CLI 和 Plugin。报表以 CSV 文件保存到你配置的 Amazon S3 位置，路径形态如下：
text
s3://bucketName/prefix/AWSLogs/accountId/KiroLogs/user_report/region/year/month/day/00/clientType_accountId_user_report_timestamp.csvCSV 的组织方式很直接：
- 每一行代表当天与 Kiro 发生过交互的一名用户。
- 每一列代表一个指标，例如消息数、会话数、credits 消耗、subscription tier 等。
- 如果当天活跃用户超过 1,000 人，Kiro 会拆分为多个 CSV 文件，每个文件最多 1,000 名用户，并使用
part_1、part_2这类后缀区分。
开启前先准备 S3 Bucket
在控制台开启报表之前，先准备一个用于接收 CSV 的 Amazon S3 bucket。企业环境里建议把这一步当成审计数据落盘配置来做，而不是随手选一个 bucket。
这个 bucket 需要满足以下条件：
- 位于安装 Kiro profile 的 AWS Region。Kiro profile 的概念可参考 Kiro profile，支持区域可参考 Supported Regions。
- 位于订阅用户所在的 AWS account。如果用户分布在多个 AWS account，需要分别在对应 account 中创建 bucket；Kiro 不支持跨 account bucket。
- 最好与用于记录用户 prompt 的 bucket 分开，避免审计数据和 prompt logging 数据混放。Prompt logging 可参考 记录用户提示词。
- 必须配置 prefix，也就是子目录。Kiro 不会把 CSV 写到 bucket 根目录。
- 需要允许 Kiro 相关 AWS service 写入对象。
示例 bucket policy 如下。使用时请把 bucketName、prefix、Region 和 accountId 替换成自己的值。
json
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "KiroLogsWrite",
"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:*"
}
}
}
]
}如果报表中包含可识别的员工使用数据，建议同时评估 S3 encryption、访问日志、生命周期策略和最小权限访问。S3 加密可参考 AWS 文档中的 Protecting data with encryption。
在 Kiro 控制台开启用户活动报表
准备好 S3 位置后，按下面步骤开启：
- 登录 AWS console。
- 切换到 Kiro console。管理员需要具备 允许配置 Kiro 和订阅用户的 IAM 权限。
- 进入 Settings。
- 在 Kiro user activity reports 区域选择 Edit。
- 开启 Collect granular metrics per user。
- 在 S3 location 中填写用于保存 CSV 的 S3 URI，例如
s3://amzn-s3-demo-bucket/user-activity-reports/。
配置完成后，下一次日报生成时就会开始写入 CSV。建议首次开启后第二天检查 S3 prefix，确认文件路径、Region 和账号都符合预期。
重点关注哪些指标
Kiro 的新报表指标更适合用于用量管理和成本分析。常用字段如下：
| 指标 | 含义 |
|---|---|
Date | 报表对应的活动日期。 |
UserId | 被统计用户的 ID。 |
Client_Type | 用户使用的客户端类型，例如 KIRO_IDE、KIRO_CLI 或 PLUGIN。 |
Subscription_Tier | 用户的 Kiro subscription plan，例如 Pro、ProPlus、Power。 |
ProfileId | 与该用户活动关联的 Kiro profile。 |
Total_Messages | 用户 prompt、tool calls 和 Kiro response 的总消息数。 |
Chat_Conversations | 当天该用户发起的会话数量。 |
Credits_Used | 当天从用户 subscription plan 中消耗的 credits。 |
Overage_Enabled | 该用户是否允许使用 overage。 |
Overage_Cap | overage 开启时的管理员设置上限；未开启时显示 plan 内置的最大 credits。 |
Overage_Credits_Used | 用户实际使用的 overage credits 数。 |
Model_name_Messages | 指定模型处理的消息数，也可能包含 Auto 模式。 |
建议管理员先把 Credits_Used、Overage_Credits_Used 和 Client_Type 做成基础看板。这样既能看到团队采用度，也能尽早发现异常高消耗用户。
旧版指标怎么理解
部分历史报表或兼容字段会继续出现旧版指标，例如：
Inline_AICodeLines、Inline_AcceptanceCount：反映 inline suggestion 的展示与接受情况。Chat_MessagesSent、Chat_MessagesInteracted：反映 Kiro chat 中的消息量和正向互动。CodeReview_*：反映 code review 发现问题、生成 fix、接受 fix 的情况。Dev_*、DocGeneration_*、TestGeneration_*、Transformation_*：分别对应/dev、/doc、/test、/transform等命令或能力的生成与接受情况。
如果你是新接入 Kiro，优先使用新指标做治理；旧指标更适合在迁移历史报表、对比早期采用情况时参考。
常见问题
用户活动报表会实时生成吗？
不会。Kiro 每天 02:00 UTC 生成一次日报，适合做日级统计、审计和成本分析，不适合作为实时监控数据源。
可以把多个 AWS account 的报表写到同一个 bucket 吗？
不可以。bucket 必须位于订阅用户所在的 AWS account。多个 account 需要分别配置对应 bucket。
为什么必须设置 S3 prefix？
Kiro 不会把 CSV 写入 bucket 根目录。使用 prefix 可以把 Kiro 用户活动报表和其他审计文件隔离，也方便后续设置生命周期和权限策略。