Comment résoudre l'erreur de quota de suivi dans X-Ray ?

Brève description

Les scénarios suivants peuvent entraîner le dépassement de la limite autorisée dans AWS X-Ray :

• Vous avez envoyé un nombre accru de segments groupés pour une trace dont la taille du document de trace dépasse 500 Ko.
• Vous avez envoyé des segments non groupés pour une trace lorsque la taille du document de trace dépasse 100 Ko.
• Vous avez ajouté des segments, des métadonnées et des annotations personnalisés qui ont augmenté la taille du document de trace.

La limite supérieure de la taille d'un document de trace X-Ray change de façon dynamique en fonction du nombre de segments que vous envoyez ensemble. Cela est dû à la fonction de trace de la limite dépassée. Pour un nombre élevé de segments que vous envoyez ensemble dans un lot joint à une trace, la limite supérieure est de 500 Ko. Pour les segments individuels que vous envoyez avec un intervalle de temps associé à une trace, la limite supérieure est de 100 Ko.

Plus vous envoyez une trace rapidement (plus vous regroupez et envoyez de segments), plus l'efficacité de la compression augmente. Plus vous envoyez une trace lentement (envoyez des segments individuellement avec un intervalle de temps), plus la trace est divisée en plusieurs révisions. En outre, plus vous envoyez une trace lentement, plus elle consomme de la capacité de stockage pour le cache dans le backend. Les traces qui durent plus longtemps produisent davantage de doublons et permettent à X-Ray de collecter moins de données.

Résolution

**Remarque :**Si vous recevez des erreurs lors de l'exécution des commandes de l'interface de la ligne de commande AWS (AWS CLI), assurez-vous d'utiliser la version la plus récente de l'interface de ligne de commande AWS.

Affichez la trace dans la console X-Ray, ou exécutez la commande suivante pour vérifier que le document de trace dépasse la limite de taille :

aws xray batch-get-traces --trace-ids <EXAMPLE_TRACE_ID>

Remarque :Remplacez EXAMPLE \ _TRACE \ _ID par l'ID de votre trace.

X-Ray collecte les informations suivantes pour une trace plus grande :

{
    "Id": "<EXAMPLE_TRACE_ID>",
    "Duration": 187.859,
    "LimitExceeded": true,
    "Segments": [
         ...
     ]
     ....
 }

Remarque :Si le paramètre LimitExceeded est vrai, vous avez dépassé le quota de trace ou de segment.

Nombre accru de segments groupés pour une trace lorsque la taille du document de trace dépasse 500 Ko

Ce scénario se produit lorsque vous intégrez Step Functions à X-Ray. Lorsque vous intégrez Step Functions à X-Ray, vous ne pouvez pas personnaliser ce que X-Ray trace ou ne trace pas. Lorsque vous transmettez l'identifiant de trace via toutes les fonctions AWS Lambda, les données de segment sont ajoutées à l'identifiant de trace.

Si vous utilisez Step Functions, procédez comme suit :

1. Accédez à Step Functions, puis désactivez le suivi actif.
2. Transmettez l'identifiant de trace entre les fonctions Lambda uniquement pour les flux de travail critiques, et ne dépassez pas la limite supérieure de trace.
3. Si Lambda reçoit l'en-tête de trace des services en amont, supprimez l'autorisationPutTraceSegments du rôle d'exécution Lambda. La limite supérieure est ajustée dynamiquement.

Si vous n'utilisez pas Step Functions, procédez comme suit :

1. Déboguez votre code pour vérifier si vous transmettez le même identifiant de trace pour différentes demandes.
2. Brisez la trace. Pour ce faire, ne transmettez pas l'ID de trace lors de l'appel aux services en aval.
3. Créez un nouvel identifiant de trace à partir du point de rupture.

**Remarque :**Si vous créez un identifiant de trace pour chaque application, le nombre de traces augmente. Pour faciliter le suivi, conservez les flux de travail des applications critiques dans le cadre d'une seule trace.

Pour plus d'informations, consultez AWS X-Ray et Step Functions.

Segments non groupés pour une trace lorsque la taille du document de trace dépasse 100 Ko

Pour ce scénario, utilisez la solution de la section précédente.

Cassez les traces pour la nouvelle limite supérieure de 100 Ko. Vous pouvez également regrouper davantage de segments dans l'application pour augmenter la limite supérieure à 500 Ko. Le traitement par lots des segments n'est pris en charge qu'avec le SDK de télémétrie ouvert. Si vous utilisez le SDK X-Ray, modifiez la façon dont l'application envoie les segments.

Ajout de segments, de métadonnées et d'annotations personnalisés qui ont augmenté la taille du document

Pour réduire la taille du document de trace, n'ajoutez pas de segments personnalisés supplémentaires au même identifiant de trace. Ajoutez des segments personnalisés uniquement pour les flux de travail nécessaires. De même, pour réduire la taille du document de trace, réduisez les métadonnées et les annotations dans les traces.