Configuration des règles d’échantillonnage AWS X-Ray pour les API API Gateway

Configure sampling rules

Utilisation de règles d’échantillonnage avec l’API X-Ray

Rule name (Nom de la règle) (chaîne) : nom unique de la règle.

Priority (Priorité) (nombre 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 (Fréquence) (nombre compris entre 0 et 100) : pourcentage de demandes correspondantes à instrumenter une fois que le réservoir est épuisé.

Service name (Nom du service) (chaîne) : nom de l’étape d’API, sous la forme {api-name}/{stage-name}. Par exemple, si vous deviez déployer l’exemple d’API PetStore dans une étape nommée test, la valeur à spécifier pour Service name (Nom du service) dans votre règle d’échantillonnage serait pets/test.

Service type (Type de service) (chaîne) : pour une API API Gateway, vous pouvez spécifier AWS::ApiGateway::Stage ou AWS::ApiGateway::*.

Host (Hôte) (chaîne) : nom d’hôte de l’en-tête d’hôte HTTP. Définissez cette valeur sur * pour l’associer à tous les noms d’hôte. Vous pouvez également spécifier tout ou partie d’un nom d’hôte pour le faire correspondre (par exemple, api.example.com ou *.example.com).

Resource ARN (ARN de la ressource) (chaîne) : ARN de l’étape de l’API, au format  ; par exemple, arn:aws:apigateway:region::/restapis/api-id/stages/stage-name.

Le nom de l’étape peut être obtenu à partir de la console ou de l’interface de ligne de commande ou de l’API API Gateway. Pour plus d’informations sur les formats ARN, consultez Référence générale d'Amazon Web Services.

HTTP method (Méthode HTTP) (chaîne) : la méthode à échantillonner (par exemple, GET).

URL path (Chemin URL) (chaîne) : chemin URL de la demande.

(facultatif) Attributes (Attributs) (clé et valeur) : en-têtes de la demande HTTP d’origine (par exemple, Connection, Content-Length ou Content-Type). Chaque attribut peut contenir jusqu’à 32 caractères.

Nom de la règle — test-sampling

Priorité — 17

Taille du réservoir — 10

Fréquence fixe — 10

Nom du service — testxray/test

Type de service — AWS::ApiGateway::Stage

Méthode HTTP — GET

ARN de la ressource — *

Hôte — *

Nom de la règle — prod-sampling

Priorité — 478

Taille du réservoir — 1

Fréquence fixe — 60

Nom du service — testxray/prod

Type de service — AWS::ApiGateway::Stage

Méthode HTTP — *

ARN de la ressource — *

Hôte — *

Attributs — {}