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

# 使用亚马逊监控 Amazon Chime 软件开发工具包 CloudWatch
<a name="monitoring-cloudwatch"></a>

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

## CloudWatch 亚马逊 Chime 软件开发工具包的指标
<a name="cw-metrics"></a>

Amazon Chime 软件开发工具包将以下指标发送到 CloudWatch Amazon Chime SDK 在通话期间每分钟发送一次指标，并发送此处列出的所有指标。

`AWS/ChimeVoiceConnector`命名空间包括分配给您的 AWS 账户和 Amazon Chime SDK 语音连接器的以下电话号码指标。

**注意**  
在通话期间，SDK 每分钟发送一次丢包值。损失值将在通话期间累积。例如，如果在 11:01 发生数据包丢失，则该丢失值将延续到呼叫的剩余分钟数。通话结束时，您将收到一个数据包丢失指标。


| 指标 | 说明 | 
| --- | --- | 
|  `SmaActiveCallCount`  |  活动并发 Sip 媒体应用程序调用的数量。 单位：计数  | 
|  `VoiceConnectorActiveCallCount`  |  当前并发语音连接器呼叫的数量。 单位：计数  | 
|  `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 SDK 语音连接器基础设施的 RTP 数据包数量。 单位：计数  | 
|  `CustomerToVcRtpBytes`  |  客户以 RTP 数据包形式发送到 Amazon Chime SDK 语音连接器基础设施的字节数。 单位：计数  | 
|  `CustomerToVcRtcpPackets`  |  客户向 Amazon Chime SDK 语音连接器基础设施发送的 RTCP 数据包数量。 单位：计数  | 
|  `CustomerToVcRtcpBytes`  |  客户以 RTCP 数据包形式发送到 Amazon Chime SDK 语音连接器基础设施的字节数。 单位：计数  | 
|  `CustomerToVcPacketsLost`  |  从客户传输到 Amazon Chime SDK 语音连接器基础设施的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。 单位：计数  | 
|  `CustomerToVcJitter`  |  从客户发送到 Amazon Chime SDK 语音连接器基础设施的数据包的平均抖动。 单位：微秒  | 
|  `VcToCustomerRtpPackets`  |  从 Amazon Chime SDK 语音连接器基础设施发送给客户的 RTP 数据包数量。 单位：计数  | 
|  `VcToCustomerRtpBytes`  |  通过 RTP 数据包从 Amazon Chime SDK 语音连接器基础设施发送给客户的字节数。 单位：计数  | 
|  `VcToCustomerRtcpPackets`  |  从 Amazon Chime SDK 语音连接器基础设施发送给客户的 RTCP 数据包数量。 单位：计数  | 
|  `VcToCustomerRtcpBytes`  |  通过 RTCP 数据包从 Amazon Chime SDK 语音连接器基础设施发送给客户的字节数。 单位：计数  | 
|  `VcToCustomerPacketsLost`  |  从 Amazon Chime SDK 语音连接器基础设施传输到客户的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。 单位：计数  | 
|  `VcToCustomerJitter`  |  从 Amazon Chime SDK 语音连接器基础设施发送给客户的数据包的平均抖动。 单位：微秒  | 
|  `RTTBetweenVcAndCustomer`  |  客户与 Amazon Chime SDK 语音连接器基础设施之间的平均往返时间。 单位：微秒  | 
|  `MOSBetweenVcAndCustomer`  |  与客户与 Amazon Chime SDK Voice Connector 基础设施之间的语音流相关的估计平均意见分数 (MOS)。 单位：得分，介于 1.0 到 4.4 之间。分数越高表示感知的音频质量越好。  | 
|  `RemoteToVcRtpPackets`  |  从远程端发送到 Amazon Chime SDK 语音连接器基础设施的 RTP 数据包数量。 单位：计数  | 
|  `RemoteToVcRtpBytes`  |  以 RTP 数据包形式从远程端发送到 Amazon Chime SDK 语音连接器基础设施的字节数。 单位：计数  | 
|  `RemoteToVcRtcpPackets`  |  从远程端发送到 Amazon Chime SDK 语音连接器基础设施的 RTCP 数据包数量。 单位：计数  | 
|  `RemoteToVcRtcpBytes`  |  在 RTCP 数据包中从远程端发送到 Amazon Chime SDK 语音连接器基础设施的字节数。 单位：计数  | 
|  `RemoteToVcPacketsLost`  |  从远程端传输到 Amazon Chime SDK 语音连接器基础设施的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。 单位：计数  | 
|  `RemoteToVcJitter`  |  从远程端发送到 Amazon Chime SDK 语音连接器基础设施的数据包的平均抖动。 单位：微秒  | 
|  `VcToRemoteRtpPackets`  |  从 Amazon Chime SDK 语音连接器基础设施发送到远程端的 RTP 数据包数量。 单位：计数  | 
|  `VcToRemoteRtpBytes`  |  通过 RTP 数据包从 Amazon Chime SDK 语音连接器基础设施发送到远程端的字节数。 单位：计数  | 
|  `VcToRemoteRtcpPackets`  |  从 Amazon Chime SDK 语音连接器基础设施发送到远程端的 RTCP 数据包数量。 单位：计数  | 
|  `VcToRemoteRtcpBytes`  |  在 RTCP 数据包中从 Amazon Chime SDK 语音连接器基础设施发送到远程端的字节数。 单位：计数  | 
|  `VcToRemotePacketsLost`  |  从 Amazon Chime SDK 语音连接器基础设施传输到远程端的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。 单位：计数  | 
|  `VcToRemoteJitter`  |  从 Amazon Chime SDK 语音连接器基础设施发送到远程端的数据包的平均抖动。 单位：微秒  | 
|  `RTTBetweenVcAndRemote`  |  远程端和 Amazon Chime SDK 语音连接器基础设施之间的平均往返时间。 单位：微秒  | 
|  `MOSBetweenVcAndRemote`  |  与远程端和 Amazon Chime SDK 语音连接器基础设施之间的语音流相关的估计平均意见分数 (MOS)。 单位：得分，介于 1.0 到 4.4 之间。分数越高表示感知的音频质量越好。  | 

## CloudWatch 亚马逊 Chime 软件开发工具包的尺寸
<a name="cw-dimensions"></a>

您可以在 Amazon Chime 软件开发工具包中使用的 CloudWatch 尺寸如下所示。


| 维度 | 说明 | 
| --- | --- | 
|  `VoiceConnectorId`  |  要显示其指标的 Amazon Chime SDK 语音连接器的标识符。  | 
|  `Region`  |  与事件关联的 AWS 区域。  | 

## CloudWatch 亚马逊 Chime 软件开发工具包的日志
<a name="cw-logs"></a>

您可以将 Amazon Chime SDK 语音连接器配置为向日志发送指标。 CloudWatch 当你这样做时，你还可以接收这些语音连接器的媒体质量指标日志。

Amazon Chime 软件开发工具包每分钟发送一次详细指标。Amazon Chime SDK 会针对使用配置的语音连接器进行的所有呼叫发送这些信息，然后将其发送到我们为您创建的 CloudWatch 日志日志组。

日志组名称使用以下格式：`/aws/ChimeVoiceConnectorLogs/${VoiceConnectorID}`。

有关配置语音连接器以发送指标的更多信息，请参阅[编辑 Amazon Chime SDK 语音连接器设置](edit-voicecon.md)。

**注意**  
数据包丢失指标在呼叫持续时间内累积。例如，如果在 11:01 发生数据包丢失，则该丢失值将延续到呼叫的剩余分钟数。通话结束时，您将收到一个数据包丢失指标。

Amazon Chime 软件开发工具包在日志中包含以下字段，采用 JSON 格式。


| 字段 | 说明 | 
| --- | --- | 
|  voice\$1connector\$1id  |  传送呼叫的 Amazon Chime SDK 语音连接器 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 SDK 语音连接器基础设施的 RTP 数据包数量。  | 
|  cust2vc\$1rtp\$1bytes  |  客户以 RTP 数据包形式发送到 Amazon Chime SDK 语音连接器基础设施的字节数。  | 
|  cust2vc\$1rtcp\$1packets  |  客户向 Amazon Chime SDK 语音连接器基础设施发送的 RTCP 数据包数量。  | 
|  cust2vc\$1rtcp\$1bytes  |  客户以 RTCP 数据包形式发送到 Amazon Chime SDK 语音连接器基础设施的字节数。  | 
|  cust2vc\$1packets\$1lost  |  从客户传输到 Amazon Chime SDK 语音连接器基础设施的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。  | 
|  cust2vc\$1jitter  |  从客户发送到 Amazon Chime SDK 语音连接器基础设施的数据包的平均抖动。  | 
|  vc2cust\$1rtp\$1packets  |  从 Amazon Chime SDK 语音连接器基础设施发送给客户的 RTP 数据包数量。  | 
|  vc2cust\$1rtp\$1bytes  |  通过 RTP 数据包从 Amazon Chime SDK 语音连接器基础设施发送给客户的字节数。  | 
|  vc2cust\$1rtcp\$1packets  |  从 Amazon Chime SDK 语音连接器基础设施发送给客户的 RTCP 数据包数量。  | 
|  vc2cust\$1rtcp\$1bytes  |  通过 RTCP 数据包从 Amazon Chime SDK 语音连接器基础设施发送给客户的字节数。  | 
|  vc2cust\$1packets\$1lost  |  从 Amazon Chime SDK 语音连接器基础设施传输到客户的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。  | 
|  vc2cust\$1jitter  |  从 Amazon Chime SDK 语音连接器基础设施发送给客户的数据包的平均抖动。  | 
|  rtt\$1btwn\$1vc\$1and\$1cust  |  客户与 Amazon Chime SDK 语音连接器基础设施之间的平均往返时间。  | 
|  mos\$1btwn\$1vc\$1and\$1cust  |  与客户与 Amazon Chime SDK Voice Connector 基础设施之间的语音流相关的估计平均意见分数 (MOS)。  | 
|  rem2vc\$1rtp\$1packets  |  从远程端发送到 Amazon Chime SDK 语音连接器基础设施的 RTP 数据包数量。  | 
|  rem2vc\$1rtp\$1bytes  |  以 RTP 数据包形式从远程端发送到 Amazon Chime SDK 语音连接器基础设施的字节数。  | 
|  rem2vc\$1rtcp\$1packets  |  从远程端发送到 Amazon Chime SDK 语音连接器基础设施的 RTCP 数据包数量。  | 
|  rem2vc\$1rtcp\$1bytes  |  在 RTCP 数据包中从远程端发送到 Amazon Chime SDK 语音连接器基础设施的字节数。  | 
|  rem2vc\$1packets\$1lost  |  从远程端传输到 Amazon Chime SDK 语音连接器基础设施的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。  | 
|  rem2vc\$1jitter  |  从远程端发送到 Amazon Chime SDK 语音连接器基础设施的数据包的平均抖动。  | 
|  vc2rem\$1rtp\$1packets  |  从 Amazon Chime SDK 语音连接器基础设施发送到远程端的 RTP 数据包数量。  | 
|  vc2rem\$1rtp\$1bytes  |  通过 RTP 数据包从 Amazon Chime SDK 语音连接器基础设施发送到远程端的字节数。  | 
|  vc2rem\$1rtcp\$1packets  |  从 Amazon Chime SDK 语音连接器基础设施发送到远程端的 RTCP 数据包数量。  | 
|  vc2rem\$1rtcp\$1bytes  |  在 RTCP 数据包中从 Amazon Chime SDK 语音连接器基础设施发送到远程端的字节数。  | 
|  vc2rem\$1packets\$1lost  |  从 Amazon Chime SDK 语音连接器基础设施传输到远程端的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。  | 
|  vc2rem\$1jitter  |  从 Amazon Chime SDK 语音连接器基础设施发送到远程端的数据包的平均抖动。  | 
|  rtt\$1btwn\$1vc\$1and\$1rem  |  远程端和 Amazon Chime SDK 语音连接器基础设施之间的平均往返时间。  | 
|  mos\$1btwn\$1vc\$1and\$1rem  |  与远程端和 Amazon Chime SDK 语音连接器基础设施之间的语音流相关的估计平均意见分数 (MOS)。  | 

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


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