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 vos rubriques SNS vers vos services d'abonnement pris en charge par le SNS. Utilisez le suivi X-Ray avec Amazon SNS pour analyser les temps de latence de vos messages et de leurs services principaux, par exemple le temps passé par une demande dans un sujet et le temps nécessaire pour transmettre le message à chacun des abonnements du sujet. Amazon SNS prend en charge le suivi X-Ray pour les rubriques standard et FIFO.

Si vous publiez sur une rubrique Amazon SNS à partir d'un service déjà équipé de 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 à X-Ray des données de segment relatives à vos abonnements Amazon SNS pour les messages publiés à partir d'un client SNS instrumenté. Activez le suivi actif pour une rubrique Amazon SNS à l'aide de la console Amazon SNS ou à l'aide de l'API ou de la CLI Amazon SNS. Consultez Instrumentation de votre application pour plus d'informations sur l'instrumentation de vos clients SNS.

Configurer le suivi actif Amazon SNS

Vous pouvez utiliser la console Amazon SNS, la AWS CLI ou le SDK pour configurer le suivi actif Amazon SNS.

Lorsque vous utilisez la console Amazon SNS, Amazon SNS tente de créer les autorisations nécessaires pour que SNS appelle X-Ray. La tentative peut être rejetée si vous ne disposez pas des autorisations suffisantes pour modifier les politiques relatives aux ressources de X-Ray. Pour plus d'informations sur ces autorisations, consultez la section Gestion des identités et des accès dans Amazon SNS et Exemples de cas de contrôle d'accès Amazon SNS dans le guide du développeur Amazon Simple Notification Service. Pour plus d'informations sur l'activation du suivi actif à l'aide de la console Amazon SNS, consultez la section Activation du suivi actif sur une rubrique Amazon SNS du 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 console X-Ray pour consulter une carte de trace et les détails des traces qui affichent une vue connectée des éditeurs et des abonnés Amazon SNS. Lorsque le suivi actif d'Amazon SNS est activé pour une rubrique, la carte de suivi et la carte des détails des traces X-Ray affichent les nœuds connectés pour les éditeurs Amazon SNS, la rubrique Amazon SNS et les abonnés en aval :

Après avoir sélectionné un suivi couvrant un éditeur et un abonné Amazon SNS, la page des détails du suivi X-Ray affiche une carte des détails du suivi et une chronologie des segments.

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é 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 de chronologie avec des messages Amazon SNS groupés

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