Activer la recherche de transactions - Amazon CloudWatch
Activation de la recherche de transactions dans la consoleActivation de la recherche de transactions à l'aide d'une API

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.

Activer la recherche de transactions

Vous pouvez l'activer Recherche de transactions via la console ou à l'aide d'une API. La recherche de transactions est configurée pour l'ensemble du compte et fait passer tous les spans ingérés via X-Ray en mode de collecte rentable à l'aide d'Amazon CloudWatch Pricing. Par défaut, vous indexerez également 1 % des spans ingérés gratuitement sous forme de résumé des traces à des fins d'analyse, ce qui est généralement suffisant étant donné que vous disposez déjà d'une visibilité complète end-to-end sur tous les spans ingérés via Transaction Search.

Activation de la recherche de transactions dans la console

La procédure suivante décrit comment activer Transaction Search dans la console.

Pour activer la recherche de transactions dans la CloudWatch console

  1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le volet de navigation, sous Application Signals, sélectionnez Transaction Search.

  3. Choisissez Activer la recherche de transactions.

  4. Cochez la case pour ingérer les travées sous forme de journaux structurés et entrez un pourcentage de travées à indexer. Vous pouvez indexer les intervalles à 1 % gratuitement et modifier le pourcentage ultérieurement en fonction de vos besoins.

Activation de la recherche de transactions à l'aide d'une API

La procédure suivante décrit comment activer la recherche de transactions à l'aide d'une API.

Étape 1. Créez une politique qui accorde l'accès aux intervalles d'ingestion dans les journaux CloudWatch

Lorsque vous utilisez le AWS CLI SDK pour activer Transaction Search, vous devez configurer les autorisations à l'aide d'une politique basée sur les ressources avec. PutResourcePolicy

Exemple de stratégie

L'exemple de politique suivant permet à X-Ray d'envoyer des traces à CloudWatch Logs 

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "TransactionSearchXRayAccess",
            "Effect": "Allow",
            "Principal": {
                "Service": "xray.amazonaws.com"
            },
            "Action": "logs:PutLogEvents",
            "Resource": [
                "arn:partition:logs:region:account-id:log-group:aws/spans:*",
                "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*"
            ],
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:partition:xray:region:account-id:*"
                },
                "StringEquals": {
                    "aws:SourceAccount": "account-id"
                }
            }
        }
    ]
}
Exemple de commande

L'exemple suivant montre comment formater votre AWS CLI commande avecPutResourcePolicy. 

aws logs put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:partition:logs:region:account-id:log-group:aws/spans:*", "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:partition:logs:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}'

Étape 2. Configuration de la destination des segments de trace

Configurez l'ingestion de spans avec UpdateTraceSegmentDestination.

Exemple de commande

L'exemple suivant montre comment formater votre AWS CLI commande avecUpdateTraceSegmentDestination. 

aws xray update-trace-segment-destination --destination CloudWatchLogs

Étape 3. Configurer le nombre de spans à indexer

Configurez le pourcentage d'échantillonnage souhaité avec UpdateIndexingRule

Exemple de commande

L'exemple suivant montre comment formater votre AWS CLI commande avecUpdateIndexingRule. 

aws xray update-indexing-rule --name "Default" --rule '{"Probabilistic": {"DesiredSamplingPercentage": number}}'
Note

Une fois que vous avez activé la recherche de transactions, dix minutes peuvent être nécessaires pour que les intervalles soient disponibles pour la recherche et l'analyse.

Étape 4 : Vérifiez que les plages sont disponibles pour la recherche et l'analyse

Pour vérifier que les plages sont disponibles pour la recherche et l'analyse, utilisez GetTraceSegmentDestination.

Exemples de commandes

L'exemple suivant montre comment formater votre AWS CLI commande avecGetTraceSegmentDestination. 

aws xray get-trace-segment-destination
Exemple de réponse

L'exemple suivant montre la réponse à laquelle vous pouvez vous attendre lorsque Transaction Search est actif. 

{
    "Destination": "CloudWatchLogs",
    "Status": "ACTIVE"
}