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

# 使用亚马逊监控 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 媒体应用程序调用的数量。<br />单位：计数 | 
| `VoiceConnectorActiveCallCount` | 当前并发语音连接器呼叫的数量。<br />单位：计数 | 
| `InboundCallAttempts` | 尝试的入站呼叫次数。<br />单位：计数 | 
| `InboundCallFailures` | 入站呼叫失败次数。<br />单位：计数 | 
| `InboundCallsAnswered` | 应答的入站呼叫次数。<br />单位：计数 | 
| `InboundCallsActive` | 当前处于活动状态的入站呼叫次数。<br />单位：计数 | 
| `OutboundCallAttempts` | 尝试进行的出站呼叫次数。<br />单位：计数 | 
| `OutboundCallFailures` | 出站呼叫失败的次数。<br />单位：计数 | 
| `OutboundCallsAnswered` | 应答的出站呼叫次数。<br />单位：计数 | 
| `OutboundCallsActive` | 当前处于活动状态的出站呼叫次数。<br />单位：计数 | 
| `Throttles` | 尝试进行呼叫时，您的账户受到限制的次数。<br />单位：计数 | 
| `Sip1xxCodes` | 具有 1xx 级状态代码的 SIP 消息数。<br />单位：计数 | 
| `Sip2xxCodes` | 具有 2xx 级状态代码的 SIP 消息数。<br />单位：计数 | 
| `Sip3xxCodes` | 具有 3xx 级状态代码的 SIP 消息数。<br />单位：计数 | 
| `Sip4xxCodes` | 具有 4xx 级状态代码的 SIP 消息数。<br />单位：计数 | 
| `Sip5xxCodes` | 具有 5xx 级状态代码的 SIP 消息数。<br />单位：计数 | 
| `Sip6xxCodes` | 具有 6xx 级状态代码的 SIP 消息数。<br />单位：计数 | 
| `CustomerToVcRtpPackets` | 客户发送到 Amazon Chime SDK 语音连接器基础设施的 RTP 数据包数量。<br />单位：计数 | 
| `CustomerToVcRtpBytes` | 客户以 RTP 数据包形式发送到 Amazon Chime SDK 语音连接器基础设施的字节数。<br />单位：计数 | 
| `CustomerToVcRtcpPackets` | 客户向 Amazon Chime SDK 语音连接器基础设施发送的 RTCP 数据包数量。<br />单位：计数 | 
| `CustomerToVcRtcpBytes` | 客户以 RTCP 数据包形式发送到 Amazon Chime SDK 语音连接器基础设施的字节数。<br />单位：计数 | 
| `CustomerToVcPacketsLost` | 从客户传输到 Amazon Chime SDK 语音连接器基础设施的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。<br />单位：计数 | 
| `CustomerToVcJitter` | 从客户发送到 Amazon Chime SDK 语音连接器基础设施的数据包的平均抖动。<br />单位：微秒 | 
| `VcToCustomerRtpPackets` | 从 Amazon Chime SDK 语音连接器基础设施发送给客户的 RTP 数据包数量。<br />单位：计数 | 
| `VcToCustomerRtpBytes` | 通过 RTP 数据包从 Amazon Chime SDK 语音连接器基础设施发送给客户的字节数。<br />单位：计数 | 
| `VcToCustomerRtcpPackets` | 从 Amazon Chime SDK 语音连接器基础设施发送给客户的 RTCP 数据包数量。<br />单位：计数 | 
| `VcToCustomerRtcpBytes` | 通过 RTCP 数据包从 Amazon Chime SDK 语音连接器基础设施发送给客户的字节数。<br />单位：计数 | 
| `VcToCustomerPacketsLost` | 从 Amazon Chime SDK 语音连接器基础设施传输到客户的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。<br />单位：计数 | 
| `VcToCustomerJitter` | 从 Amazon Chime SDK 语音连接器基础设施发送给客户的数据包的平均抖动。<br />单位：微秒 | 
| `RTTBetweenVcAndCustomer` | 客户与 Amazon Chime SDK 语音连接器基础设施之间的平均往返时间。<br />单位：微秒 | 
| `MOSBetweenVcAndCustomer` | 与客户与 Amazon Chime SDK Voice Connector 基础设施之间的语音流相关的估计平均意见分数 (MOS)。<br />单位：得分，介于 1.0 到 4.4 之间。分数越高表示感知的音频质量越好。 | 
| `RemoteToVcRtpPackets` | 从远程端发送到 Amazon Chime SDK 语音连接器基础设施的 RTP 数据包数量。<br />单位：计数 | 
| `RemoteToVcRtpBytes` | 以 RTP 数据包形式从远程端发送到 Amazon Chime SDK 语音连接器基础设施的字节数。<br />单位：计数 | 
| `RemoteToVcRtcpPackets` | 从远程端发送到 Amazon Chime SDK 语音连接器基础设施的 RTCP 数据包数量。<br />单位：计数 | 
| `RemoteToVcRtcpBytes` | 在 RTCP 数据包中从远程端发送到 Amazon Chime SDK 语音连接器基础设施的字节数。<br />单位：计数 | 
| `RemoteToVcPacketsLost` | 从远程端传输到 Amazon Chime SDK 语音连接器基础设施的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。<br />单位：计数 | 
| `RemoteToVcJitter` | 从远程端发送到 Amazon Chime SDK 语音连接器基础设施的数据包的平均抖动。<br />单位：微秒 | 
| `VcToRemoteRtpPackets` | 从 Amazon Chime SDK 语音连接器基础设施发送到远程端的 RTP 数据包数量。<br />单位：计数 | 
| `VcToRemoteRtpBytes` | 通过 RTP 数据包从 Amazon Chime SDK 语音连接器基础设施发送到远程端的字节数。<br />单位：计数 | 
| `VcToRemoteRtcpPackets` | 从 Amazon Chime SDK 语音连接器基础设施发送到远程端的 RTCP 数据包数量。<br />单位：计数 | 
| `VcToRemoteRtcpBytes` | 在 RTCP 数据包中从 Amazon Chime SDK 语音连接器基础设施发送到远程端的字节数。<br />单位：计数 | 
| `VcToRemotePacketsLost` | 从 Amazon Chime SDK 语音连接器基础设施传输到远程端的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。<br />单位：计数 | 
| `VcToRemoteJitter` | 从 Amazon Chime SDK 语音连接器基础设施发送到远程端的数据包的平均抖动。<br />单位：微秒 | 
| `RTTBetweenVcAndRemote` | 远程端和 Amazon Chime SDK 语音连接器基础设施之间的平均往返时间。<br />单位：微秒 | 
| `MOSBetweenVcAndRemote` | 与远程端和 Amazon Chime SDK 语音连接器基础设施之间的语音流相关的估计平均意见分数 (MOS)。<br />单位：得分，介于 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\_connector\_id | 传送呼叫的 Amazon Chime SDK 语音连接器 ID。 | 
| event\_timestamp | 发出指标的时间，以 UTC 时间的 UNIX 纪元（1970 年 1 月 1 日午夜）开始的毫秒为单位。 | 
| call\_id | 对应事务 ID。 | 
| from\_sip\_user | 发出呼叫的用户。 | 
| from\_country | 发出呼叫的国家/地区。 | 
| to\_sip\_user | 接收呼叫的用户。 | 
| to\_country | 接收呼叫的国家/地区。 | 
| endpoint\_id | 一个不透明标识符，指明呼叫的其他终端节点。与 CloudWatch 日志见解一起使用。有关更多信息，请参阅 *Amazon 日志用户指南中的使用 CloudWatch 日志见解分析 CloudWatch 日志*[数据](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)。 | 
| aws\_region | 呼叫的 AWS 区域。 | 
| cust2vc\_rtp\_packets | 客户发送到 Amazon Chime SDK 语音连接器基础设施的 RTP 数据包数量。 | 
| cust2vc\_rtp\_bytes | 客户以 RTP 数据包形式发送到 Amazon Chime SDK 语音连接器基础设施的字节数。 | 
| cust2vc\_rtcp\_packets | 客户向 Amazon Chime SDK 语音连接器基础设施发送的 RTCP 数据包数量。 | 
| cust2vc\_rtcp\_bytes | 客户以 RTCP 数据包形式发送到 Amazon Chime SDK 语音连接器基础设施的字节数。 | 
| cust2vc\_packets\_lost | 从客户传输到 Amazon Chime SDK 语音连接器基础设施的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。 | 
| cust2vc\_jitter | 从客户发送到 Amazon Chime SDK 语音连接器基础设施的数据包的平均抖动。 | 
| vc2cust\_rtp\_packets | 从 Amazon Chime SDK 语音连接器基础设施发送给客户的 RTP 数据包数量。 | 
| vc2cust\_rtp\_bytes | 通过 RTP 数据包从 Amazon Chime SDK 语音连接器基础设施发送给客户的字节数。 | 
| vc2cust\_rtcp\_packets | 从 Amazon Chime SDK 语音连接器基础设施发送给客户的 RTCP 数据包数量。 | 
| vc2cust\_rtcp\_bytes | 通过 RTCP 数据包从 Amazon Chime SDK 语音连接器基础设施发送给客户的字节数。 | 
| vc2cust\_packets\_lost | 从 Amazon Chime SDK 语音连接器基础设施传输到客户的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。 | 
| vc2cust\_jitter | 从 Amazon Chime SDK 语音连接器基础设施发送给客户的数据包的平均抖动。 | 
| rtt\_btwn\_vc\_and\_cust | 客户与 Amazon Chime SDK 语音连接器基础设施之间的平均往返时间。 | 
| mos\_btwn\_vc\_and\_cust | 与客户与 Amazon Chime SDK Voice Connector 基础设施之间的语音流相关的估计平均意见分数 (MOS)。 | 
| rem2vc\_rtp\_packets | 从远程端发送到 Amazon Chime SDK 语音连接器基础设施的 RTP 数据包数量。 | 
| rem2vc\_rtp\_bytes | 以 RTP 数据包形式从远程端发送到 Amazon Chime SDK 语音连接器基础设施的字节数。 | 
| rem2vc\_rtcp\_packets | 从远程端发送到 Amazon Chime SDK 语音连接器基础设施的 RTCP 数据包数量。 | 
| rem2vc\_rtcp\_bytes | 在 RTCP 数据包中从远程端发送到 Amazon Chime SDK 语音连接器基础设施的字节数。 | 
| rem2vc\_packets\_lost | 从远程端传输到 Amazon Chime SDK 语音连接器基础设施的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。 | 
| rem2vc\_jitter | 从远程端发送到 Amazon Chime SDK 语音连接器基础设施的数据包的平均抖动。 | 
| vc2rem\_rtp\_packets | 从 Amazon Chime SDK 语音连接器基础设施发送到远程端的 RTP 数据包数量。 | 
| vc2rem\_rtp\_bytes | 通过 RTP 数据包从 Amazon Chime SDK 语音连接器基础设施发送到远程端的字节数。 | 
| vc2rem\_rtcp\_packets | 从 Amazon Chime SDK 语音连接器基础设施发送到远程端的 RTCP 数据包数量。 | 
| vc2rem\_rtcp\_bytes | 在 RTCP 数据包中从 Amazon Chime SDK 语音连接器基础设施发送到远程端的字节数。 | 
| vc2rem\_packets\_lost | 从 Amazon Chime SDK 语音连接器基础设施传输到远程端的过程中丢失的数据包数量。值每分钟发送一次，直到通话结束。值计数是累积的。 | 
| vc2rem\_jitter | 从 Amazon Chime SDK 语音连接器基础设施发送到远程端的数据包的平均抖动。 | 
| rtt\_btwn\_vc\_and\_rem | 远程端和 Amazon Chime SDK 语音连接器基础设施之间的平均往返时间。 | 
| mos\_btwn\_vc\_and\_rem | 与远程端和 Amazon Chime SDK 语音连接器基础设施之间的语音流相关的估计平均意见分数 (MOS)。 | 

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


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