Configurer des groupes

Les groupes constituent un ensemble de suivis qui sont définis par une expression de filtre. Vous pouvez utiliser des groupes pour générer des graphiques de service supplémentaires et fournir des CloudWatch statistiques Amazon. Vous pouvez utiliser laAWS X-Ray console ou l'API X-Ray pour créer et gérer des groupes pour vos services. Cette rubrique décrit comment créer et gérer des groupes à l'aide de la console X-Ray. Pour plus d'informations sur la gestion des groupes à l'aide de l'API X-Ray, reportez-vous à la sectionGroups.

Vous pouvez créer des groupes de traces pour les cartes de service, les traces ou les analyses. Lorsque vous créez un groupe, le groupe devient disponible sous forme de filtre dans le menu déroulant du groupe sur les trois pages : Plan des services, Traces et Analytics.

Les groupes sont identifiés par leur nom ou un Amazon Resource Name (ARN), et contiennent une expression de filtre. Le service compare les suivis entrants à l'expression, et les stocke en conséquence. Pour plus d'informations sur la création d'une expression de filtrage, consultezUtilisation des expressions de filtre.

Le fait de mettre à jour l'expression de filtrage d'un groupe n'a pas pour effet de modifier les données déjà enregistrées. La mise à jour s'applique uniquement aux suivis ultérieurs. Cela peut entraîner la fusion des expressions nouvelles et anciennes dans le graphique. Pour éviter cela, supprimez un groupe en cours et créez-en un.

Note

Les groupes sont facturés en fonction du nombre de suivis récupérés qui correspondent à l'expression de filtrage. Pour en savoir plus, consultez Tarification de AWS X-Ray.

Créez un groupe

Note

Vous pouvez désormais configurer les groupes X-Ray depuis la CloudWatch console Amazon. Vous pouvez également continuer à utiliser la console X-Ray.

X-Ray console

1. Connectez-vous àAWS Management Console et ouvrez la console X-Ray à l'adresse https://console.aws.amazon.com/xray/home.

2. Ouvrez la page Créer un groupe depuis la page Groupes dans le volet de navigation de gauche ou depuis le menu des groupes sur l'une des pages suivantes : Plan des services, Traces et Analytics.

3. Dans la page Create (Créer un groupe), saisissez un nom de groupe. Un nom de groupe peut avoir un maximum de 32 caractères et peut contenir des caractères alphanumériques et des traits. Les noms des groupes sont sensibles à casse.

4. Entrez une expression de filtrage. Pour plus d'informations sur la création d'une expression de filtrage, consultezUtilisation des expressions de filtre. Dans l'exemple suivant, le groupe filtre les traces d'erreurs provenant du serviceapi.example.com et les demandes adressées au service dont le temps de réponse était supérieur ou égal à cinq secondes.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

5. Dans Insights, activez ou désactivez l'accès aux informations pour le groupe. Pour en savoir plus sur les informations, consultez Utilisation de X-Ray Insights.

   

6. Dans Tags, entrez une clé de balise et une valeur de balise. Lorsque vous ajoutez une étiquette, une nouvelle ligne apparaît pour vous permettre d'en saisir une autre. Les clés de balise doivent être uniques. Pour supprimer une balise, sélectionnez X (X) à la fin de la ligne de la balise. Pour en savoir plus sur les identifications, consultez Balisage des règles et des groupes d'échantillonnage X-Ray.

   

7. Choisissez Créer un groupe.

CloudWatch console

1. Connectez-vous àAWS Management Console et ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Choisissez Settings (Paramètres) dans le panneau de navigation de gauche.

3. Choisissez Afficher les paramètres sous Groupes dans la section X-Ray Traces.

4. Choisissez Créer un groupe au-dessus de la liste des groupes.

5. Dans la page Create (Créer un groupe), saisissez un nom de groupe. Un nom de groupe peut avoir un maximum de 32 caractères et peut contenir des caractères alphanumériques et des traits. Les noms des groupes sont sensibles à casse.

6. Entrez une expression de filtrage. Pour plus d'informations sur la création d'une expression de filtrage, consultezUtilisation des expressions de filtre. Dans l'exemple suivant, le groupe filtre les traces d'erreurs provenant du serviceapi.example.com et les demandes adressées au service dont le temps de réponse était supérieur ou égal à cinq secondes.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

7. Dans Insights, activez ou désactivez l'accès aux informations pour le groupe. Pour en savoir plus sur les informations, consultez Utilisation de X-Ray Insights.

   

8. Dans Balises, choisissez Ajouter une nouvelle balise pour saisir une clé de balise et, éventuellement, une valeur de balise. Continuez à ajouter des balises supplémentaires selon vos besoins. Les clés de balise doivent être uniques. Pour supprimer une balise, sélectionnez Remove (Retirer) en dessous de chaque balise. Pour en savoir plus sur les identifications, consultez Balisage des règles et des groupes d'échantillonnage X-Ray.

   

9. Choisissez Créer un groupe.

Appliquer un groupe

X-Ray console

