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

# 使用 Amazon 监控 AWS 最终用户消息短信 CloudWatch
<a name="monitoring-cloudwatch"></a>

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

AWS 最终用户消息 SMS 使用 AWS Identity and Access Management (IAM) [服务相关角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts)。服务相关角色是一种独特的 IAM 角色，直接链接到 AWS 最终用户消息 SMS。服务相关角色由 AWS 最终用户消息 SMS 预定义，包括该服务代表您调用其他 AWS 服务所需的所有权限。您必须为要收集的 CloudWatch 指标创建[服务相关角色](using-service-linked-roles.md#using-service-linked-roles.title)。

## CloudWatch AWS 最终用户消息 SMS 的指标
<a name="cw-metrics"></a>

以下各节列出了 AWS 最终用户消息 SMS 的指标和维度。

**重要**  
您必须为要收集的 CloudWatch 指标创建[服务相关角色](using-service-linked-roles.md#using-service-linked-roles.title)。

**注意**  
对于部分指标，由于服务的分布式特性，结果可能是近似值。在大多数情况下，该计数应接近实际处理的消息数量。

对于 AWS 最终用户消息短信，您可能需要注意**MediaMessageMonthlySpend**VoiceMessageMonthlySpend****并在大于**TextMessageMonthlySpend**、大于或等于或等于阈值时触发警报。 AWS 最终用户消息 SMS 的命名空间是`AWS/SMSVoice`。

AWS 最终用户消息 SMS 还会在`AWS/SMSVoice`命名空间中发布特定于 RCS 的指标，包括`RCS.MessagesSent`、`RCS.MessagesDelivered`和。`RCS.MessagesFallenBackToSMS`现有指标现在包括一个带有`PHONE_NUMBER`、`SENDER_ID``RCS_AGENT`、和等值的`OriginationIdentityType`维度`POOL`。有关 RCS 指标和维度的完整列表，请参阅[RCS CloudWatch 指标和监控](rcs-monitoring.md)。

**Topics**
+ [消息支出指标](#cw-metrics-message-spend)
+ [消息送达指标](#cw-metrics-message-delivery)
+ [消息转化指标](#cw-metrics-message-conversion)
+ [Protect 指标](#filter-and-monitor-messages-metrics)
+ [Dimensions](#cw-metrics-message-dimensions)

### 消息支出指标
<a name="cw-metrics-message-spend"></a>


**消息支出指标**  

| 指标 | 说明 | 单位 |  有意义的统计数据  | 
| --- | --- | --- | --- | 
|  TextMessageMonthlySpend | 本月发送短信所花费的金额（以美元为单位）。 | 美元 | 最大值 | 
| VoiceMessageMonthlySpend | 本月发送语音消息所花费的金额（以美元为单位）。 | 美元 | 最大值 | 
| MediaMessageMonthlySpend | 本月发送彩信所花费的金额（以美元为单位）。 | 美元 | 最大值 | 

### 消息送达指标
<a name="cw-metrics-message-delivery"></a>

`AWS/SMSVoice` 命名空间包括以下消息送达指标。


**消息送达指标**  

| 指标 | 说明 | 单位 | 有意义的统计数据 | 
| --- | --- | --- | --- | 
| NumberOfTextMessagePartsSent | 发送的文本消息部分数量。不包括被 Protect 功能和服务限制（如消息支出限额）所阻止的消息 | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| **NumberOfMediaMessagePartsSent** | 发送的媒体消息部分数量。不包括被 Protect 功能和服务限制（如消息支出限额）所阻止的消息 | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfTextMessagePartsDelivered | 已送达收件人的文本消息部分数量。 | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagePartsDelivered | 已送达收件人的媒体消息部分数量。 | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

**多部分消息的重复传送回执**  
当一条消息被分成多个部分时，运营商基础设施可能会为同一条消息返回多个送达确认。**NumberOfTextMessagePartsDelivered**和**NumberOfMediaMessagePartsDelivered**指标记录收到的每份送达收据，这意味着送达的数量偶尔会超过给定消息的已发送数量。每封邮件只发送和传送一次，收件人不会收到重复的消息。额外的配送事件是重复的配送收据，而不是重复的发送。  
对账单没有影响。无论记录了多少个送达回执，您都要为发送的每个消息部分收取一次费用。  
如果您的应用程序将配送事件计入对账中，我们建议对消息 ID 进行重复数据删除。

### 消息反馈指标
<a name="cw-metrics-message-conversion"></a>

`AWS/SMSVoice` 命名空间包括以下消息反馈指标。


**消息反馈指标**  

| 指标 | 说明 | 单位 | 有意义的统计数据 | 
| --- | --- | --- | --- | 
| NumberOfTextMessagesExpectingFeedback | 系统正在跟踪反馈的短信总数。<br />**NumberOfTextMessagesExpectingFeedback** MessageFeedbackEnabled 启用后，每个`SendTextMessage`请求的值都将为 1。 | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagesExpectingFeedback | 系统正在跟踪反馈的媒体消息总数。<br />**NumberOfMediaMessagesExpectingFeedback** MessageFeedbackEnabled启用后，每个`SendMediaMessage`请求的值都将为 1。 | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfTextMessagesWithFeedback | 系统已跟踪并收到反馈响应的短信总数。<br />**NumberOfTextMessagesWithFeedback**每条收到反馈的消息的值都将为 1。收到反馈的消息百分比可通过以下公式计算：`100 * SUM(NumberOfTextMessagesWithFeedback) / SUM(NumberOfTextMessagesExpectingFeedback)` | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagesWithFeedback | 系统已跟踪并收到反馈响应的媒体消息总数。<br />**NumberOfMediaMessagesWithFeedback**每条收到反馈的消息的值都将为 1。收到反馈的消息百分比可通过以下公式计算：`100 * SUM(NumberOfMediaMessagesWithFeedback) / SUM(NumberOfMediaMessagesExpectingFeedback)` | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

### 保护 AWS 最终用户消息 SMS 中的指标
<a name="filter-and-monitor-messages-metrics"></a>

`AWS/SMSVoice` 命名空间包括以下 Protect 指标。


****  

| 指标名称 | 说明 | 单位 | 有意义的统计数据 | 
| --- | --- | --- | --- | 
| TextMessagesBlockedByProtect | 由于国家/地区模式阻止规则而被拦截的短信数量。<br />**TextMessagesBlockedByProtect**如果邮件被 protect 阻止，则值为 1；如果邮件未被阻止，则值为 0。<br />被 Protect 拦截的短信百分比可通过以下公式计算：`100 * AVG(TextMessagesBlockedByProtect)`。 | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| MediaMessagesBlockedByProtect | 由于国家/地区模式阻止规则而被拦截的媒体消息数量。<br />**MediaMessagesBlockedByProtect**如果邮件被 protect 阻止，则值为 1；如果邮件未被阻止，则值为 0。<br />被 Protect 拦截的彩信百分比可通过以下公式计算：`100 * AVG(MediaMessagesBlockedByProtect)`。 | 计数 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

### Dimensions
<a name="cw-metrics-message-dimensions"></a>

您可以使用以下维度来优化上表中列出的指标。这些维度允许您根据短信和语音消息的特定属性对指标进行筛选和分组。


****  

| 维度 | 描述 | 
| --- | --- | 
| 无 | 不进行筛选 | 
| IsoCountryCode | 此维度按 ISO 国家/地区代码筛选您请求的数据 | 
| MessageFeedbackStatus | 此维度按消息反馈状态（RECEIVED 或 FAILED）筛选您请求的数据 | 
| ProtectConfigurationId | 此维度按保护配置筛选您请求的数据 | 
| [IsoCountryCode, MessageFeedbackStatus] | 此维度按 ISO 国家/地区代码和消息反馈状态组合筛选您请求的数据 | 
| [ProtectConfigurationId, IsoCountryCode] | 此维度按保护配置和 ISO 国家/地区代码组合筛选您请求的数据 | 
| OriginationIdentityType | 此维度按来源身份类型筛选您请求的数据。值包括PHONE\_NUMBERSENDER\_ID、RCS\_AGENT、和POOL。有关更多信息，请参阅 [RCS CloudWatch 指标和监控](rcs-monitoring.md)。 |