# Monitoring AWS End User Messaging SMS with Amazon CloudWatch
You can monitor AWS End User Messaging SMS using CloudWatch, which collects raw data and processes it into readable, near real-time metrics. These statistics are kept for 15 months, so that you can access historical information and gain a better perspective on how your web application or service is performing. You can also set alarms that watch for certain thresholds, and send notifications or take actions when those thresholds are met. For more information, see the [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
AWS End User Messaging SMS uses AWS Identity and Access Management (IAM) [service-linked roles](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts). A service-linked role is a unique type of IAM role that is linked directly to AWS End User Messaging SMS. Service-linked roles are predefined by AWS End User Messaging SMS and include all the permissions that the service requires to call other AWS services on your behalf. You must create a [service-linked role](using-service-linked-roles.md#using-service-linked-roles.title) for CloudWatch metrics to be collected.
## CloudWatch metrics for AWS End User Messaging SMS
The following sections list the metrics and dimensions for AWS End User Messaging SMS.
**Important**
You must create a [service-linked role](using-service-linked-roles.md#using-service-linked-roles.title) for CloudWatch metrics to be collected.
**Note**
For some metrics, the result may be approximate due to the distributed nature of the service. In most cases, the count should be close to the actual number of messages processed.
For AWS End User Messaging SMS, you might want to watch for **TextMessageMonthlySpend**, **MediaMessageMonthlySpend** and **VoiceMessageMonthlySpend** and trigger an alarm when greater than, greater than or equal to, or equal to the threshold. The namespace for AWS End User Messaging SMS is `AWS/SMSVoice`.
AWS End User Messaging SMS also publishes RCS-specific metrics in the `AWS/SMSVoice` namespace, including `RCS.MessagesSent`, `RCS.MessagesDelivered`, and `RCS.MessagesFallenBackToSMS`. Existing metrics now include an `OriginationIdentityType` dimension with values such as `PHONE_NUMBER`, `SENDER_ID`, `RCS_AGENT`, and `POOL`. For the full list of RCS metrics and dimensions, see [RCS CloudWatch metrics and monitoring](rcs-monitoring.md).
**Topics**
+ [Message spend metrics](#cw-metrics-message-spend)
+ [Message delivery metrics](#cw-metrics-message-delivery)
+ [Message conversion metrics](#cw-metrics-message-conversion)
+ [Protect metrics](#filter-and-monitor-messages-metrics)
+ [Dimensions](#cw-metrics-message-dimensions)
### Message spend metrics
**Message spend metrics**
| Metric | Description | Unit | Meaningful statistics |
| --- | --- | --- | --- |
| TextMessageMonthlySpend | The amount of money (in US Dollars) that you have spent sending SMS messages this month. | US Dollars | Maximum |
| VoiceMessageMonthlySpend | The amount of money (in US Dollars) that you have spent sending Voice messages this month. | US Dollars | Maximum |
| MediaMessageMonthlySpend | The amount of money (in US Dollars) that you have spent sending MMS messages this month. | US Dollars | Maximum |
### Message delivery metrics
The `AWS/SMSVoice` namespace includes the following message delivery metrics.
**Message delivery metrics**
| Metric | Description | Unit | Meaningful statistics |
| --- | --- | --- | --- |
| NumberOfTextMessagePartsSent | Number of text message parts sent. Excludes messages that are blocked by Protect and service limits like message spend limits | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
| **NumberOfMediaMessagePartsSent** | Number of media message parts sent. Excludes messages that are blocked by Protect and service limits like message spend limits | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
| NumberOfTextMessagePartsDelivered | Number of text message parts delivered to the recipient. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
| NumberOfMediaMessagePartsDelivered | Number of media message parts delivered to the recipient. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
**Duplicate delivery receipts for multi-part messages**
When a message is split into multiple parts, the carrier infrastructure may return more than one delivery confirmation for the same message. The **NumberOfTextMessagePartsDelivered** and **NumberOfMediaMessagePartsDelivered** metrics record each delivery receipt received, which means the delivered count can occasionally exceed the sent count for a given message. Each message is sent and delivered only once—the recipient does not receive duplicates. The extra delivery events are duplicate delivery receipts, not duplicate sends.
There is no billing impact. You are charged once per message part sent, regardless of how many delivery receipts are recorded.
If your application counts delivery events for reconciliation, we recommend deduplicating on the message ID.
### Message feedback metrics
The `AWS/SMSVoice` namespace includes the following message feedback metrics.
**Message feedback metrics**
| Metric | Description | Unit | Meaningful statistics |
| --- | --- | --- | --- |
| NumberOfTextMessagesExpectingFeedback | The total number of text messages for which feedback is tracked. **NumberOfTextMessagesExpectingFeedback** will have a value of 1 for each `SendTextMessage` request with MessageFeedbackEnabled enabled. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
| NumberOfMediaMessagesExpectingFeedback | The total number of media messages for which feedback is tracked.**NumberOfMediaMessagesExpectingFeedback** will have a value of 1 for each `SendMediaMessage` request with MessageFeedbackEnabled enabled. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
| NumberOfTextMessagesWithFeedback | The total number of text messages for which feedback was tracked and a feedback response was received.**NumberOfTextMessagesWithFeedback** will have a value of 1 for each message that receives a feedback. Percentage of messages with feedback can be determined by `100 * SUM(NumberOfTextMessagesWithFeedback) / SUM(NumberOfTextMessagesExpectingFeedback)` | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
| NumberOfMediaMessagesWithFeedback | The total number of media messages for which feedback was tracked and a feedback response was received.**NumberOfMediaMessagesWithFeedback** will have a value of 1 for each message that receives a feedback. Percentage of messages with feedback can be determined by `100 * SUM(NumberOfMediaMessagesWithFeedback) / SUM(NumberOfMediaMessagesExpectingFeedback)` | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
### Protect metrics in AWS End User Messaging SMS
The `AWS/SMSVoice` namespace includes the following Protect metrics.
****
| Metric name | Description | Unit | Meaningful Statistics |
| --- | --- | --- | --- |
| TextMessagesBlockedByProtect | Number of text messages blocked due to country mode block rules. **TextMessagesBlockedByProtect** will have a value of 1 if the message is blocked by protect and 0 if the message is not blocked. The percentage of SMS messages blocked by Protect can be determined by `100 * AVG(TextMessagesBlockedByProtect)`. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
| MediaMessagesBlockedByProtect | Number of media messages blocked due to country mode block rules. **MediaMessagesBlockedByProtect** will have a value of 1 if the message is blocked by protect and 0 if the message is not blocked. The percentage of MMS messages blocked by Protect can be determined by `100 * AVG(MediaMessagesBlockedByProtect)`. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sms-voice/latest/userguide/monitoring-cloudwatch.html) |
### Dimensions
You can use the following dimensions to refine the metrics listed in the previous tables. These dimensions allow you to filter and group the metrics based on specific attributes of your SMS and voice messages.
****
| Dimension | Description |
| --- | --- |
| None | Do not filter |
| IsoCountryCode | This dimension filters the data you request by ISO country code |
| MessageFeedbackStatus | This dimension filters the data you request by the message feedback status of RECEIVED or FAILED |
| ProtectConfigurationId | This dimension filters the data you request by protect configuration |
| [IsoCountryCode, MessageFeedbackStatus] | This dimension filters the data you request by ISO country code and message feedback status |
| [ProtectConfigurationId, IsoCountryCode] | This dimension filters the data you request by protect configuration and ISO country code |
| OriginationIdentityType | This dimension filters the data you request by origination identity type. Values include PHONE\$1NUMBER, SENDER\$1ID, RCS\$1AGENT, and POOL. For more information, see [RCS CloudWatch metrics and monitoring](rcs-monitoring.md). |