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á.

# CloudWatch Métricas e monitoramento do RCS
<a name="rcs-monitoring"></a>

AWS O End User Messaging publica métricas de mensagens RCS CloudWatch no namespace. `AWS/SMSVoice` Você pode usar essas métricas para monitorar a entrega de mensagens RCS, rastrear o comportamento alternativo do RCS para o SMS e definir alarmes para alertá-lo quando os padrões de entrega mudarem. As métricas do RCS são publicadas junto com as métricas existentes de SMS e MMS no mesmo namespace.

**Topics**
+ [Métricas de mensagens RCS](#rcs-monitoring-rcs-metrics)
+ [Métricas existentes modificadas com OriginationIdentityType dimensão](#rcs-monitoring-modified-metrics)
+ [Dimensões métricas do RCS](#rcs-monitoring-dimensions)
+ [Métricas de mensagens RCS de entrada](#rcs-monitoring-inbound)
+ [Melhores práticas de monitoramento para RCS](#rcs-monitoring-best-practices)

## Métricas de mensagens RCS
<a name="rcs-monitoring-rcs-metrics"></a>

O `AWS/SMSVoice` namespace inclui as seguintes métricas específicas para mensagens RCS. Essas métricas rastreiam o envio, a entrega e o retorno de mensagens RCS.


**Métricas de mensagens RCS**  

| Métrica | Description | Unidade | Estatísticas significativas | 
| --- | --- | --- | --- | 
| RCS.MessagesSent |  O número de mensagens RCS enviadas. Essa métrica conta as mensagens que o AWS End User Messaging aceitou e tentou entregar via RCS. As mensagens bloqueadas pelo Protect ou pelos limites do serviço são excluídas dessa contagem.  | Contagem |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/rcs-monitoring.html)  | 
| RCS.MessagesDelivered |  O número de mensagens RCS entregues com sucesso ao dispositivo do destinatário. Uma mensagem é contada como entregue quando o AWS End User Messaging recebe uma confirmação de entrega da infraestrutura do RCS.  | Contagem |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/rcs-monitoring.html)  | 
| RCS.MessagesFallenBackToSMS |  O número de mensagens que foram inicialmente tentadas via RCS, mas voltaram para a entrega por SMS. Essa métrica ajuda você a entender com que frequência a entrega do RCS não está disponível para seus destinatários e pode ser usada para rastrear as taxas de retorno ao longo do tempo.  | Contagem |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/rcs-monitoring.html)  | 

## Métricas existentes modificadas com OriginationIdentityType dimensão
<a name="rcs-monitoring-modified-metrics"></a>

Com a adição do RCS, várias métricas existentes no `AWS/SMSVoice` namespace agora oferecem suporte à dimensão. `OriginationIdentityType` Essa dimensão permite filtrar métricas pelo tipo de identidade de origem usada para enviar a mensagem, incluindo agentes do AWS RCS.

As seguintes métricas existentes agora incluem a `OriginationIdentityType` dimensão:
+ `NumberOfTextMessagePartsSent`— Filtre por tipo de identidade de origem para ver quantas partes da mensagem de texto foram enviadas por cada canal (número de telefone, ID do remetente, AWS RCS Agent ou pool).
+ `NumberOfTextMessagePartsDelivered`— Filtre por tipo de identidade de origem para comparar as taxas de entrega em todos os canais.
+ `NumberOfMediaMessagePartsSent`— Filtre por tipo de identidade de origem para rastrear o envio de mensagens de mídia por canal.
+ `NumberOfMediaMessagePartsDelivered`— Filtre por tipo de identidade de origem para comparar a entrega de mensagens de mídia em todos os canais.
+ `TextMessagesBlockedByProtect`— Filtre por tipo de identidade de origem para ver quais canais têm mensagens bloqueadas pelas regras do Protect.
+ `MediaMessagesBlockedByProtect`— Filtre por tipo de identidade de origem para rastrear o bloqueio do Protect por canal.

Use a `OriginationIdentityType` dimensão com um valor de `RCS_AGENT` para isolar métricas de mensagens enviadas por meio do seu AWS RCS Agent. Para obter mais informações sobre os valores de dimensão disponíveis, consulte[Dimensões métricas do RCS](#rcs-monitoring-dimensions).

## Dimensões métricas do RCS
<a name="rcs-monitoring-dimensions"></a>

Você pode usar as seguintes dimensões para filtrar e agrupar métricas de RCS. Essas dimensões estão disponíveis tanto para as novas métricas específicas do RCS quanto para as métricas existentes modificadas descritas nas seções anteriores.

### OriginationIdentityType dimensão
<a name="rcs-monitoring-dimensions-origination"></a>

A `OriginationIdentityType` dimensão filtra as métricas pelo tipo de identidade de origem usada para enviar a mensagem.


**OriginationIdentityType valores de dimensão**  

| Valor | Description | 
| --- | --- | 
| PHONE\$1NUMBER | Mensagens enviadas usando um número de telefone (código longo, código curto ou número gratuito). | 
| SENDER\$1ID | Mensagens enviadas usando um ID de remetente. | 
| RCS\$1AGENT | Mensagens enviadas usando um AWS RCS Agent. | 
| POOL | Mensagens enviadas usando um pool telefônico. Quando você envia por meio de um pool, o AWS End User Messaging seleciona automaticamente a identidade de origem apropriada (agente do AWS RCS ou número de telefone). | 

### MessageType dimensão
<a name="rcs-monitoring-dimensions-messagetype"></a>

A `MessageType` dimensão filtra as métricas pelo tipo de mensagem.


**MessageType valores de dimensão**  

| Valor | Description | 
| --- | --- | 
| TEXT | Mensagens de texto enviadas via RCS ou SMS. | 
| MEDIA | Mensagens de mídia (MMS). Atualmente, o RCS no AWS End User Messaging suporta somente mensagens de texto. | 
| DELIVERY\$1REPORT | Mensagens do relatório de entrega confirmando o status da entrega da mensagem. | 

**nota**  
O tipo de `READ_REPORT` mensagem não está disponível porque as confirmações de leitura não são suportadas na versão atual do RCS no AWS End User Messaging.

## Métricas de mensagens RCS de entrada
<a name="rcs-monitoring-inbound"></a>

A `NumberOfMessagesReceived` métrica existente no `AWS/SMSVoice` namespace agora inclui mensagens RCS de entrada. Você pode usar a `OriginationIdentityType` dimensão com um valor de `RCS_AGENT` para filtrar as mensagens recebidas por meio do seu AWS RCS Agent.

As seguintes dimensões estão disponíveis para métricas de mensagens RCS de entrada:
+ `OriginationIdentityType`— Use `RCS_AGENT` para filtrar mensagens RCS de entrada.
+ `IsoCountryCode`— Filtrar pelo código do país do remetente da mensagem recebida.
+ `MessageType`— Use `TEXT` para filtrar mensagens de texto recebidas via RCS. Na versão atual, o RCS no AWS End User Messaging suporta somente mensagens de texto de entrada.

## Melhores práticas de monitoramento para RCS
<a name="rcs-monitoring-best-practices"></a>

Use as práticas recomendadas a seguir para monitorar suas operações de mensagens RCS e identificar problemas de entrega com antecedência.

### Acompanhe as taxas de entrega de RCS versus SMS
<a name="rcs-monitoring-bp-delivery-rates"></a>

Compare `RCS.MessagesDelivered` `RCS.MessagesFallenBackToSMS` para entender qual porcentagem de suas mensagens são entregues via RCS versus SMS. Uma alta taxa de retorno pode indicar que muitos de seus destinatários usam operadoras ou dispositivos que não oferecem suporte ao RCS. Use as seguintes fórmulas para calcular as principais taxas:

```
RCS delivery rate = 100 * SUM(RCS.MessagesDelivered) / SUM(RCS.MessagesSent)

SMS fallback rate = 100 * SUM(RCS.MessagesFallenBackToSMS) / SUM(RCS.MessagesSent)
```

Acompanhe essas taxas ao longo do tempo para identificar tendências à medida que o suporte de operadoras e dispositivos para RCS se expande. Uma taxa de retorno decrescente indica que mais destinatários estão recebendo mensagens via RCS.

### Defina CloudWatch alarmes para métricas de RCS
<a name="rcs-monitoring-bp-alarms"></a>

Crie CloudWatch alarmes para alertá-lo quando os padrões de mensagens RCS mudarem inesperadamente. Considere configurar alarmes para as seguintes condições:
+ **Alta taxa de retorno** — Defina um alarme quando `RCS.MessagesFallenBackToSMS` exceder uma porcentagem limite de. `RCS.MessagesSent` Um aumento repentino no fallback pode indicar um problema com seu AWS RCS Agent ou uma interrupção na operadora.
+ Queda da **taxa de entrega** — Defina um alarme quando a proporção de 1 `RCS.MessagesDelivered` a `RCS.MessagesSent` cair abaixo da taxa de entrega esperada.
+ **Volume de mensagens de entrada** — Se você usa mensagens RCS bidirecionais, ative um alarme `NumberOfMessagesReceived` (filtrado por`OriginationIdentityType = RCS_AGENT`) para detectar alterações inesperadas no volume de mensagens recebidas.