

**终止支持通知**： AWS 将于 2026 年 2 月 20 日终止对 Amazon Chime 服务的支持。2026 年 2 月 20 日之后，您将无法再访问 Amazon Chime 控制台或 Amazon Chime 应用程序资源。有关更多信息，请访问该[博客文章](https://aws.amazon.com/blogs/messaging-and-targeting/update-on-support-for-amazon-chime/)。**注意：**这不会影响 [Amazon Chime 软件开发工具包](https://aws.amazon.com/chime/chime-sdk/)服务的可用性。

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

# Amazon Chime 的日志记录和监控
<a name="monitoring-overview"></a>

监控是维护 Amazon Chime 和其他 AWS 解决方案的可靠性、可用性和性能的重要组成部分。 AWS 提供了以下工具来监控 Amazon Chime、报告问题并在适当时自动采取行动：
+ *Amazon* 会实时 CloudWatch监控您的 AWS 资源和您运行的应用程序 AWS。您可以收集和跟踪指标，创建自定义的控制面板，以及设置警报以在指定的指标达到您指定的阈值时通知您或采取措施。例如，您可以 CloudWatch 跟踪您的 Amazon EC2 实例的 CPU 使用率或其他指标，并在需要时自动启动新实例。有关更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。
+ *Amazon EventBridge* 提供了描述 AWS 资源变化的近乎实时的系统事件流。 EventBridge 支持事件驱动的自动计算。这使您可以编写规则，监视某些事件，并在这些事件发生时在其他 AWS 服务中触发自动操作。有关更多信息，请参阅 [Amazon EventBridge 用户指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/)。
+ *Amazon Lo CloudWatch g* s 允许您监控、存储和访问来自 Amazon EC2 实例和其他来源的日志文件。 CloudTrail CloudWatch 日志可以监视日志文件中的信息，并在达到特定阈值时通知您。您还可以在高持久性存储中检索您的日志数据。有关更多信息，请参阅 [Amazon CloudWatch 日志用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)。
+ *AWS CloudTrail*捕获您的账户或代表您的 AWS 账户进行的 API 调用和相关事件。然后它将日志文件传送到您指定的 Amazon S3 存储桶。您可以识别哪些用户和帐户拨打了电话 AWS、发出呼叫的源 IP 地址以及呼叫发生的时间。有关更多信息，请参阅 [AWS CloudTrail 《用户指南》](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。

**Topics**
+ [使用亚马逊监控 Amazon Chime CloudWatch](monitoring-cloudwatch.md)
+ [使用 Amazon Chime 实现自动化 EventBridge](automating-chime-with-cloudwatch-events.md)
+ [使用记录 Amazon Chime API 调用 AWS CloudTrail](cloudtrail.md)

# 使用亚马逊监控 Amazon Chime CloudWatch
<a name="monitoring-cloudwatch"></a>

您可以使用监控 Amazon Chime CloudWatch，它会收集原始数据并将其处理为可读的近乎实时的指标。这些统计数据会保存 15 个月，从而使您能够访问历史信息，并能够更好地了解您的 Web 应用程序或服务的执行情况。还可以设置特定阈值监视警报，在达到对应阈值时发送通知或采取行动。有关更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。

## CloudWatch Amazon Chime 的指标
<a name="cw-metrics"></a>

Amazon Chime 向发送以下指标。 CloudWatch

`AWS/ChimeVoiceConnector`命名空间包括分配给您的 AWS 账户和 Amazon Chime Voice Connectors 的电话号码的以下指标。


| 指标 | 说明 | 
| --- | --- | 
|  `InboundCallAttempts`  |  尝试的入站呼叫次数。 单位：计数  | 
|  `InboundCallFailures`  |  入站呼叫失败次数。 单位：计数  | 
|  `InboundCallsAnswered`  |  应答的入站呼叫次数。 单位：计数  | 
|  `InboundCallsActive`  |  当前处于活动状态的入站呼叫次数。 单位：计数  | 
|  `OutboundCallAttempts`  |  尝试进行的出站呼叫次数。 单位：计数  | 
|  `OutboundCallFailures`  |  出站呼叫失败的次数。 单位：计数  | 
|  `OutboundCallsAnswered`  |  应答的出站呼叫次数。 单位：计数  | 
|  `OutboundCallsActive`  |  当前处于活动状态的出站呼叫次数。 单位：计数  | 
|  `Throttles`  |  尝试进行呼叫时，您的账户受到限制的次数。 单位：计数  | 
|  `Sip1xxCodes`  |  具有 1xx 级状态代码的 SIP 消息数。 单位：计数  | 
|  `Sip2xxCodes`  |  具有 2xx 级状态代码的 SIP 消息数。 单位：计数  | 
|  `Sip3xxCodes`  |  具有 3xx 级状态代码的 SIP 消息数。 单位：计数  | 
|  `Sip4xxCodes`  |  具有 4xx 级状态代码的 SIP 消息数。 单位：计数  | 
|  `Sip5xxCodes`  |  具有 5xx 级状态代码的 SIP 消息数。 单位：计数  | 
|  `Sip6xxCodes`  |  具有 6xx 级状态代码的 SIP 消息数。 单位：计数  | 
|  `CustomerToVcRtpPackets`  |  客户发送到 Amazon Chime Voice Connector 基础设施的 RTP 数据包数。 单位：计数  | 
|  `CustomerToVcRtpBytes`  |  客户在 RTP 数据包中发送到 Amazon Chime Voice Connector 基础设施的字节数。 单位：计数  | 
|  `CustomerToVcRtcpPackets`  |  客户发送到 Amazon Chime Voice Connector 基础设施的 RTCP 数据包数。 单位：计数  | 
|  `CustomerToVcRtcpBytes`  |  客户在 RTCP 数据包中发送到 Amazon Chime Voice Connector 基础设施的字节数。 单位：计数  | 
|  `CustomerToVcPacketsLost`  |  客户发送到 Amazon Chime Voice Connector 基础设施的传输过程中丢失的数据包数。 单位：计数  | 
|  `CustomerToVcJitter`  |  客户发送到 Amazon Chime Voice Connector 基础设施的数据包的平均抖动。 单位：微秒  | 
|  `VcToCustomerRtpPackets`  |  Amazon Chime Voice Connector 基础设施发送到客户的 RTP 数据包数。 单位：计数  | 
|  `VcToCustomerRtpBytes`  |  在 RTP 数据包中 Amazon Chime Voice Connector 基础设施发送到客户的字节数。 单位：计数  | 
|  `VcToCustomerRtcpPackets`  |  Amazon Chime Voice Connector 基础设施发送到客户的 RTCP 数据包数。 单位：计数  | 
|  `VcToCustomerRtcpBytes`  |  在 RTCP 数据包中 Amazon Chime Voice Connector 基础设施发送到客户的字节数。 单位：计数  | 
|  `VcToCustomerPacketsLost`  |  Amazon Chime Voice Connector 基础设施发送到客户的传输过程中丢失的数据包数。 单位：计数  | 
|  `VcToCustomerJitter`  |  Amazon Chime Voice Connector 基础设施发送到客户的数据包的平均抖动。 单位：微秒  | 
|  `RTTBetweenVcAndCustomer`  |  客户与 Amazon Chime Voice Connector 基础设施之间的平均往返时间。 单位：微秒  | 
|  `MOSBetweenVcAndCustomer`  |  客户与 Amazon Chime Voice Connector 基础设施之间的语音流关联的估计平均意见得分 (MOS)。 单位：得分，介于 1.0 到 4.4 之间。分数越高表示感知的音频质量越好。  | 
|  `RemoteToVcRtpPackets`  |  远程端发送到 Amazon Chime Voice Connector 基础设施的 RTP 数据包数。 单位：计数  | 
|  `RemoteToVcRtpBytes`  |  在 RTP 数据包中远程端发送到 Amazon Chime Voice Connector 基础设施的字节数。 单位：计数  | 
|  `RemoteToVcRtcpPackets`  |  远程端发送到 Amazon Chime Voice Connector 基础设施的 RTCP 数据包数。 单位：计数  | 
|  `RemoteToVcRtcpBytes`  |  在 RTCP 数据包中远程端发送到 Amazon Chime Voice Connector 基础设施的字节数。 单位：计数  | 
|  `RemoteToVcPacketsLost`  |  远程端发送到 Amazon Chime Voice Connector 基础设施的传输过程中丢失的数据包数。 单位：计数  | 
|  `RemoteToVcJitter`  |  远程端发送到 Amazon Chime Voice Connector 基础设施的数据包的平均抖动。 单位：微秒  | 
|  `VcToRemoteRtpPackets`  |  Amazon Chime Voice Connector 基础设施发送到远程端的 RTP 数据包数。 单位：计数  | 
|  `VcToRemoteRtpBytes`  |  在 RTP 数据包中 Amazon Chime Voice Connector 基础设施发送到远程端的字节数。 单位：计数  | 
|  `VcToRemoteRtcpPackets`  |  Amazon Chime Voice Connector 基础设施发送到远程端的 RTCP 数据包数。 单位：计数  | 
|  `VcToRemoteRtcpBytes`  |  在 RTCP 数据包中 Amazon Chime Voice Connector 基础设施发送到远程端的字节数。 单位：计数  | 
|  `VcToRemotePacketsLost`  |  Amazon Chime Voice Connector 基础设施发送到远程端的传输过程中丢失的数据包数。 单位：计数  | 
|  `VcToRemoteJitter`  |  Amazon Chime Voice Connector 基础设施发送到远程端的数据包的平均抖动。 单位：微秒  | 
|  `RTTBetweenVcAndRemote`  |  远程端与 Amazon Chime Voice Connector 基础设施之间的平均往返时间。 单位：微秒  | 
|  `MOSBetweenVcAndRemote`  |  远程端与 Amazon Chime Voice Connector 基础设施之间的语音流关联的估计平均意见得分 (MOS)。 单位：得分，介于 1.0 到 4.4 之间。分数越高表示感知的音频质量越好。  | 

## CloudWatch 亚马逊 Chime 的尺寸
<a name="cw-dimensions"></a>

您可以在 Amazon Chime 上使用的 CloudWatch 尺寸如下所示。


| 维度 | 说明 | 
| --- | --- | 
|  `VoiceConnectorId`  |  用于显示指标的 Amazon Chime Voice Connector 标识符。  | 
|  `Region`  |  与事件关联的 AWS 区域。  | 

## CloudWatch Amazon Chime 的日志
<a name="cw-logs"></a>

您可以将 Amazon Chime 语音连接器指标发送到 CloudWatch 日志。有关更多信息，请参阅《Amazon Chime SDK 管理指南》**中的[编辑 Amazon Chime Voice Connector 设置](https://docs.aws.amazon.com/chime-sdk/latest/ag/edit-voicecon.html)。

**媒体质量指标日志**  
您可以选择接受适用于 Amazon Chime Voice Connector 的媒体质量指标日志。当你这样做时，Amazon Chime 会将你所有 Amazon Chime Voice Connector 通话的每分钟详细指标发送到为你创建的 CloudWatch 日志日志组。日志组名称为 `/aws/ChimeVoiceConnectorLogs/${VoiceConnectorID}`。以下字段以 JSON 格式包含在日志中。


| 字段 | 说明 | 
| --- | --- | 
|  voice\$1connector\$1id  |  传送呼叫的 Amazon Chime Voice Connector ID。  | 
|  event\$1timestamp  |  发出指标的时间，以 UTC 时间的 UNIX 纪元（1970 年 1 月 1 日午夜）开始的毫秒为单位。  | 
|  call\$1id  |  对应事务 ID。  | 
|  from\$1sip\$1user  |  发出呼叫的用户。  | 
|  from\$1country  |  发出呼叫的国家/地区。  | 
|  to\$1sip\$1user  |  接收呼叫的用户。  | 
|  to\$1country  |  接收呼叫的国家/地区。  | 
|  endpoint\$1id  |  一个不透明标识符，指明呼叫的其他终端节点。与 CloudWatch 日志见解一起使用。有关更多信息，请参阅 *Amazon 日志用户指南中的使用 CloudWatch 日志见解分析 CloudWatch 日志*[数据](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)。  | 
|  aws\$1region  |  呼叫的 AWS 区域。  | 
|  cust2vc\$1rtp\$1packets  |  客户发送到 Amazon Chime Voice Connector 基础设施的 RTP 数据包数。  | 
|  cust2vc\$1rtp\$1bytes  |  客户在 RTP 数据包中发送到 Amazon Chime Voice Connector 基础设施的字节数。  | 
|  cust2vc\$1rtcp\$1packets  |  客户发送到 Amazon Chime Voice Connector 基础设施的 RTCP 数据包数。  | 
|  cust2vc\$1rtcp\$1bytes  |  客户在 RTCP 数据包中发送到 Amazon Chime Voice Connector 基础设施的字节数。  | 
|  cust2vc\$1packets\$1lost  |  客户发送到 Amazon Chime Voice Connector 基础设施的传输过程中丢失的数据包数。  | 
|  cust2vc\$1jitter  |  客户发送到 Amazon Chime Voice Connector 基础设施的数据包的平均抖动。  | 
|  vc2cust\$1rtp\$1packets  |  Amazon Chime Voice Connector 基础设施发送到客户的 RTP 数据包数。  | 
|  vc2cust\$1rtp\$1bytes  |  在 RTP 数据包中 Amazon Chime Voice Connector 基础设施发送到客户的字节数。  | 
|  vc2cust\$1rtcp\$1packets  |  Amazon Chime Voice Connector 基础设施发送到客户的 RTCP 数据包数。  | 
|  vc2cust\$1rtcp\$1bytes  |  在 RTCP 数据包中 Amazon Chime Voice Connector 基础设施发送到客户的字节数。  | 
|  vc2cust\$1packets\$1lost  |  Amazon Chime Voice Connector 基础设施发送到客户的传输过程中丢失的数据包数。  | 
|  vc2cust\$1jitter  |  Amazon Chime Voice Connector 基础设施发送到客户的数据包的平均抖动。  | 
|  rtt\$1btwn\$1vc\$1and\$1cust  |  客户与 Amazon Chime Voice Connector 基础设施之间的平均往返时间。  | 
|  mos\$1btwn\$1vc\$1and\$1cust  |  客户与 Amazon Chime Voice Connector 基础设施之间的语音流关联的估计平均意见得分 (MOS)。  | 
|  rem2vc\$1rtp\$1packets  |  远程端发送到 Amazon Chime Voice Connector 基础设施的 RTP 数据包数。  | 
|  rem2vc\$1rtp\$1bytes  |  在 RTP 数据包中远程端发送到 Amazon Chime Voice Connector 基础设施的字节数。  | 
|  rem2vc\$1rtcp\$1packets  |  远程端发送到 Amazon Chime Voice Connector 基础设施的 RTCP 数据包数。  | 
|  rem2vc\$1rtcp\$1bytes  |  在 RTCP 数据包中远程端发送到 Amazon Chime Voice Connector 基础设施的字节数。  | 
|  rem2vc\$1packets\$1lost  |  远程端发送到 Amazon Chime Voice Connector 基础设施的传输过程中丢失的数据包数。  | 
|  rem2vc\$1jitter  |  远程端发送到 Amazon Chime Voice Connector 基础设施的数据包的平均抖动。  | 
|  vc2rem\$1rtp\$1packets  |  Amazon Chime Voice Connector 基础设施发送到远程端的 RTP 数据包数。  | 
|  vc2rem\$1rtp\$1bytes  |  在 RTP 数据包中 Amazon Chime Voice Connector 基础设施发送到远程端的字节数。  | 
|  vc2rem\$1rtcp\$1packets  |  Amazon Chime Voice Connector 基础设施发送到远程端的 RTCP 数据包数。  | 
|  vc2rem\$1rtcp\$1bytes  |  在 RTCP 数据包中 Amazon Chime Voice Connector 基础设施发送到远程端的字节数。  | 
|  vc2rem\$1packets\$1lost  |  Amazon Chime Voice Connector 基础设施发送到远程端的传输过程中丢失的数据包数。  | 
|  vc2rem\$1jitter  |  Amazon Chime Voice Connector 基础设施发送到远程端的数据包的平均抖动。  | 
|  rtt\$1btwn\$1vc\$1and\$1rem  |  远程端与 Amazon Chime Voice Connector 基础设施之间的平均往返时间。  | 
|  mos\$1btwn\$1vc\$1and\$1rem  |  远程端与 Amazon Chime Voice Connector 基础设施之间的语音流关联的估计平均意见得分 (MOS)。  | 

**SIP 消息日志**  
您可以选择接收 Amazon Chime Voice Connector 的 SIP 消息日志。当您这样做时，Amazon Chime 会捕获入站和出站 SIP 消息，并将它们发送到为您创建的 CloudWatch 日志日志组。日志组名称为 `/aws/ChimeVoiceConnectorSipMessages/${VoiceConnectorID}`。以下字段以 JSON 格式包含在日志中。


| 字段 | 说明 | 
| --- | --- | 
|  voice\$1connector\$1id  |  Amazon Chime Voice Connector ID。  | 
|  aws\$1region  |  与事件关联的 AWS 区域。  | 
|  event\$1timestamp  |  捕获消息的时间，以 UTC 时间的 UNIX 纪元（1970 年 1 月 1 日午夜）开始的毫秒为单位。  | 
|  call\$1id  |  Amazon Chime Voice Connector 调用 ID。  | 
|  sip\$1message  |  捕获的完整 SIP 消息。  | 

# 使用 Amazon Chime 实现自动化 EventBridge
<a name="automating-chime-with-cloudwatch-events"></a>

Amazon EventBridge 允许您实现 AWS 服务自动化，并自动响应系统事件，例如应用程序可用性问题或资源更改。有关会议事件的更多信息，请参阅《Amazon Chime 开发人员指南》**中的[会议事件](https://docs.aws.amazon.com/chime/latest/dg/using-events.html)。

当 Amazon Chime 生成事件时，它会将其发送到以 EventBridge *尽最大努力交付*，这意味着 Amazon Chime 会尝试将所有事件发送 EventBridge到，但在极少数情况下，事件可能无法传送。有关更多信息，请参阅 *Amazon EventBridge 用户指南*中的[来自 AWS 服务的事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)。

**注意**  
如需加密数据，则必须使用 Amazon S3 托管密钥。我们不支持使用存储在密钥管理服务中的客户主密钥进行服务器端加密。 AWS 

## 使用 Amazon Chime 语音连接器实现自动化 EventBridge
<a name="events-cvc"></a>

Amazon Chime Voice Connector 可自动触发的操作包括：
+ 调用函数 AWS Lambda 
+ 启动 Amazon Elastic Container Service 任务
+ 将事件中继到 Amazon Kinesis Video Streams
+ 激活 AWS Step Functions 状态机
+ 通知 Amazon SNS 主题或 Amazon SQS 队列

 EventBridge 与 Amazon Chime 语音连接器配合使用的一些示例包括：
+ 激活 Lambda 函数，在结束调用后下载相关音频。
+ 启动 Amazon ECS 任务，在开始调用后启用实时转录。

有关更多信息，请参阅 [Amazon EventBridge 用户指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/)。

## Amazon Chime Voice Connector 流式处理事件
<a name="stream-events-cvc"></a>

Amazon Chime 语音连接器支持将事件发送 EventBridge 到本节中讨论的事件发生的时间。

### Amazon Chime Voice Connector 开启流式处理
<a name="stream-start-cvc"></a>

Amazon Chime Voice Connector 会在 Kinesis Video Streams 开启媒体流时发送此事件。

**Example 事件数据**  
以下是此事件的示例数据。  

```
{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "callId": "1112-2222-4333",
        "direction": "Outbound",
        "fromNumber": "+12065550100",
        "inviteHeaders": {
            "from": "\"John\" <sip:+12065550100@10.24.34.0>;tag=abcdefg",
            "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws:5060>",
            "call-id": "1112-2222-4333",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>;",
            "content-type": "application/sdp",
            "content-length": "246"
        },
        "isCaller": false,
        "mediaType": "audio/L16",
        "sdp": {
            "mediaIndex": 0,
            "mediaLabel": "1"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>;\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "startFragmentNumber": "1234567899444",
        "startTime": "yyyy-mm-ddThh:mm:ssZ",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333",
        "toNumber": "+13605550199",
        "transactionId": "12345678-1234-1234",
        "voiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "streamingStatus": "STARTED",
        "version": "0"
    }
}
```

### Amazon Chime Voice Connector 结束流式处理
<a name="stream-end-cvc"></a>

Amazon Chime Voice Connector 会在 Kinesis Video Streams 结束媒体流时发送此事件。

**Example 事件数据**  
以下是此事件的示例数据。  

```
{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "streamingStatus": "ENDED",
        "voiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "transactionId": "12345678-1234-1234",
        "callId": "1112-2222-4333",
        "direction": "Inbound",
        "fromNumber": "+12065550100",
        "inviteHeaders": {
            "from": "\"John\" <sip:+12065550100@10.24.34.0>;tag=abcdefg",
            "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws:5060>",
            "call-id": "1112-2222-4333",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>",
            "content-type": "application/sdp",
            "content-length": "246"
        },
        "isCaller": false,
        "mediaType": "audio/L16",
        "sdp": {
            "mediaIndex": 0,
            "mediaLabel": "1"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "startFragmentNumber": "1234567899444",
        "startTime": "yyyy-mm-ddThh:mm:ssZ",
        "endTime": "yyyy-mm-ddThh:mm:ssZ",
        "streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333",
        "toNumber": "+13605550199",
        "version": "0"
    }
}
```

### Amazon Chime Voice Connector 更新流式处理
<a name="stream-update-cvc"></a>

Amazon Chime Voice Connector 会在 Kinesis Video Streams 更新媒体流时发送此事件。

**Example 事件数据**  
以下是此事件的示例数据。  

```
{
    "version": "0",
    "id": "12345678-1234-1234-1234-111122223333",
    "detail-type": "Chime VoiceConnector Streaming Status",
    "source": "aws.chime",
    "account": "111122223333",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "callId": "1112-2222-4333",
        "updateHeaders": {
            "from": "\"John\" <sip:+12065550100@10.24.34.0>;;tag=abcdefg",
            "to": "<sip:+13605550199@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws:5060>",
            "call-id": "1112-2222-4333",
            "cseq": "101 INVITE",
            "contact": "<sip:user@10.24.34.0:6090>",
            "content-type": "application/sdp",
            "content-length": "246"
        },
        "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n<recording xmlns='urn:ietf:params:xml:ns:recording:1'>",
        "streamingStatus": "UPDATED",
        "transactionId": "12345678-1234-1234",
        "version": "0",
        "voiceConnectorId": "abcdef1ghij2klmno3pqr4"
    }
}
```

### Amazon Chime Voice Connector 流式处理失败
<a name="stream-fail-cvc"></a>

Amazon Chime Voice Connector 会在 Kinesis Video Streams 媒体流操作失败时发送此事件。

**Example 事件数据**  
以下是此事件的示例数据。  

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-111122223333",
  "detail-type": "Chime VoiceConnector Streaming Status",
  "source": "aws.chime",
  "account": "111122223333",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "region": "us-east-1",
  "resources": [],
  "detail": {
       "streamingStatus":"FAILED",
       "voiceConnectorId":"abcdefghi",
       "transactionId":"12345678-1234-1234",
       "callId":"1112-2222-4333",
       "direction":"Inbound",
       "failTime":"yyyy-mm-ddThh:mm:ssZ",
       "failureReason": "Internal failure",
       "version":"0"
  }
}
```

# 使用记录 Amazon Chime API 调用 AWS CloudTrail
<a name="cloudtrail"></a>

Amazon Chime 与一项服务集成 AWS CloudTrail，该服务提供用户、角色或 AWS 服务在 Amazon Chime 中执行的操作的记录。 CloudTrail 将所有 Amazon Chime 的 API 调用捕获为事件，包括来自亚马逊 Chime 控制台的调用和对 Amazon Chime 的代码调用。 APIs如果您创建了跟踪，则可以允许将 CloudTrail 事件持续传输到 Amazon S3 存储桶，包括 Amazon Chime 的事件。如果您未配置跟踪，您仍然可以在 CloudTrail 控制台的 “事件**历史记录” 中查看最新的事件**。通过收集的信息 CloudTrail，您可以确定向 Amazon Chime 发出的请求、发出请求的 IP 地址、谁提出了请求、何时提出请求以及其他详细信息。

要了解更多信息 CloudTrail，请参阅[AWS CloudTrail 用户指南](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。

## Amazon Chime 中的信息 CloudTrail
<a name="service-name-info-in-cloudtrail"></a>

CloudTrail 在您创建 AWS 账户时已在您的账户上启用。**从 Amazon Chime 管理控制台发出 API 调用时，该活动会与其他 AWS 服务 CloudTrail 事件一起记录在事件历史记录中。**您可以在自己的 AWS 账户中查看、搜索和下载最近发生的事件。有关更多信息，请参阅[使用事件历史查看 CloudTrail 事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。

要持续记录您的 AWS 账户中的事件，包括 Amazon Chime 的事件，请创建跟踪。跟踪允许 CloudTrail 将日志文件传输到 Amazon S3 存储桶。预设情况下，在控制台中创建跟踪时，此跟踪应用于所有 区域。跟踪记录 AWS 分区中所有区域的事件，并将日志文件传送到您指定的 Amazon S3 存储桶。此外，您可以配置其他 AWS 服务以进一步分析和处理以下内容： CloudTrail 日志中收集的事件数据。有关更多信息，请参阅: 
+ [创建跟踪概览](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail 支持的服务和集成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [配置 Amazon SNS 通知 CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [接收来自多个区域的 CloudTrail 日志文件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)和[接收来自多个账户的 CloudTrail 日志文件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

所有 Amazon Chime 操作均由《[https://docs.aws.amazon.com/chime/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/chime/latest/APIReference/Welcome.html) API 参考》记录 CloudTrail 并记录在案。例如，调用`CreateAccount`、`InviteUsers`和`ResetPersonalPIN`节会在 CloudTrail 日志文件中生成条目。每个事件或日志条目都包含有关生成请求的人员信息。身份信息可帮助您确定以下内容：
+ 请求是使用根用户凭证还是 IAM 用户凭证发出的。
+ 请求是使用角色还是联合用户的临时安全凭证发出的。
+ 请求是否由其他 AWS 服务发出。

有关更多信息，请参阅 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。

## 了解 Amazon Chime 日志文件条目
<a name="understanding-service-name-entries"></a>

跟踪是一种配置，允许将事件作为日志文件传输到您指定的 Amazon S3 存储桶。 CloudTrail 日志文件包含一个或多个日志条目。事件代表来自任何来源的单个请求，包括有关请求的操作、操作的日期和时间、请求参数等的信息。 CloudTrail 日志文件不是公共 API 调用的有序堆栈跟踪，因此它们不会按任何特定顺序出现。

使用 **chime.amazonaws.com** 事件源识别 Amazon Chime 条目。

如果您已为 Amazon Chime 账户配置活动目录，请参阅使用[记录 AWS Directory Service API 调用](https://docs.aws.amazon.com/directoryservice/latest/devguide/cloudtrail_logging.html)。 CloudTrail其中描述了如何监控可能会影响 Amazon Chime 用户登录功能的问题。

以下示例显示了 Amazon Chime 的 CloudTrail 日志条目：

```
{"eventVersion":"1.05",
         "userIdentity":{  
            "type":"IAMUser",
            "principalId":" AAAAAABBBBBBBBEXAMPLE",
            "arn":"arn:aws:iam::123456789012:user/Alice ",
            "accountId":"0123456789012",
            "accessKeyId":"AAAAAABBBBBBBBEXAMPLE",
            "sessionContext":{  
               "attributes":{  
                  "mfaAuthenticated":"false",
                  "creationDate":"2017-07-24T17:57:43Z"
               },
               "sessionIssuer":{  
                  "type":"Role",
                  "principalId":"AAAAAABBBBBBBBEXAMPLE",
                  "arn":"arn:aws:iam::123456789012:role/Joe",
                  "accountId":"123456789012",
                  "userName":"Joe"
               }
            }
         } ,
         "eventTime":"2017-07-24T17:58:21Z",
         "eventSource":"chime.amazonaws.com",
         "eventName":"AddDomain",
         "awsRegion":"us-east-1",
         "sourceIPAddress":"72.21.198.64",
         "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36",
         "errorCode":"ConflictException",
         "errorMessage":"Request could not be completed due to a conflict",
         "requestParameters":{  
            "domainName":"example.com",
            "accountId":"11aaaaaa1-1a11-1111-1a11-aaadd0a0aa00"
         },
         "responseElements":null,
         "requestID":"be1bee1d-1111-11e1-1eD1-0dc1111f1ac1",
         "eventID":"00fbeee1-123e-111e-93e3-11111bfbfcc1",
         "eventType":"AwsApiCall",
         "recipientAccountId":"123456789012"
      }
```