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

# Monitorando tópicos do Amazon SNS usando CloudWatch
<a name="sns-monitoring-using-cloudwatch"></a>

O Amazon SNS e o Amazon CloudWatch são integrados para que você possa coletar, visualizar e analisar métricas para cada notificação ativa do Amazon SNS. Depois de configurar CloudWatch o Amazon SNS, você pode obter uma melhor visão sobre o desempenho de seus tópicos, notificações push e entregas de SMS do Amazon SNS. Por exemplo, você pode definir um alarme para enviar uma notificação por e-mail se um limite especificado para uma métrica do Amazon SNS for atingido, como `NumberOfNotificationsFailed`. Para obter uma lista de todas as métricas para as quais o Amazon SNS envia CloudWatch, consulte. [Métricas do Amazon SNS](#sns-metrics) Para obter mais informações sobre notificações por push do Amazon SNS, consulte [Enviar notificações por push para dispositivos móveis com o Amazon SNS](sns-mobile-application-as-subscriber.md). 

**nota**  
As métricas que você configura CloudWatch para seus tópicos do Amazon SNS são coletadas e enviadas automaticamente CloudWatch em intervalos de *1* minuto. Essas métricas são reunidas em todos os tópicos que atendem às CloudWatch diretrizes para ser ativo. Um tópico é considerado ativo CloudWatch por até seis horas a partir da última atividade (ou seja, qualquer chamada de API) no tópico.   
Não há cobrança pelas métricas do Amazon SNS relatadas em CloudWatch; elas são fornecidas como parte do serviço Amazon SNS.

## Veja CloudWatch as métricas do Amazon SNS
<a name="view-cloudwatch-metrics"></a>

Você pode monitorar as métricas do Amazon SNS usando o CloudWatch console, a própria interface CloudWatch de linha de comando (CLI) ou usando programaticamente a API. CloudWatch Os procedimentos a seguir mostram como acessar as métricas com o Console de gerenciamento da AWS.

**Para visualizar métricas usando o CloudWatch console**

1. Faça login no [console do CloudWatch](https://console.aws.amazon.com/cloudwatch).

1. No painel de navegação, selecione **Métricas**.

1. Na guia **Todas as métricas**, escolha **SNS** e uma das seguintes dimensões:
   + **País, Tipo de SMS**
   + **PhoneNumber**
   + **Métricas de tópico**
   + **Métricas sem dimensões**

1. Para exibir mais detalhes, escolha um item específico. Por exemplo, se você escolher **Métricas de tópico** e depois escolher **NumberOfMessagesPublished**, o número médio de mensagens publicadas do Amazon SNS por um período de 1 minuto em todo o intervalo de 6 horas será exibido.

1. Para visualizar as métricas de uso do Amazon SNS, na guia **All metrics** (Todas as métricas, escolha **Usage** (Uso) e selecione a **target Amazon SNS usage metric** (métrica-alvo de uso do Amazon SNS) (por exemplo, `NumberOfMessagesPublishedPerAccount`).

## Defina CloudWatch alarmes para as métricas do Amazon SNS
<a name="SNS_AlarmMetrics"></a>

CloudWatch também permite definir alarmes quando um limite é atingido para uma métrica. Por exemplo, você pode definir um alarme para a métrica, **NumberOfNotificationsFailed**, para que, quando o número limite especificado for atingido dentro do período de amostragem, uma notificação por e-mail seja enviada para informá-lo sobre o evento.

**Para definir alarmes usando o console CloudWatch**

1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1.  Selecione **Alarmes** e clique no botão **Criar alarme**. Isso inicia o assistente **Criar alarme**. 

1.  Role pelas métricas do Amazon SNS para localizar aquela em que você deseja colocar um alarme. Selecione a métrica para criar um alarme e escolha **Continue (Continuar)**. 

1. Preencha os valores de **Name** (Nomes), **Description** (Descrição), **Threshold** (Limite) e **Time** (Tempo) para a métrica e escolha **Continue** (Continuar). 

1. Escolha **Alarme** como o estado do alarme. Se você quiser CloudWatch enviar um e-mail quando o estado do alarme for atingido, escolha um tópico existente do Amazon SNS ou escolha **Criar novo tópico de e-mail**. Se você escolher **Create New Email Topic (Criar novo tópico de e-mail)**, poderá definir o nome e os endereços de e-mail para um novo tópico. Esta lista será salva e aparecerá na caixa suspensa para alertas futuros. Escolha **Continuar**. 
**nota**  
Se você escolher **Create New Email Topic** (Criar novo tópico de e-mail) para criar um novo tópico do Amazon SNS, os endereços de e-mail deverão ser verificados para que possam receber notificações. Os e-mails são enviados somente quando o alerta entra em um estado de alerta. Se essa alteração para estado de alerta ocorrer antes que os endereços de e-mail sejam verificados, a notificação não será recebida. 

1. Nesse momento, o assistente **Criar alarme** lhe oferece uma oportunidade para revisar o alarme que você está prestes a criar. Se você precisar fazer alterações, use os links **Editar** à direita. Quando estiver satisfeito, escolha **Criar alarme**. 

Para obter mais informações sobre uso CloudWatch e alarmes, consulte a [CloudWatchdocumentação](https://aws.amazon.com/documentation/cloudwatch).

## Métricas do Amazon SNS
<a name="sns-metrics"></a>

O Amazon SNS envia as seguintes métricas para. CloudWatch


| Namespace | Métrica | Description | 
| --- | --- | --- | 
| AWS/SNS |  NumberOfMessagesPublished  |  O número de mensagens publicadas nos tópicos do Amazon SNS. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma  | 
| AWS/SNS |  NumberOfNotificationsDelivered  |  O número de mensagens entregues com êxito dos tópicos do Amazon SNS para endpoints de assinatura. Para obter uma tentativa de entrega bem-sucedida, o endpoint deve aceitar a assinatura da mensagem. Uma assinatura aceitará uma mensagem se a.) faltar uma política de filtro ou b.) a política de filtro incluir atributos que combinem com os atribuídos à mensagem. Se a assinatura rejeita a mensagem, a tentativa de entrega não é contada para esta métrica. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma  | 
| AWS/SNS |  NumberOfNotificationsFailed  |  O número de mensagens do Amazon SNS com falha na entrega.  Para o Amazon SQS, e-mail, SMS ou endpoints de push para dispositivos móveis, a métrica é incrementada em 1 quando o Amazon SNS para de tentar entregar as mensagens. Para endpoints HTTP ou HTTPS, a métrica inclui cada tentativa de entrega com falha, incluindo novas tentativas que seguem a tentativa inicial. Para todos os outros endpoints, a contagem aumenta em 1 quando a mensagem não é entregue (independentemente do número de tentativas). Essa métrica não inclui mensagens que foram rejeitadas pelo filtro de assinatura políticas. Você pode controlar o número de novas tentativas para endpoints HTTP. Para obter mais informações, consulte [Novas tentativas de entrega de mensagens do Amazon SNS](sns-message-delivery-retries.md). **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média  | 
| AWS/SNS | NumberOfNotificationsFilteredOut |  O número de mensagens que foram rejeitadas pelo filtro de assinatura políticas. Uma política de filtro rejeita uma mensagem quando os atributos de mensagem não correspondem aos atributos de política. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média  | 
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageAttributes | O número de mensagens que foram rejeitadas por políticas de filtro de assinatura para filtragem baseada em atributos. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média  | 
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageBody |  O número de mensagens que foram rejeitadas por políticas de filtro de assinatura para filtragem baseada em carga útil.  **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média  | 
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidAttributes |  O número de mensagens que foram rejeitadas por políticas de filtro de assinatura por conta de atributos de mensagens são inválidos. Por exemplo, devido à formatação incorreta do atributo JSON. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média  | 
| AWS/SNS | NumberOfNotificationsFilteredOut-NoMessageAttributes |  O número de mensagens que foram rejeitadas pelas políticas de filtro de assinatura por conta de as mensagens não terem atributos. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média  | 
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidMessageBody |  O número de mensagens que foram rejeitadas por políticas de filtro de assinatura porque o corpo da mensagem era inválido para filtragem; por exemplo, corpo da mensagem JSON inválido. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média  | 
| AWS/SNS |  NumberOfNotificationsRedrivenToDlq  |  O número de mensagens que foram movidas para uma fila de mensagens mortas. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média | 
| AWS/SNS |  NumberOfNotificationsFailedToRedriveToDlq  |  O número de mensagens que não puderam ser movidas para uma fila de mensagens mortas. **Unidades**: contagem **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** soma, média | 
| AWS/SNS |  PublishSize  |  O tamanho das mensagens publicadas. **Unidade:** bytes **Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName **Estatísticas válidas:** mínimo, máximo, média e contagem  | 
| AWS/SNS | SMSMonthToDateSpentUSD |  As cobranças que você acumulou desde o início do mês atual com o envio de mensagens SMS. Você pode definir um alarme para essa métrica para saber quando suas month-to-date cobranças estão próximas da cota mensal de gastos com SMS da sua conta. Quando o Amazon SNS determina que o envio de uma mensagem SMS pode gerar um custo que excede essa cota, ele interrompe a publicação de mensagens SMS em poucos minutos. Para obter informações sobre como configurar sua cota de gasto mensal de SMS ou para obter informações sobre como solicitar um aumento de cota de gasto com a AWS, consulte [Definir preferências de mensagens SMS no Amazon SNS](sms_preferences.md). **Unidade:** USD **Dimensões válidas:** nenhuma **Estatísticas válidas:** soma  | 
| AWS/SNS |  SMSSuccessRate  |  A taxa de entregas bem-sucedidas de mensagem SMS. **Unidades**: contagem **Dimensões válidas:** PhoneNumber **Estatísticas válidas:** soma, média, amostras de dados  | 

## Dimensões para métricas do Amazon SNS
<a name="sns-metric-dimensions"></a>

O Amazon Simple Notification Service envia as seguintes dimensões para CloudWatch.


|  Dimensão  |  Description  | 
| --- | --- | 
|  Application  |  Filtros em objetos do aplicativo, que representam um aplicativo e um dispositivo registrados em um dos serviços de notificação por push compatíveis, como APNs o FCM.  | 
|  Application,Platform  |  Filtra objetos do aplicativo e da plataforma, onde os objetos da plataforma são para os serviços de notificação push compatíveis, como APNs o FCM.  | 
| Country |  Os filtros no país ou região de destino de uma mensagem SMS. O país ou região é representado por seu código alfa-2 ISO 3166-1.  | 
|  PhoneNumber  |  Filtra pelo número de telefone quando o SMS é publicado diretamente em um número de telefone (sem um tópico).  | 
|  Platform  |  Filtros em objetos da plataforma para os serviços de notificação push, como o APNs FCM.  | 
|  TopicName  |  Filtra pelos nomes dos tópicos do Amazon SNS.  | 
| SMSType |  Os filtros no tipo da mensagem SMS. Podem ser *promocionais* ou *transacionais*.  | 

## Métricas de uso do Amazon SNS
<a name="sns-usage-metrics"></a>

O Amazon Simple Notification Service envia as seguintes métricas de uso para CloudWatch.


|  Namespace  |  Serviço  | Métrica | Recurso | Tipo | Description | 
| --- | --- | --- | --- | --- | --- | 
| AWS/Usage | SNS | ResourceCount | NumberOfMessagesPublishedPerAccount | Recurso |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sns/latest/dg/sns-monitoring-using-cloudwatch.html)  | 
| AWS/Usage | SNS | ResourceCount | ApproximateNumberOfTopics | Recurso |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sns/latest/dg/sns-monitoring-using-cloudwatch.html)  | 
| AWS/Usage | SNS | ResourceCount | ApproximateNumberOfFilterPolicies | Recurso |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sns/latest/dg/sns-monitoring-using-cloudwatch.html)  | 
| AWS/Usage | SNS | ResourceCount | ApproximateNumberOfPendingSubscriptions | Recurso |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sns/latest/dg/sns-monitoring-using-cloudwatch.html)  | 
| AWS/Usage | SNS | CallCount |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sns/latest/dg/sns-monitoring-using-cloudwatch.html)  | solicitações de |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sns/latest/dg/sns-monitoring-using-cloudwatch.html)  |