1. Connectez-vous àAWS Management Console et ouvrez la console X-Ray à l'adresse https://console.aws.amazon.com/xray/home.

2. Ouvrez l'une des pages suivantes dans le volet de navigation :

   • Cartographie des services

   • Des traces

   • Analyse

3. Dans le menu du groupe, choisissez le groupe dans lequel vous avez crééCréez un groupe. Les données affichées sur la page changent pour correspondre à l'expression de filtre définie dans le groupe.

CloudWatch console

1. Connectez-vous àAWS Management Console et ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Ouvrez l'une des pages suivantes dans le volet de navigation sous X-Ray Traces :

   • Cartographie des services

   • Des traces

3. Entrez un nom de groupe dans le filtre de groupe Filtrer par X-Ray Les données affichées sur la page changent pour correspondre à l'expression de filtre définie dans le groupe.

Modifier un groupe

X-Ray console

1. Connectez-vous àAWS Management Console et ouvrez la console X-Ray à l'adresse https://console.aws.amazon.com/xray/home.

2. Procédez de l'une des manières suivantes pour ouvrir la page Modifier le groupe.

   1. Sur la page Groupes, choisissez le nom d'un groupe pour le modifier.

   2. Dans le menu de groupe de l'une des pages suivantes, pointez sur un groupe, puis choisissez Modifier.

      • Cartographie des services

      • Des traces

      • Analyse

3. Bien que vous ne puissiez pas renommer un groupe, vous pouvez mettre à jour l'expression du filtre. Pour plus d'informations sur la création d'une expression de filtrage, consultezUtilisation des expressions de filtre. Dans l'exemple suivant, le groupe filtre les traces d'erreurs provenant du serviceapi.example.com, contenant l'adresse URL de la demandeexample/game, et le temps de réponse aux demandes était supérieur ou égal à cinq secondes.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

4. Dans Insights, activez ou désactivez les informations et les notifications d'informations pour le groupe. Pour en savoir plus sur les informations, consultez Utilisation de X-Ray Insights.

   

5. Dans Balises, modifiez les clés et les valeurs de balise. Les clés de balise doivent être uniques. Les valeurs de balise sont facultatives ; vous pouvez supprimer des valeurs si vous le souhaitez. Pour supprimer une balise, sélectionnez X (X) à la fin de la ligne de la balise. Pour en savoir plus sur les identifications, consultez Balisage des règles et des groupes d'échantillonnage X-Ray.

   

6. Lorsque vous avez terminé de mettre à jour le groupe, sélectionnez Upve (Mettre à jour le groupe).

CloudWatch console

1. Connectez-vous àAWS Management Console et ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Choisissez Settings (Paramètres) dans le panneau de navigation de gauche.

3. Choisissez Afficher les paramètres sous Groupes dans la section X-Ray Traces.

4. Choisissez un groupe dans la section Groupes, puis choisissez Modifier.

5. Bien que vous ne puissiez pas renommer un groupe, vous pouvez mettre à jour l'expression du filtre. Pour plus d'informations sur la création d'une expression de filtrage, consultezUtilisation des expressions de filtre. Dans l'exemple suivant, le groupe filtre les traces d'erreurs provenant du serviceapi.example.com, contenant l'adresse URL de la demandeexample/game, et le temps de réponse aux demandes était supérieur ou égal à cinq secondes.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

6. Dans Insights, activez ou désactivez l'accès aux informations pour le groupe. Pour en savoir plus sur les informations, consultez Utilisation de X-Ray Insights.

   

7. Dans Balises, choisissez Ajouter une nouvelle balise pour saisir une clé de balise et, éventuellement, une valeur de balise. Continuez à ajouter des balises supplémentaires selon vos besoins. Les clés de balise doivent être uniques. Pour supprimer une balise, sélectionnez Remove (Retirer) en dessous de chaque balise. Pour en savoir plus sur les identifications, consultez Balisage des règles et des groupes d'échantillonnage X-Ray.

   

8. Lorsque vous avez terminé de mettre à jour le groupe, sélectionnez Upve (Mettre à jour le groupe).

Cloner un groupe

Le clonage d'un groupe crée un nouveau groupe qui possède l'expression de filtre et les balises d'un groupe existant. Lorsque vous clonez un groupe, le nouveau groupe porte le même nom que le groupe à partir duquel il a été cloné, avec-clone un ajout au nom.

X-Ray console

1. Connectez-vous àAWS Management Console et ouvrez la console X-Ray à l'adresse https://console.aws.amazon.com/xray/home.

2. Ouvrez la page Groupes dans le volet de navigation de gauche, puis choisissez le nom du groupe que vous souhaitez cloner.

3. Choisissez Clone group dans le menu Actions.

4. Sur la page Créer un groupe, le nom du groupe est nom-groupe-clone. Vous pouvez également saisir un nouveau nom de groupe. Un nom de groupe peut avoir un maximum de 32 caractères et peut contenir des caractères alphanumériques et des traits. Les noms des groupes sont sensibles à casse.

