

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Monitoramento de mensagens SMS para usuários AWS finais com a Amazon CloudWatch
<a name="monitoring-cloudwatch"></a>

Você pode monitorar o SMS de mensagens de usuário AWS final usando CloudWatch, que coleta dados brutos e os processa em métricas legíveis, quase em tempo real. Essas estatísticas são mantidas por 15 meses, de maneira que você possa acessar informações históricas e ter uma perspectiva melhor de como o aplicativo web ou o serviço está se saindo. Você também pode definir alarmes que observam determinados limites e enviam notificações ou realizam ações quando esses limites são atingidos. Para obter mais informações, consulte o [Guia CloudWatch do usuário da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

AWS O End User Messaging SMS usa AWS Identity and Access Management funções [vinculadas ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts) (IAM). Uma função vinculada ao serviço é um tipo exclusivo de função do IAM vinculada diretamente ao SMS de mensagens do usuário AWS final. As funções vinculadas ao serviço são predefinidas pelo AWS End User Messaging SMS e incluem todas as permissões que o serviço exige para ligar para outros AWS serviços em seu nome. Você deve criar uma [função vinculada ao serviço](using-service-linked-roles.md#using-service-linked-roles.title) para que CloudWatch as métricas sejam coletadas.

## CloudWatch métricas para mensagens SMS para usuários AWS finais
<a name="cw-metrics"></a>

As seções a seguir listam as métricas e dimensões do SMS de mensagens para o usuário AWS final.

**Importante**  
Você deve criar uma [função vinculada ao serviço](using-service-linked-roles.md#using-service-linked-roles.title) para que CloudWatch as métricas sejam coletadas.

**nota**  
Para algumas métricas, o resultado pode ser aproximado devido à natureza distribuída do serviço. Na maioria dos casos, a contagem deve ser próxima do número real de mensagens processadas.

Para SMS de mensagens para o usuário AWS final **TextMessageMonthlySpend**, talvez você queira observar **MediaMessageMonthlySpend**VoiceMessageMonthlySpend****e acionar um alarme quando maior, maior ou igual ou igual ao limite. O namespace para SMS de mensagens de usuário AWS final é. `AWS/SMSVoice`

AWS O End User Messaging SMS também publica métricas específicas de RCS no `AWS/SMSVoice` namespace, incluindo, e. `RCS.MessagesSent` `RCS.MessagesDelivered` `RCS.MessagesFallenBackToSMS` As métricas existentes agora incluem uma `OriginationIdentityType` dimensão com valores como `PHONE_NUMBER` `SENDER_ID``RCS_AGENT`,, `POOL` e. Para obter a lista completa de métricas e dimensões do RCS, consulte[CloudWatch Métricas e monitoramento do RCS](rcs-monitoring.md).

**Topics**
+ [Métricas do agente de mensagens](#cw-metrics-message-spend)
+ [Métricas de entrega de mensagens](#cw-metrics-message-delivery)
+ [Métricas do agente de mensagens](#cw-metrics-message-conversion)
+ [Métricas de proteção](#filter-and-monitor-messages-metrics)
+ [Dimensões](#cw-metrics-message-dimensions)

### Métricas do agente de mensagens
<a name="cw-metrics-message-spend"></a>


**Métricas do agente de mensagens**  

| Métrica | Description | Unidade |  Estatísticas significativas  | 
| --- | --- | --- | --- | 
|  TextMessageMonthlySpend | O valor (em dólares americanos) que você gastou enviando mensagens SMS neste mês.  | Unidades: dólares norte-americanos | Máximo | 
| VoiceMessageMonthlySpend | O valor em (dólares americanos) que você gastou enviando mensagens de voz neste mês. | Unidades: dólares norte-americanos | Máximo | 
| MediaMessageMonthlySpend | O valor (em dólares americanos) que você gastou enviando mensagens MMS neste mês. | Unidades: dólares norte-americanos | Máximo | 

### Métricas de entrega de mensagens
<a name="cw-metrics-message-delivery"></a>

O namespace `AWS/SMSVoice` inclui as seguintes métricas de entrega de mensagens.


**Métricas de entrega de mensagens**  

| Métrica | Description | Unidade | Estatísticas significativas | 
| --- | --- | --- | --- | 
| NumberOfTextMessagePartsSent | Número de partes da mensagem de texto enviadas. Exclui mensagens bloqueadas pelo Protect e limites de serviço, como limites de gasto de mensagens | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| **NumberOfMediaMessagePartsSent** | Número de partes de mensagens de mídia enviadas. Exclui mensagens bloqueadas pelo Protect e limites de serviço, como limites de gasto de mensagens | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfTextMessagePartsDelivered | Número de partes da mensagem de texto entregue ao destinatário. | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagePartsDelivered | Número de partes da mensagem de mídia entregues ao destinatário. | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

**Recibos de entrega duplicados para mensagens com várias partes**  
Quando uma mensagem é dividida em várias partes, a infraestrutura da operadora pode retornar mais de uma confirmação de entrega para a mesma mensagem. As **NumberOfMediaMessagePartsDelivered**métricas **NumberOfTextMessagePartsDelivered**e registram cada recibo de entrega recebido, o que significa que a contagem de entregas pode ocasionalmente exceder a contagem enviada para uma determinada mensagem. Cada mensagem é enviada e entregue somente uma vez — o destinatário não recebe duplicatas. Os eventos de entrega extras são recibos de entrega duplicados, não envios duplicados.  
Não há impacto no faturamento. Você é cobrado uma vez por parte da mensagem enviada, independentemente de quantos recibos de entrega sejam registrados.  
Se seu aplicativo contabilizar eventos de entrega para reconciliação, recomendamos a desduplicação no ID da mensagem.

### Métricas de feedback de mensagens
<a name="cw-metrics-message-conversion"></a>

O namespace `AWS/SMSVoice` inclui as seguintes métricas de feedback de mensagens.


**Métricas de feedback de mensagens**  

| Métrica | Description | Unidade | Estatísticas significativas | 
| --- | --- | --- | --- | 
| NumberOfTextMessagesExpectingFeedback | O número total de mensagens de texto para as quais o feedback é rastreado.<br />**NumberOfTextMessagesExpectingFeedback**terá um valor de 1 para cada `SendTextMessage` solicitação MessageFeedbackEnabled ativada.  | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagesExpectingFeedback | O número total de mensagens de mídia para as quais o feedback é rastreado.<br />**NumberOfMediaMessagesExpectingFeedback**terá um valor de 1 para cada `SendMediaMessage` solicitação MessageFeedbackEnabled ativada. | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfTextMessagesWithFeedback | O número total de mensagens de texto para as quais o feedback foi rastreado e uma resposta de feedback foi recebida.<br />**NumberOfTextMessagesWithFeedback**terá um valor de 1 para cada mensagem que receber um feedback. A porcentagem de mensagens com feedback pode ser determinada por `100 * SUM(NumberOfTextMessagesWithFeedback) / SUM(NumberOfTextMessagesExpectingFeedback)` | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| NumberOfMediaMessagesWithFeedback | O número total de mensagens de mídia para as quais o feedback foi rastreado e uma resposta de feedback foi recebida.<br />**NumberOfMediaMessagesWithFeedback**terá um valor de 1 para cada mensagem que receber um feedback. A porcentagem de mensagens com feedback pode ser determinada por `100 * SUM(NumberOfMediaMessagesWithFeedback) / SUM(NumberOfMediaMessagesExpectingFeedback)` | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

### Proteja as métricas nas mensagens SMS do usuário AWS final
<a name="filter-and-monitor-messages-metrics"></a>

O namespace `AWS/SMSVoice` inclui as seguintes métricas de proteção.


****  

| Nome da métrica | Description | Unidade | Estatísticas significativas | 
| --- | --- | --- | --- | 
| TextMessagesBlockedByProtect | Número de mensagens de texto bloqueadas devido às regras de bloqueio do modo país. <br />**TextMessagesBlockedByProtect**terá um valor de 1 se a mensagem for bloqueada pelo protect e 0 se a mensagem não estiver bloqueada. <br />A porcentagem de mensagens SMS bloqueadas pelo Protect pode ser determinada por `100 * AVG(TextMessagesBlockedByProtect)`. | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 
| MediaMessagesBlockedByProtect | Número de mensagens de mídia bloqueadas devido às regras de bloqueio do modo país.<br />**MediaMessagesBlockedByProtect**terá um valor de 1 se a mensagem for bloqueada pelo protect e 0 se a mensagem não estiver bloqueada. <br />A porcentagem de mensagens MMS bloqueadas pelo Protect pode ser determinada por `100 * AVG(MediaMessagesBlockedByProtect)`. | Contagem |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/monitoring-cloudwatch.html)  | 

### Dimensões
<a name="cw-metrics-message-dimensions"></a>

É possível usar as seguintes dimensões para refinar as métricas listadas nas tabelas anteriores. Essas dimensões permitem filtrar e agrupar as métricas com base em atributos específicos de suas mensagens SMS e de voz.


****  

| Dimensão | Descrição | 
| --- | --- | 
| Nenhum | Não filtrar | 
| IsoCountryCode | Essa dimensão filtra os dados que você solicita pelo código do país ISO | 
| MessageFeedbackStatus | Essa dimensão filtra os dados que você solicita pelo status de feedback da mensagem de RECEIVED ou FAILED | 
| ProtectConfigurationId | Essa dimensão filtra os dados que você solicita por meio da configuração de proteção. | 
| [IsoCountryCode, MessageFeedbackStatus] | Esta dimensão filtra os dados solicitados por código ISO do país e status de feedback da mensagem. | 
| [ProtectConfigurationId, IsoCountryCode] | Esta dimensão filtra os dados solicitados por configuração de proteção e código ISO do país. | 
| OriginationIdentityType | Essa dimensão filtra os dados que você solicita por tipo de identidade de origem. Os valores incluem PHONE\_NUMBER SENDER\_IDRCS\_AGENT,, POOL e. Para obter mais informações, consulte [CloudWatch Métricas e monitoramento do RCS](rcs-monitoring.md). | 