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.

CloudWatch metrics for AWS End User Messaging SMS

The following sections list the metrics and dimensions for AWS End User Messaging SMS.

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.

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	Sum Sample Count Max Min Average Percentile
NumberOfMediaMessagePartsSent	Number of media message parts sent. Excludes messages that are blocked by Protect and service limits like message spend limits	Count	Sum Sample Count Max Min Average Percentile
NumberOfTextMessagePartsDelivered	Number of text message parts delivered to the recipient.	Count	Sum Sample Count Max Min Average Percentile
NumberOfMediaMessagePartsDelivered	Number of media message parts delivered to the recipient.	Count	Sum Sample Count Max Min Average Percentile

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	Sum Sample Count Average
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	Sum Sample Count Average
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	Sum Sample Count Average
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	Sum Sample Count Average

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	Sum Average Sample Count
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	Sum Average Sample Count

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