View a markdown version of this page

Amazon EC2 et AWS App Mesh - AWS X-Ray

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.

Amazon EC2 et AWS App Mesh

AWS X-Ray s'intègre AWS App Mesh à la gestion des proxys Envoy pour les microservices. App Mesh fournit une version d'Envoy que vous pouvez configurer pour envoyer des données de trace au X-Ray démon qui s'exécute dans un conteneur contenant la même tâche ou le même module. X-Ray prend en charge le traçage à l'aide des services compatibles App Mesh suivants :

  • Amazon Elastic Container Service (Amazon ECS)

  • Amazon Elastic Kubernetes Service (Amazon EKS)

  • Amazon Elastic Compute Cloud (Amazon EC2)

Suivez les instructions suivantes pour savoir comment activer le X-Ray traçage via App Mesh.

Une carte de trace qui montre les traces entre les clients et les services App Mesh.

Pour configurer le proxy Envoy auquel envoyer des données X-Ray, définissez la variable d'ENABLE_ENVOY_XRAY_TRACINGenvironnement dans sa définition de conteneur.

Note

La version App Mesh d'Envoy n'envoie actuellement pas de traces en fonction des règles d'échantillonnage configurées. Au lieu de cela, il utilise un taux d'échantillonnage fixe de 5 % pour la version 1.16.3 ou ultérieure d'Envoy, ou un taux d'échantillonnage de 50 % pour les versions d'Envoy antérieures à 1.16.3.

Exemple Définition du conteneur Envoy pour Amazon ECS
{
      "name": "envoy",
      "image": "public.ecr.aws/appmesh/aws-appmesh-envoy:envoy-version",
      "essential": true,
      "environment": [
        {
          "name": "APPMESH_VIRTUAL_NODE_NAME",
          "value": "mesh/myMesh/virtualNode/myNode"
        },
        {
          "name": "ENABLE_ENVOY_XRAY_TRACING",
          "value": "1"
        }
      ],
      "healthCheck": {
        "command": [
          "CMD-SHELL",
          "curl -s http://localhost:9901/server_info | cut -d' ' -f3 | grep -q live"
        ],
        "startPeriod": 10,
        "interval": 5,
        "timeout": 2,
        "retries": 3
      }
Note

Pour en savoir plus sur les adresses régionales Envoy disponibles, consultez l'image d'Envoy dans le Guide de AWS App Mesh l'utilisateur.

Pour plus de détails sur l'exécution du X-Ray démon dans un conteneur, consultezExécution du daemon X-Ray sur Amazon ECS. Pour un exemple d'application qui inclut un service mesh, un microservice, un proxy Envoy et un X-Ray démon, déployez l'colorappexemple dans le référentiel App Mesh Examples GitHub.

En savoir plus