5. Vous pouvez conserver l'expression de filtre du groupe existant ou, si vous le souhaitez, saisir une nouvelle expression de filtre. Pour plus d'informations sur la création d'une expression de filtrage, consultezUtilisation des expressions de filtre. Dans l'exemple suivant, le groupe filtre les traces d'erreurs provenant du serviceapi.example.com et les demandes adressées au service dont le temps de réponse était supérieur ou égal à cinq secondes.

   service("api.example.com") { fault = true OR responsetime >= 5 }

6. Dans Tags, modifiez les clés et les valeurs des balises, si nécessaire. Les clés de balise doivent être uniques. Les valeurs de balise sont facultatives ; vous pouvez supprimer des valeurs si vous le souhaitez. Pour supprimer une balise, sélectionnez X (X) à la fin de la ligne de la balise. Pour en savoir plus sur les identifications, consultez Balisage des règles et des groupes d'échantillonnage X-Ray.

7. Choisissez Créer un groupe.

CloudWatch console

1. Connectez-vous àAWS Management Console et ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Choisissez Settings (Paramètres) dans le panneau de navigation de gauche.

3. Choisissez Afficher les paramètres sous Groupes dans la section X-Ray Traces.

4. Choisissez un groupe dans la section Groupes, puis cliquez sur Clone.

5. Sur la page Créer un groupe, le nom du groupe est nom-groupe-clone. Vous pouvez également saisir un nouveau nom de groupe. Un nom de groupe peut avoir un maximum de 32 caractères et peut contenir des caractères alphanumériques et des traits. Les noms des groupes sont sensibles à casse.

6. Vous pouvez conserver l'expression de filtre du groupe existant ou, si vous le souhaitez, saisir une nouvelle expression de filtre. Pour plus d'informations sur la création d'une expression de filtrage, consultezUtilisation des expressions de filtre. Dans l'exemple suivant, le groupe filtre les traces d'erreurs provenant du serviceapi.example.com et les demandes adressées au service dont le temps de réponse était supérieur ou égal à cinq secondes.

   service("api.example.com") { fault = true OR responsetime >= 5 }

7. Dans Tags, modifiez les clés et les valeurs des balises, si nécessaire. Les clés de balise doivent être uniques. Les valeurs de balise sont facultatives ; vous pouvez supprimer des valeurs si vous le souhaitez. Pour supprimer une balise, sélectionnez X (X) à la fin de la ligne de la balise. Pour en savoir plus sur les identifications, consultez Balisage des règles et des groupes d'échantillonnage X-Ray.

8. Choisissez Créer un groupe.

Suppression d'un groupe

Suivez les étapes de cette section pour supprimer un groupe. Vous ne pouvez pas supprimer le groupe par défaut.

X-Ray console

1. Connectez-vous àAWS Management Console et ouvrez la console X-Ray à l'adresse https://console.aws.amazon.com/xray/home.

2. Ouvrez la page Groupes dans le panneau de navigation de gauche, puis sélectionnez le nom du groupe que vous voulez supprimer.

3. Dans le menu Actions, choisissez Supprimer le groupe.

4. Lorsque vous êtes invité à confirmer, sélectionnez Delete (Supprimer).

CloudWatch console

1. Connectez-vous àAWS Management Console et ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Choisissez Settings (Paramètres) dans le panneau de navigation de gauche.

3. Choisissez Afficher les paramètres sous Groupes dans la section X-Ray Traces.

4. Choisissez un groupe dans la section Groupes, puis choisissez Supprimer.

5. Lorsque vous êtes invité à confirmer, sélectionnez Delete (Supprimer).

Afficher les statistiques du groupe sur Amazon CloudWatch

Après la création d'un groupe, les traces entrantes sont comparées à l'expression de filtre du groupe lorsqu'elles sont stockées dans le service X-Ray. Les statistiques relatives au nombre de traces correspondant à chaque critère sont publiées sur Amazon CloudWatch chaque minute. Choisissez Afficher la métrique sur la page Modifier le groupe pour ouvrir la CloudWatch console à la page Metric. Pour plus d'informations sur l'utilisation CloudWatch des statistiques, consultez la section Utilisation d'Amazon CloudWatch Metrics dans le guide de CloudWatch l'utilisateur Amazon.

X-Ray console

1. Connectez-vous àAWS Management Console et ouvrez la console X-Ray à l'adresse https://console.aws.amazon.com/xray/home.

2. Ouvrez la page Groupes dans le volet de navigation de gauche, puis choisissez le nom du groupe pour lequel vous souhaitez consulter les statistiques.

3. Sur la page Modifier le groupe, choisissez Afficher la métrique.

   La page Metrics de la CloudWatch console s'ouvre dans un nouvel onglet.

CloudWatch console

1. Connectez-vous àAWS Management Console et ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Choisissez Settings (Paramètres) dans le panneau de navigation de gauche.

3. Choisissez Afficher les paramètres sous Groupes dans la section X-Ray Traces.

4. Choisissez un groupe dans la section Groupes, puis choisissez Modifier.

5. Sur la page Modifier le groupe, choisissez Afficher la métrique.

   La page Metrics de la CloudWatch console s'ouvre dans un nouvel onglet.