Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
État de livraison des SNS messages Amazon
Amazon SNS fournit une assistance pour enregistrer l'état de livraison des messages de notification envoyés à des sujets comportant les SNS points de terminaison Amazon suivants :
-
HTTP
-
Amazon Data Firehose
-
AWS Lambda
-
Point de terminaison d’application de plateforme
-
Amazon Simple Queue Service
Une fois que vous avez configuré les attributs d'état de livraison des messages, les entrées du journal sont envoyées aux CloudWatch journaux pour les messages envoyés aux abonnés à la rubrique. La journalisation du statut de distribution du message permet de fournir des informations opérationnelles plus précises, par exemple :
-
Savoir si un message a été envoyé au point de SNS terminaison Amazon.
-
Identification de la réponse envoyée par le point de SNS terminaison Amazon à AmazonSNS.
-
Déterminer le temps d'attente du message (le temps écoulé entre l'horodatage de publication et le moment où il est transféré à un point de terminaison AmazonSNS).
Pour configurer les attributs des rubriques en fonction de l'état de livraison des messages AWS Management Console, vous pouvez utiliser les kits de développement AWS logiciel (SDKs)API, query ou AWS CloudFormation.
Rubriques
- Configuration de le statut de distribution à l'aide de AWS Management Console
- Configuration de l'enregistrement de l'état de livraison à l'aide du AWS SDKs
- AWS SDKexemples de configuration des attributs de rubrique
- Configuration de la journalisation du statut de distribution à l'aide d' AWS CloudFormation
Configuration de le statut de distribution à l'aide de AWS Management Console
Connectez-vous à la SNSconsole Amazon
. -
Dans le panneau de navigation, choisissez Rubriques.
-
Sur la page Rubriques, sélectionnez une rubrique, puis choisissez Modifier.
-
À propos de l'édition
MyTopic
page, développez la section Enregistrement de l'état de livraison. -
Choisissez le protocole pour lequel vous souhaitez enregistrer le statut de distribution, par exemple AWS Lambda.
-
Entrez le taux d'échantillonnage de réussite (le pourcentage de messages réussis pour lesquels vous souhaitez recevoir des CloudWatch journaux).
-
Dans la section IAMRôles, effectuez l'une des opérations suivantes :
-
Pour choisir un rôle de service existant depuis votre compte, choisissez Utiliser un rôle de service existant, puis spécifiez IAM les rôles pour les livraisons réussies et échouées.
-
Pour créer un nouveau rôle de service dans votre compte, choisissez Créer un nouveau rôle de service, choisissez Créer de nouveaux rôles pour définir les IAM rôles pour les livraisons réussies et échouées dans la IAM console.
Pour autoriser Amazon à utiliser CloudWatch Logs en SNS écriture en votre nom, sélectionnez Autoriser.
-
-
Sélectionnez Enregistrer les modifications.
Vous pouvez désormais consulter et analyser les CloudWatch journaux contenant l'état de livraison des messages. Pour plus d'informations sur l'utilisation CloudWatch, consultez la CloudWatchdocumentation
.
Configuration de l'enregistrement de l'état de livraison à l'aide du AWS SDKs
Ils AWS SDKs fournissent APIs en plusieurs langues l'utilisation des attributs de statut de livraison des messages avec AmazonSNS.
Attributs de rubrique
Vous pouvez utiliser les valeurs de nom d'attribut de rubrique suivantes pour le statut de livraison du message :
HTTP
-
HTTPSuccessFeedbackRoleArn
— Indique le statut de livraison du message réussi pour une SNS rubrique Amazon abonnée à un HTTP point de terminaison. -
HTTPSuccessFeedbackSampleRate
— Indique le pourcentage de messages réussis à échantillonner pour une SNS rubrique Amazon abonnée à un HTTP point de terminaison. -
HTTPFailureFeedbackRoleArn
— Indique l'état d'échec de la livraison du message pour une SNS rubrique Amazon abonnée à un HTTP point de terminaison.
Amazon Data Firehose
-
FirehoseSuccessFeedbackRoleArn
— Indique le statut de livraison du message réussi pour une SNS rubrique Amazon abonnée à un point de terminaison Amazon Kinesis Data Firehose. -
FirehoseSuccessFeedbackSampleRate
— Indique le pourcentage de messages réussis à échantillonner pour une SNS rubrique Amazon abonnée à un point de terminaison Amazon Kinesis Data Firehose. -
FirehoseFailureFeedbackRoleArn
— Indique le statut d'échec de livraison du message pour une SNS rubrique Amazon abonnée à un point de terminaison Amazon Kinesis Data Firehose.
AWS Lambda
-
LambdaSuccessFeedbackRoleArn
— Indique l'état de livraison du message réussi pour une SNS rubrique Amazon abonnée à un point de terminaison Lambda. -
LambdaSuccessFeedbackSampleRate
— Indique le pourcentage de messages réussis à échantillonner pour une SNS rubrique Amazon abonnée à un point de terminaison Lambda. -
LambdaFailureFeedbackRoleArn
— Indique le statut d'échec de livraison des messages pour une SNS rubrique Amazon abonnée à un point de terminaison Lambda.
Point de terminaison de l'application de plateforme
-
ApplicationSuccessFeedbackRoleArn
— Indique l'état de livraison du message réussi pour une SNS rubrique Amazon abonnée à un point de terminaison d' AWS application. -
ApplicationSuccessFeedbackSampleRate
— Indique le pourcentage de messages réussis à échantillonner pour une SNS rubrique Amazon abonnée à un point de terminaison d' AWS application. -
ApplicationFailureFeedbackRoleArn
— Indique le statut d'échec de livraison des messages pour une SNS rubrique Amazon abonnée à un point de terminaison d' AWS application.Note
Outre la possibilité de configurer les attributs de rubrique pour l'état de livraison des messages de notification envoyés aux points de terminaison des SNS applications Amazon, vous pouvez également configurer les attributs d'application pour l'état de livraison des messages de notification push envoyés aux services de notification push. Pour plus d'informations, consultez Utilisation des attributs d'SNSapplication Amazon pour le statut de livraison des messages.
Amazon SQS
-
SQSSuccessFeedbackRoleArn
— Indique le statut de livraison du message réussi pour une SNS rubrique Amazon abonnée à un point de SQS terminaison Amazon. -
SQSSuccessFeedbackSampleRate
— Indique le pourcentage de messages réussis à échantillonner pour une SNS rubrique Amazon abonnée à un point de SQS terminaison Amazon. -
SQSFailureFeedbackRoleArn
— Indique le statut d'échec de livraison du message pour une SNS rubrique Amazon abonnée à un point de SQS terminaison Amazon.
Note
Les <ENDPOINT>FailureFeedbackRoleArn
attributs <ENDPOINT>SuccessFeedbackRoleArn
et sont utilisés pour donner à Amazon un accès en SNS écriture lui permettant d'utiliser CloudWatch Logs en votre nom. L'attribut <ENDPOINT>SuccessFeedbackSampleRate
permet de spécifier le pourcentage de la fréquence d’échantillonnage (0-100) des messages diffusés avec succès. Une fois que vous avez configuré l'<ENDPOINT>FailureFeedbackRoleArn
attribut, tous les messages ayant échoué génèrent des CloudWatch journaux.
AWS SDKexemples de configuration des attributs de rubrique
Les exemples de code suivants montrent comment utiliserSetTopicAttributes
.
Configuration de la journalisation du statut de distribution à l'aide d' AWS CloudFormation
Pour configurer DeliveryStatusLogging
l'utilisation AWS CloudFormation, utilisez un YAML modèle JSON ou pour créer une AWS CloudFormation pile. Pour plus d'informations, consultez la DeliveryStatusLogging
propriété de la AWS::SNS::Topic
ressource dans le guide de AWS CloudFormation l'utilisateur. Vous trouverez ci-dessous des exemples de AWS CloudFormation modèles dans JSON et YAML pour créer un nouveau sujet ou mettre à jour un sujet existant avec tous les DeliveryStatusLogging
attributs du SQS protocole Amazon.