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.
Configuration de règles d'échantillonnage
Vous pouvez utiliser la console AWS X-Ray pour configurer des règles d'échantillonnage pour vos services. Le SDK X-Ray et lesAWS services qui prennent en charge le traçage actif avec configuration d'échantillonnage utilisent des règles d'échantillonnage pour déterminer les demandes à enregistrer.
Rubriques
Configuration de règles d'échantillonnage
Vous pouvez configurer l'échantillonnage pour les cas d'utilisation suivants :
-
API Gateway Entrypoint — API Gateway prend en charge l'échantillonnage et le traçage actif. Pour activer le suivi actif sur une étape d'API, consultez Prise en charge du suivi actif Amazon API Gateway pourAWS X-Ray.
-
AWS AppSync—AWS AppSync prend en charge l'échantillonnage et le traçage actif. Pour activer le suivi actif desAWS AppSync demandes, consultez la section Suivi avecAWS X-Ray.
-
SDK Instrument X-Ray sur des plateformes de calcul : lorsque vous utilisez des plateformes de calcul telles qu'Amazon EC2, Amazon ECS ouAWS Elastic Beanstalk, l'échantillonnage est pris en charge lorsque l'application a été instrumentée avec le dernier SDK X-Ray.
Personnalisation des règles d'échantillonnage
En personnalisant les règles d'échantillonnage, vous pouvez contrôler la quantité de données que vous enregistrez. Vous pouvez également modifier le comportement d'échantillonnage sans modifier ni redéployer votre code. Les règles d'échantillonnage indiquent au SDK X-Ray le nombre de demandes à enregistrer pour un ensemble de critères. Par défaut, le SDK X-Ray enregistre la première demande chaque seconde, ainsi que cinq pour cent des demandes supplémentaires. Une demande par seconde est le réservoir. Ceci garantit qu'au moins une trace est enregistrée chaque seconde aussi longtemps que le service traite les demandes. 5 % est la fréquence à laquelle les demandes supplémentaires au-delà du réservoir sont échantillonnées.
Vous pouvez configurer le SDK X-Ray pour lire les règles d'échantillonnage à partir d'un document JSON que vous incluez dans votre code. Cependant, lorsque vous exécutez plusieurs instances de votre service, chaque instance exécute l'échantillonnage de manière indépendante. Ceci entraîne une augmentation du pourcentage global des demandes échantillonnées, car les réservoirs de toute les instances sont effectivement additionnés. En outre, pour mettre à jour les règles d'échantillonnage locales, vous devez redéployer votre code.
En définissant des règles d'échantillonnage dans la console X-Ray et en configurant le SDK pour lire les règles du service X-Ray, vous pouvez éviter ces deux problèmes. Le service gère le réservoir pour chaque règle et attribue les quotas à chaque instance de votre service pour distribuer le réservoir de façon uniforme, en fonction du nombre d'instances qui sont en cours d'exécution. La limite de réservoir est calculée selon les règles que vous avez définies. Les règles étant configurées dans le service, vous pouvez gérer les règles sans effectuer de déploiements supplémentaires.
Note
X-Ray utilise la meilleure approche pour appliquer les règles d'échantillonnage et, dans certains cas, la fréquence d'échantillonnage effective peut ne pas correspondre exactement aux règles d'échantillonnage configurées. Cependant, au fil du temps, le nombre de demandes échantillonnées devrait être proche du pourcentage configuré.
Vous pouvez désormais configurer les règles d'échantillonnage X-Ray depuis la CloudWatch console Amazon. Vous pouvez également continuer à utiliser la console X-Ray.
Options de règle d'échantillonnage
Les options suivantes sont disponibles pour chaque règle. Les valeurs de chaîne peuvent comporter des caractères génériques correspondant à un seul caractère (?) ou à zéro caractère ou plus (*).
Options de règle d'échantillonnage
-
Rule name (Nom de la règle) (chaîne) : nom unique de la règle.
-
Priority (Réservoir) (entier compris entre 1 et 9999) : priorité de la règle d'échantillonnage. Les services évaluent les règles dans l'ordre croissant de priorité, et prennent une décision d'échantillonnage avec la première règle correspondante.
-
Reservoir (Réservoir) (entier non négatif) : nombre fixe de demandes correspondantes à instrumenter par seconde, avant d'appliquer la fréquence fixe. Le réservoir n'est pas utilisé directement par les services, mais s'applique à tous les services qui utilisent la règle collectivement.
-
Rate (Réservoir) (entier compris entre 0 et 100) : pourcentage de demandes correspondantes à instrumenter une fois que le réservoir est épuisé. Lorsque vous configurez une règle d'échantillonnage dans la console, choisissez un pourcentage compris entre 0 et 100. Lorsque vous configurez une règle d'échantillonnage dans un SDK client à l'aide d'un document JSON, fournissez une valeur en pourcentage comprise entre 0 et 1.
-
Nom du service (chaîne) : nom du service instrumenté, tel qu'il apparaît sur la carte des services.
-
SDK X-Ray : nom du service que vous configurez sur l'enregistreur.
-
Amazon API
api-name/stage
-
-
Type de service (chaîne) : type de service tel qu'il apparaît sur la carte des services. Pour le SDK X-Ray, définissez le type de service en appliquant le plug-in approprié :
-
AWS::ElasticBeanstalk::Environment— UnAWS Elastic Beanstalk environnement (plugin). -
AWS::EC2::Instance— Une instance Amazon Amazon -
AWS::ECS::Container— Un conteneur Amazon ECS (plugin). -
AWS::APIGateway::StageAmazon API Gateway -
AWS::AppSync::GraphQLAPI— Une requêteAWS AppSync d'API.
-
-
Host (Nom d'hôte) (chaîne) : nom d'hôte de l'en-tête d'hôte HTTP.
-
Méthode HTTP (chaîne) — Méthode de la requête HTTP.
-
Le chemin d'URL de la demande.
-
SDK X-Ray : partie du chemin de l'URL de la requête HTTP.
-
-
Resource ARN (chaîne) : ARN de laAWS ressource exécutant le service.
-
SDK X-Ray : non pris en charge. Le kit SDK peut uniquement utiliser des règles avec les ressources ARN définies sur
*. -
Amazon API Gateway : l'ARN d'étape.
-
-
(Facultatif) Attributs (clé et valeur) — Attributs de segment connus lorsque la décision d'échantillonnage est prise.
-
SDK X-Ray : non pris en charge. Le kit SDK ignore les règles qui spécifient les attributs.
-
Amazon API Gateway : en-têtes de la requête HTTP d'origine.
-
Exemples de règles d'échantillonnage
Exemple — Règle par défaut sans réservoir et faible débit
Vous pouvez modifier le réservoir et la fréquence de la règle par défaut. Par défaut, la règle s'applique à toutes les demandes qui ne correspond à aucune autre règle.
-
Réservoir :
0 -
Taux :
5(0.05si configuré à l'aide d'un document JSON)
Exemple — Règle de débogage pour suivre toutes les demandes concernant un itinéraire problématique
Une règle prioritaire est appliquée temporairement pour le débogage.
-
Nom de la règle :
DEBUG – history updates -
Priorité :
1 -
Réservoir :
1 -
Taux :
100(1si configuré à l'aide d'un document JSON) -
Nom du service :
Scorekeep -
Type de service :
* -
Hôte :
* -
Méthode HTTP :
PUT -
Chemin d'accès à l'URL :
/history/* -
ARN de la ressource :
*
Exemple — Taux minimum plus élevé pour les postes
-
Nom de la règle :
POST minimum -
Priorité :
100 -
Réservoir :
10 -
Taux :
10(.1si configuré à l'aide d'un document JSON) -
Nom du service :
* -
Type de service :
* -
Hôte :
* -
Méthode HTTP :
POST -
Chemin d'accès à l'URL :
* -
ARN de la ressource :
*
Configuration de votre service afin d'utiliser les règles d'échantillonnage
Le SDK X-Ray nécessite une configuration supplémentaire pour utiliser les règles d'échantillonnage que vous configurez dans la console. Consultez la rubrique de configuration de votre langage pour en savoir plus sur la configuration d'une stratégie d'échantillonnage :
-
Java: Règles d'échantillonnage
-
Allez :Règles d'échantillonnage
-
Node.js :Règles d'échantillonnage
-
Python: Règles d'échantillonnage
-
Rubis :Règles d'échantillonnage
-
.NET :Règles d'échantillonnage
Pour API Gateway, voirPrise en charge du suivi actif Amazon API Gateway pourAWS X-Ray.
Affichage des résultats d'échantillonnage
La page d'échantillonnage de la console X-Ray contient des informations détaillées sur la manière dont vos services utilisent chaque règle d'échantillonnage.
La colonne Trend (Tendance) montre comment la règle a été utilisé au cours des dernières minutes. Chaque colonne indique les statistiques pour une fenêtre de 10 secondes.
Échantillonnage des statistiques
-
Règle correspondante totale : nombre de demandes correspondant à cette règle. Ce nombre n'inclut pas les demandes qui pourraient avoir une correspondance avec cette règle, mais celles qui ont en premier une règle de priorité.
-
Total échantillonné : nombre de demandes enregistrées.
-
Échantillonnage à taux fixe : nombre de demandes échantillonnées en appliquant le taux fixe de la règle.
-
Échantillonnage avec limite de réservoir : nombre de demandes échantillonnées à l'aide d'un quota attribué par X-Ray.
-
Emprunté au réservoir : nombre de demandes échantillonnées en empruntant au réservoir. La première fois qu'un service associe une demande à une règle, X-Ray ne lui a pas encore attribué de quota. Toutefois, si le réservoir est d'au moins 1, le service emprunte une trace par seconde jusqu'à ce que X-Ray attribue un quota.
Pour plus d'informations sur l'échantillonnage des statistiques et la façon dont les services utilisent les règles d'échantillonnage, consultez Utilisation de règles d'échantillonnage avec l'API X-Ray.
Étapes suivantes
Vous X-Ray utiliser l'Amazon Avec l'API, vous pouvez créer et mettre à jour les règles par programmation ou en fonction d'une planification, en réponse à des alarmes ou à des notifications. Consultez Configuration de l'échantillonnage, des groupes et des paramètres de chiffrement avec l'API AWS X-Ray pour obtenir des instructions et des exemples de règles supplémentaires.
Le SDK et lesAWS services X-Ray utilisent également l'API X-Ray pour lire les règles d'échantillonnage, signaler les résultats d'échantillonnage et obtenir des cibles d'échantillonnage. Les services doivent suivre la fréquence à laquelle ils appliquent chaque règle, évaluer les règles en fonction de leur priorité et emprunter au réservoir lorsqu'une demande correspond à une règle pour laquelle X-Ray n'a pas encore attribué de quota au service. Pour plus de détails sur la façon dont un service utilise l'API pour l'échantillonnage, reportez-vous à la section Utilisation de règles d'échantillonnage avec l'API X-Ray.
Lorsque le SDK X-Ray appelle des API d'échantillonnage, il utilise le démon X-Ray comme proxy. Si vous utilisez déjà le port TCP 2000, vous pouvez configurer le démon pour exécuter le proxy sur un autre port. Consultez Configuration du démon AWS X-Ray pour plus de détails.
