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 tempo 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.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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.<br />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.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**Estatísticas válidas:** soma | 
| AWS/SNS |  NumberOfNotificationsFailed  | O número de mensagens do Amazon SNS com falha na entrega. <br />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).<br />Essa métrica não inclui mensagens que foram rejeitadas pelo filtro de assinatura políticas.<br />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).<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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. <br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**Estatísticas válidas:** soma, média | 
| AWS/SNS |  NumberOfNotificationsRedrivenToDlq  | O número de mensagens que foram movidas para uma fila de mensagens mortas.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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.<br />**Unidades**: contagem<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**Estatísticas válidas:** soma, média | 
| AWS/SNS |  PublishSize  | O tamanho das mensagens publicadas. Para chamadas de `PublishBatch` API, essa métrica relata o tamanho total do lote inteiro como um único ponto de dados, não tamanhos de mensagens individuais.<br />**Unidades:** bytes<br />**Dimensões válidas:** aplicativo PhoneNumber, plataforma e TopicName<br />**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.<br />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.<br />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).<br />**Unidade:** USD<br />**Dimensões válidas:** nenhuma<br />**Estatísticas válidas:** soma | 
| AWS/SNS |  SMSSuccessRate  | A taxa de entregas bem-sucedidas de mensagem SMS.<br />**Unidades**: contagem<br />**Dimensões válidas:** PhoneNumber<br />**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)  |