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.
# Suivi actif dans Amazon SNS
AWS X-Ray Utilisez-le pour suivre et analyser les demandes des utilisateurs lorsqu'elles passent par vos rubriques Amazon SNS vers [Amazon Data Firehose](sns-firehose-as-subscriber.md), Amazon [AWS Lambda](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-lambda.html)SQS et les abonnements aux [terminaux](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sqs.html). HTTP/S
Avec X-Ray, vous avez un end-to-end aperçu de chaque demande, ce qui vous permet de :
+ Identifiez le nom de votre rubrique Amazon SNS et les services proposés en aval de ses abonnements.
+ Analysez les latences, telles que :
+ Temps passé dans la rubrique Amazon SNS avant le traitement.
+ Délais de livraison pour chaque point de terminaison abonné.
**Important**
Les rubriques Amazon SNS ayant de nombreux abonnements peuvent atteindre une taille limite et ne pas être entièrement suivies. Pour plus d'informations sur les limites de taille des documents de suivi, consultez la section [Quotas des services de radiographie](https://docs.aws.amazon.com/general/latest/gr/xray.html#limits_xray) dans la section Référence AWS générale.
Si vous appelez une API Amazon SNS à partir d'un service qui est déjà suivi, Amazon SNS transmet le suivi, même si le suivi X-Ray n'est pas activé sur l'API.
Amazon SNS prend en charge le suivi X-Ray pour les rubriques standard et FIFO. Vous pouvez activer X-Ray pour une rubrique Amazon SNS à l'aide de la [console Amazon SNS](https://console.aws.amazon.com/sns/v3/home), de l'[API Amazon SNS `SetTopicAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html), de la [Référence d'interface de ligne de commande Amazon Simple Notification Service](https://docs.aws.amazon.com/cli/latest/reference/sns/) ou d'[CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html).
Pour en savoir plus sur l'utilisation d'Amazon SNS avec X-Ray, consultez [Amazon SNS et AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) dans le Guide du développeur AWS X-Ray .
## Autorisations de suivi actif
Lorsque vous utilisez la console Amazon SNS, Amazon SNS tente de créer les autorisations nécessaires pour que la rubrique Amazon SNS appelle X-Ray. La tentative peut être rejetée si vous ne disposez pas des autorisations nécessaires pour utiliser la console Amazon SNS. Pour plus d’informations, consultez [Gestion des identités et des accès dans Amazon SNS](security-iam.md) et [Cas d'exemple pour le contrôle d'accès Amazon SNS](sns-access-policy-use-cases.md).
Lorsque vous utilisez l'interface de ligne de commande, vous devez configurer les autorisations manuellement. Ces autorisations sont configurées à l'aide de politiques de ressources. Pour en savoir plus sur l'utilisation des autorisations requises dans X-Ray, consultez [Amazon SNS et AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html).
## Activation du suivi actif sur une rubrique Amazon SNS à l'aide de la console AWS
Lorsque le suivi actif est activé sur une rubrique Amazon SNS, il lit l'ID de suivi, envoie les données au client en fonction de l'ID de suivi et propage l'ID de suivi aux services en aval.
1. Connectez-vous à la [console Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Choisissez une rubrique ou créez-en une. Pour plus d'informations sur la création de rubriques, consultez [Création d'une rubrique Amazon SNS](sns-create-topic.md).
1. Sur la page **Créer une rubrique**, dans la section **Détails**, choisissez un type de rubrique : **FIFO** ou **Standard**.
1. Entrez un **Nom** pour la rubrique.
1. (Facultatif) Entrez un **Nom d'affichage** pour votre rubrique.
1. Développez **Active tracing** (Suivi actif) et choisissez **Use active tracing** (Utiliser le suivi actif).
Une fois que vous avez activé X-Ray pour votre rubrique Amazon SNS, vous pouvez utiliser [la carte des services X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) pour afficher les end-to-end traces et les cartes de service associées à cette rubrique.
## Activation du suivi actif sur une rubrique Amazon SNS à l'aide du SDK AWS
L'exemple de code suivant montre comment activer le suivi actif sur une rubrique Amazon SNS à l'aide du AWS SDK pour Java.
```
public static void enableActiveTracing(SnsClient snsClient, String topicArn) {
try {
SetTopicAttributesRequest request = SetTopicAttributesRequest.builder()
.attributeName("TracingConfig")
.attributeValue("Active")
.topicArn(topicArn)
.build();
SetTopicAttributesResponse result = snsClient.setTopicAttributes(request);
System.out.println("\n\nStatus was " + result.sdkHttpResponse().statusCode() + "\n\nTopic " + request.topicArn()
+ " updated " + request.attributeName() + " to " + request.attributeValue());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
}
}
```
## Activation du suivi actif sur une rubrique Amazon SNS à l'aide de la CLI AWS
L'exemple de code suivant montre comment activer le suivi actif sur une rubrique Amazon SNS à l'aide de la CLI AWS .
```
aws sns set-topic-attributes \
--topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--attribute-name TracingConfig \
--attribute-value Active
```
## Activation du suivi actif sur une rubrique Amazon SNS à l'aide de CloudFormation
La CloudFormation pile suivante montre comment activer le suivi actif sur une rubrique Amazon SNS.
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
MyTopicResource:
Type: 'AWS::SNS::Topic'
Properties:
TopicName: 'MyTopic'
TracingConfig: 'Active'
```
## Vérifier que le suivi actif est activé pour votre rubrique
Vous pouvez utiliser la console Amazon SNS pour vérifier si le suivi actif est activé pour votre rubrique ou quand la politique de ressources n'a pas pu être ajoutée.
1. Connectez-vous à la [console Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Dans le panneau de navigation de gauche, choisissez **Rubriques**.
1. Sur la page **Topics** (Rubriques), choisissez une rubrique.
1. Sélectionnez l'onglet **Integrations** (Intégrations).
Lorsque le suivi actif est activé, une icône **Active** (Actif) verte s'affiche.
1. Si vous avez activé le suivi actif et que vous ne voyez pas que la politique de ressources a été ajoutée, choisissez **Create policy** (Créer une politique) pour ajouter les autorisations supplémentaires requises.
![\[Capture d'écran présentant les détails d'une rubrique Amazon SNS nommée « SampleTopic » dans le. AWS Management Console Cela indique que le suivi AWS X-Ray actif est activé pour cette rubrique, mais qu'une politique de ressources autorisant Amazon SNS à envoyer des données de suivi est manquante. Un bouton « Créer une politique » est fourni pour résoudre ce problème.\]](http://docs.aws.amazon.com/fr_fr/sns/latest/dg/images/xray.png)
## Tester le suivi actif
1. Connectez-vous à la [console Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Créer une rubrique Amazon SNS. Pour plus d'informations sur la manière de procéder, consultez [Pour créer un sujet à l'aide du AWS Management Console](sns-create-topic.md#create-topic-aws-console).
1. Développez **Active tracing** (Suivi actif) et choisissez **Use active tracing** (Utiliser le suivi actif).
1. Publiez un message dans la rubrique Amazon SNS. Pour plus d'informations sur la manière de procéder, consultez [Pour publier des messages sur des rubriques Amazon SNS à l'aide du AWS Management Console](sns-publishing.md#sns-publishing-messages).
1. Utilisez la [carte des services X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) pour afficher les end-to-end traces et les cartes de service associées au sujet.
![\[Affiche une carte des AWS X-Ray services qui montre le suivi d'une demande provenant d'un client vers une rubrique Amazon SNS nommée « »xray-topic. À partir de là, le message est distribué à divers services en aval, notamment une file d'attente Amazon SQS, une fonction Lambda, un Kinesis Firehose et un service distant. Chaque connexion affiche des indicateurs tels que la latence en millisecondes (ms) et le taux de transactions par minute (t/min), ce qui permet d'analyser les performances et d'identifier les éventuels problèmes de latence dans le processus de livraison des messages.\]](http://docs.aws.amazon.com/fr_fr/sns/latest/dg/images/xray-troubleshooting.png)