为何Amazon Connect关联的Kinesis Stream数据查看器无Agent Events？

以下是针对问题的具体排查步骤和解决方法：

1. 验证Amazon Connect服务角色的Kinesis权限 #

Amazon Connect需要具备向目标Kinesis Stream写入数据的权限，否则无法推送Agent Events：

• 进入Amazon Connect实例控制台，导航到Settings > Service role，查看当前关联的IAM角色。
• 打开该IAM角色的权限策略，确认包含以下权限语句（替换<区域>``<账号ID>为你的实际信息）：

  {
      "Effect": "Allow",
      "Action": [
          "kinesis:PutRecord",
          "kinesis:PutRecords"
      ],
      "Resource": "arn:aws:kinesis:<区域>:<账号ID>:stream/amzn-conn-agent-events"
  }
  

• 如果缺少该权限，添加后保存策略，等待5分钟左右让权限生效。

2. 确认Agent Events的触发条件已满足 #

Agent Events仅在特定场景下触发，需确保你的操作覆盖了事件触发逻辑：

• 必须由已登录到Agent Workspace的坐席接听来电，而非自动语音应答（IVR）直接处理。
• 触发事件的典型场景包括：坐席登录/登出、状态切换（就绪→忙碌→就绪）、来电接通/挂断、通话转接等。
• 测试时，确保坐席完成完整流程：登录Workspace → 切换到就绪状态 → 接听来电 → 主动挂断电话 → 切换回就绪状态，这些操作都会生成对应的Agent Events。

3. 确认数据流配置生效 #

修改Data Streaming设置后，配置不会立即生效，需等待一段时间：

• 完成配置后，等待5-10分钟再进行测试，避免因配置同步延迟导致无数据。
• 重新进入Connect实例的Data Streaming页面，确认Agent Events的状态为Enabled，且关联的Kinesis Stream名称正确无误。

4. 验证Kinesis Stream的写入状态 #

通过CloudWatch确认是否有数据写入流：

• 打开CloudWatch控制台，导航到Metrics > All metrics > Kinesis > Stream Metrics。
• 选择你的amzn-conn-agent-events流，查看PutRecord.Success指标：如果该指标有数值，说明数据已成功写入；如果为0，说明Connect未发起写入请求，需回到权限或配置排查。

5. 改用CLI工具验证数据 #

控制台的Data Viewer可能存在延迟或显示问题，可通过AWS CLI直接查询Kinesis数据：

1. 获取分片迭代器：

   aws kinesis get-shard-iterator --stream-name amzn-conn-agent-events --shard-id shardId-000000000000 --shard-iterator-type TRIM_HORIZON
   

2. 使用返回的ShardIterator获取记录：

   aws kinesis get-records --shard-iterator <返回的迭代器值>
   

如果CLI能查询到数据，说明控制台Data Viewer存在显示延迟，等待刷新即可；如果仍无数据，继续排查权限和触发条件。

内容的提问来源于stack exchange，提问作者Kode Charlie