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á.
Monitorar tópicos do Amazon SNS usando o CloudWatch
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. Após configurar o CloudWatch para o Amazon SNS, você pode obter mais informações sobre a performance dos tópicos, notificações por 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 envidas pelo Amazon SNS para o CloudWatch, consulte Métricas do Amazon SNS. 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.
nota
As métricas configuradas com o CloudWatch para os tópicos do Amazon SNS são coletadas e enviadas automaticamente ao CloudWatch em intervalos de 1 minuto. Essas métricas são coletadas em todos os tópicos que estejam de acordo com as diretrizes do CloudWatch por estarem ativas. Um tópico é considerado ativo pelo CloudWatch por até seis horas desde a última atividade (ou seja, qualquer chamada de API) no tópico.
Não há cobrança para as métricas do Amazon SNS relatadas no CloudWatch. Elas são fornecidas como parte do serviço Amazon SNS.
Visualizar métricas do CloudWatch relacionadas ao Amazon SNS
Você pode monitorar as métricas do Amazon SNS usando o console do CloudWatch, a própria interface de linha de comando (CLI) do CloudWatch ou de forma programática usando a API do CloudWatch. Os procedimentos a seguir mostram como acessar as métricas com o Console de gerenciamento da AWS.
Como visualizar métricas usando o console do CloudWatch
-
Faça login no console do CloudWatch
. -
No painel de navegação, selecione Métricas.
-
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
-
-
Para exibir mais detalhes, escolha um item específico. Por exemplo, se você escolher Métricas de tópico e NumberOfMessagesPublished, o número médio de mensagens do Amazon SNS publicadas por um período de um minuto ao longo do intervalo de seis horas será exibido.
-
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).
Definir alarmes do CloudWatch para métricas do Amazon SNS
O CloudWatch também permite que você defina alarmes que serão acionados quando o limite de uma métrica for atingido. Por exemplo, você pode definir um alarme para a métrica, NumberOfNotificationsFailed, de modo que, quando o número limite especificado for atendido dentro do período de amostragem, uma notificação será enviada por e-mail para informá-lo sobre o evento.
Para definir alertas usando o console do CloudWatch
-
Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/
. -
Selecione Alarmes e clique no botão Criar alarme. Isso inicia o assistente Criar alarme.
-
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).
-
Preencha os valores de Name (Nomes), Description (Descrição), Threshold (Limite) e Time (Tempo) para a métrica e escolha Continue (Continuar).
-
Escolha Alarme como o estado do alarme. Para que o CloudWatch envie um e-mail quando o estado de alarme for atingido, selecione um tópico existente do Amazon SNS ou escolha Create New Email Topic (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.
-
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 o uso do CloudWatch e dos alarmes, consulte a Documentação do CloudWatch
Métricas do Amazon SNS
O Amazon SNS envia as métricas a seguir ao CloudWatch.
| Namespace | Métrica | Descrição |
|---|---|---|
AWS/SNS |
NumberOfMessagesPublished
|
O número de mensagens publicadas nos tópicos do Amazon SNS. Unidades: contagem Dimensões válidas: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform 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. Unidades: contagem Dimensões válidas: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform 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: Application, PhoneNumber, Platform e TopicName Estatísticas válidas: soma, média |
AWS/SNS |
PublishSize
|
O tamanho das mensagens publicadas. Unidade: bytes Dimensões válidas: Application, PhoneNumber, Platform 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 esta métrica para saber quando seus encargos acumulados do mês atual estão próximos da cota de gasto mensal de 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. 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
O Amazon Simple Notification Service envia as seguintes dimensões ao CloudWatch.
|
Dimensão |
Descrição |
|---|---|
Application
|
Os filtros em objetos da aplicação, que representam uma aplicação e o dispositivo registrado com um dos serviços de notificação por push compatíveis, como as APNs e o FCM. |
Application,Platform
|
Os filtros em objetos da aplicação e da plataforma, em que os objetos da plataforma são destinados aos serviços de notificação por push compatíveis, como as APNs e 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
|
Filtra pelos objetos da plataforma destinados ao serviços de notificação por push, como as APNs e o 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
O Amazon Simple Notification Service envia as seguintes métricas de uso ao CloudWatch.
|
Namespace |
Serviço |
Métrica |
Recurso |
Tipo |
Descrição |
|---|---|---|---|---|---|
| AWS/Usage | SNS | ResourceCount |
NumberOfMessagesPublishedPerAccount |
Recurso |
|
| AWS/Usage | SNS | ResourceCount |
ApproximateNumberOfTopics |
Recurso |
|
| AWS/Usage | SNS | ResourceCount |
ApproximateNumberOfFilterPolicies |
Recurso |
|
| AWS/Usage | SNS | ResourceCount |
ApproximateNumberOfPendingSubscriptions |
Recurso |
|
| AWS/Usage | SNS | CallCount |
|
API |
|
