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á.
Status de entrega de SNS mensagens da Amazon
SNSA Amazon fornece suporte para registrar o status de entrega das mensagens de notificação enviadas aos tópicos com os seguintes SNS endpoints da Amazon:
-
HTTP
-
Amazon Data Firehose
-
AWS Lambda
-
Endpoint da aplicação da plataforma
-
Amazon Simple Queue Service
Depois de configurar os atributos do status de entrega da mensagem, as entradas de registro são enviadas ao CloudWatch Logs para mensagens enviadas aos assinantes do tópico. O registro de status de entrega de mensagens proporciona um melhor insight operacional, por exemplo:
-
Saber se uma mensagem foi entregue ao SNS endpoint da Amazon.
-
Identificar a resposta enviada do SNS endpoint da Amazon para a AmazonSNS.
-
Determinar o tempo de permanência da mensagem (o tempo entre a data e hora de publicação e pouco antes da entrega para um endpoint da Amazon). SNS
Para configurar os atributos do tópico para o status de entrega da mensagem AWS Management Console, você pode usar os kits de desenvolvimento de AWS software (SDKs)API, query ou AWS CloudFormation.
Tópicos
Configurar registro em log do status de entrega usando o AWS Management Console
Faça login no SNSconsole da Amazon
. -
No painel de navegação, escolha Topics (Tópicos).
-
Na página Topics (Tópicos), escolha um tópico e selecione Edit (Editar).
-
Na edição
MyTopic
página, expanda a seção Registro do status de entrega. -
Escolha o protocolo para os quais você deseja registrar em log o status de entrega, por exemplo, AWS Lambda.
-
Insira a taxa de amostragem de sucesso (a porcentagem de mensagens bem-sucedidas das quais você deseja receber CloudWatch registros).
-
Na seção IAMFunções, faça o seguinte:
-
Para escolher uma função de serviço existente em sua conta, escolha Usar função de serviço existente e, em seguida, especifique as IAM funções para entregas bem-sucedidas e malsucedidas.
-
Para criar uma nova função de serviço em sua conta, escolha Criar nova função de serviço, escolha Criar novas funções para definir as IAM funções para entregas bem-sucedidas e malsucedidas no IAM console.
Para dar à Amazon acesso de SNS gravação para usar o CloudWatch Logs em seu nome, escolha Permitir.
-
-
Escolha Salvar alterações.
Agora você pode visualizar e analisar os CloudWatch registros que contêm o status de entrega da mensagem. Para obter mais informações sobre o uso CloudWatch, consulte a CloudWatchdocumentação
.
Configurando o registro do status de entrega usando o AWS SDKs
Eles AWS SDKs fornecem APIs em vários idiomas o uso de atributos de status de entrega de mensagens com a AmazonSNS.
Atributos de tópicos
Você pode usar os seguintes valores de nome de atributo de tópico para o status de entrega de mensagens:
HTTP
-
HTTPSuccessFeedbackRoleArn
— Indica o status de entrega bem-sucedida da mensagem para um SNS tópico da Amazon que está inscrito em um HTTP endpoint. -
HTTPSuccessFeedbackSampleRate
— Indica a porcentagem de mensagens bem-sucedidas para amostra de um SNS tópico da Amazon que está inscrito em um HTTP endpoint. -
HTTPFailureFeedbackRoleArn
— Indica o status de falha na entrega de mensagens para um SNS tópico da Amazon que está inscrito em um HTTP endpoint.
Amazon Data Firehose
-
FirehoseSuccessFeedbackRoleArn
— Indica o status de entrega de mensagem bem-sucedida para um SNS tópico da Amazon que está inscrito em um endpoint do Amazon Kinesis Data Firehose. -
FirehoseSuccessFeedbackSampleRate
— Indica a porcentagem de mensagens bem-sucedidas para amostra de um SNS tópico da Amazon que está inscrito em um endpoint do Amazon Kinesis Data Firehose. -
FirehoseFailureFeedbackRoleArn
— Indica o status de falha na entrega de mensagens para um SNS tópico da Amazon que está inscrito em um endpoint do Amazon Kinesis Data Firehose.
AWS Lambda
-
LambdaSuccessFeedbackRoleArn
— Indica o status de entrega de mensagem bem-sucedida para um SNS tópico da Amazon que está inscrito em um endpoint Lambda. -
LambdaSuccessFeedbackSampleRate
— Indica a porcentagem de mensagens bem-sucedidas para amostra de um SNS tópico da Amazon que está inscrito em um endpoint Lambda. -
LambdaFailureFeedbackRoleArn
— Indica o status de falha na entrega de mensagens para um SNS tópico da Amazon que está inscrito em um endpoint Lambda.
Endpoint da aplicação da plataforma
-
ApplicationSuccessFeedbackRoleArn
— Indica o status de entrega de mensagem bem-sucedida para um SNS tópico da Amazon que está inscrito em um endpoint AWS do aplicativo. -
ApplicationSuccessFeedbackSampleRate
— Indica a porcentagem de mensagens bem-sucedidas para amostra de um SNS tópico da Amazon que está inscrito em um endpoint de AWS aplicativo. -
ApplicationFailureFeedbackRoleArn
— Indica o status de falha na entrega de mensagens para um SNS tópico da Amazon que está inscrito em um endpoint AWS do aplicativo.nota
Além de poder configurar atributos de tópicos para o status de entrega de mensagens de notificação enviadas aos endpoints de SNS aplicativos da Amazon, você também pode configurar atributos do aplicativo para o status de entrega de mensagens de notificação push enviadas aos serviços de notificação push. Para obter mais informações, consulte Usando os atributos do SNS aplicativo Amazon para o status de entrega de mensagens.
Amazon SQS
-
SQSSuccessFeedbackRoleArn
— Indica o status de entrega de mensagem bem-sucedida para um SNS tópico da Amazon que está inscrito em um SQS endpoint da Amazon. -
SQSSuccessFeedbackSampleRate
— Indica a porcentagem de mensagens bem-sucedidas para amostra de um SNS tópico da Amazon que está inscrito em um SQS endpoint da Amazon. -
SQSFailureFeedbackRoleArn
— Indica o status de falha na entrega de mensagens para um SNS tópico da Amazon que está inscrito em um SQS endpoint da Amazon.
nota
Os <ENDPOINT>FailureFeedbackRoleArn
atributos <ENDPOINT>SuccessFeedbackRoleArn
e são usados para dar à Amazon acesso de SNS gravação para usar CloudWatch Logs em seu nome. O atributo <ENDPOINT>SuccessFeedbackSampleRate
é para especificar a porcentagem de taxa de amostra (0-100) de mensagens bem-sucedidas. Depois de configurar o <ENDPOINT>FailureFeedbackRoleArn
atributo, todas as entregas de mensagens com falha geram CloudWatch registros.
AWS SDKexemplos para configurar atributos de tópicos
Os exemplos de códigos a seguir mostram como usar SetTopicAttributes
.
Configurar registro em log do status de entrega usando o AWS CloudFormation
Para configurar DeliveryStatusLogging
usando AWS CloudFormation, use um YAML modelo JSON ou para criar uma AWS CloudFormation pilha. Para obter mais informações, consulte a DeliveryStatusLogging
propriedade do AWS::SNS::Topic
recurso no Guia do AWS CloudFormation usuário. Abaixo estão exemplos de AWS CloudFormation modelos YAML para criar um novo tópico ou atualizar um tópico existente com todos os DeliveryStatusLogging
atributos do SQS protocolo da Amazon. JSON