Amazon SNS et AWS X-Ray

Vous pouvez utiliser AWS X-Ray Amazon Simple Notification Service (Amazon SNS) pour suivre et analyser les demandes au fur et à mesure qu'elles transitent par les rubriques de vos SNS vers vos services SNS-supported d'abonnement. Utilisez le X-Ray suivi avec Amazon SNS pour analyser les latences de vos messages et de leurs services principaux, par exemple la durée pendant laquelle une demande est consacrée à un sujet et le temps nécessaire pour transmettre le message à chacun des abonnements du sujet. Amazon SNS prend en charge le X-Ray traçage pour les rubriques standard et FIFO.

Si vous publiez sur une rubrique Amazon SNS à partir d'un service qui est déjà instrumenté X-Ray, Amazon SNS transmet le contexte de suivi de l'éditeur aux abonnés. En outre, vous pouvez activer le suivi actif pour envoyer des données de segment relatives à vos abonnements Amazon SNS X-Ray pour les messages publiés depuis un client SNS instrumenté. Activez le suivi actif pour une rubrique Amazon SNS à l'aide de la console Amazon SNS ou de l'API ou de l'interface de ligne de commande Amazon SNS. Consultez Instrumentation de votre application pour plus d'informations sur l'instrumentation de vos clients SNS.

Configurer le suivi actif d'Amazon SNS

Vous pouvez utiliser la console Amazon SNS, l' AWS interface de ligne de commande ou le SDK pour configurer le suivi actif d'Amazon SNS.

Lorsque vous utilisez la console Amazon SNS, Amazon SNS tente de créer les autorisations nécessaires pour que SNS puisse appeler. X-Ray La tentative peut être rejetée si vous ne disposez pas des autorisations suffisantes pour modifier les politiques relatives aux X-Ray ressources. Pour plus d'informations sur ces autorisations, consultez les rubriques Gestion des identités et des accès dans Amazon SNS et Exemples de cas relatifs au contrôle d'accès Amazon SNS dans le manuel Amazon Simple Notification Service Developer Guide. Pour plus d'informations sur l'activation du suivi actif à l'aide de la console Amazon SNS, consultez la rubrique Activation du suivi actif sur Amazon SNS dans le manuel Amazon Simple Notification Service Developer Guide.

Lorsque vous utilisez la AWS CLI ou le SDK pour activer le suivi actif, vous devez configurer manuellement les autorisations à l'aide de politiques basées sur les ressources. PutResourcePolicyÀ utiliser pour configurer X-Ray avec la politique basée sur les ressources nécessaire pour permettre à Amazon SNS d'envoyer des traces à. X-Ray

{
    Version: "2012-10-17",
    Statement: [
      {
        Sid: "SNSAccess",
        Effect: Allow,
        Principal: {
          Service: "sns.amazonaws.com",
        },
        Action: [
          "xray:PutTraceSegments",
          "xray:GetSamplingRules",
          "xray:GetSamplingTargets"
        ],
        Resource: "*",
        Condition: {
          StringEquals: {
            "aws:SourceAccount": "account-id"
          },
          StringLike: {
            "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name"
          }
        }
      }
    ]
  }

aws xray put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "SNSAccess", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": [ "xray:PutTraceSegments", "xray:GetSamplingRules", "xray:GetSamplingTargets" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "account-id" }, "StringLike": { "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name" } } } ] }'

Afficher les traces des éditeurs et des abonnés Amazon SNS dans la console X-Ray

Utilisez la X-Ray console pour afficher une carte de suivi et les détails du suivi qui affichent une vue connectée des éditeurs et des abonnés Amazon SNS. Lorsque le suivi actif Amazon SNS est activé pour un sujet, la carte de X-Ray trace et la carte des détails de la trace affichent les nœuds connectés pour les éditeurs Amazon SNS, la rubrique Amazon SNS et les abonnés en aval :

Après avoir choisi une trace qui couvre un éditeur et un abonné Amazon SNS, la page des détails de la X-Ray trace affiche une carte des détails de la trace et une chronologie des segments.

Exemple Exemple de chronologie avec l'éditeur et l'abonné Amazon SNS

Cet exemple montre une chronologie qui inclut un éditeur Amazon SNS qui envoie un message à une rubrique Amazon SNS, qui est traitée par un abonné Amazon SQS.

L'exemple de chronologie ci-dessus fournit des informations sur le flux de messages Amazon SNS :

• Le segment SNS représente la durée aller-retour de l'appel d'PublishAPI du client.

• Le segment MyTopic représente la latence de la réponse Amazon SNS à la demande de publication.

• Le sous-segment SQS représente le temps aller-retour nécessaire à Amazon SNS pour publier le message dans une file d'attente Amazon SQS.

• Le temps entre le segment MyTopic et le sous-segment SQS représente le temps que le message passe dans le système Amazon SNS.

Exemple Exemple de chronologie avec des messages Amazon SNS groupés

Si plusieurs messages Amazon SNS sont regroupés au sein d'une seule trace, la chronologie des segments affiche les segments qui représentent chaque message traité.