Résolution des problèmes liés à l'observabilité de l'App Mesh

Important

Avis de fin de support : le 30 septembre 2026, AWS le support de. AWS App Mesh Après le 30 septembre 2026, vous ne pourrez plus accéder à la AWS App Mesh console ni aux AWS App Mesh ressources. Pour plus d'informations, consultez ce billet de blog intitulé Migration from AWS App Mesh to Amazon ECS Service Connect.

Cette rubrique décrit les problèmes courants que vous pouvez rencontrer avec l'observabilité d'App Mesh.

Impossible de voir les AWS X-Ray traces de mes applications

Symptômes

Votre application dans App Mesh n'affiche pas les informations de suivi X-Ray dans la console X-Ray ou APIs.

Résolution

Pour utiliser X-Ray dans App Mesh, vous devez configurer correctement les composants afin de permettre la communication entre votre application, les conteneurs annexes et le service X-Ray. Suivez les étapes suivantes pour vérifier que X-Ray a été correctement configuré :

• Assurez-vous que le protocole d'écoute App Mesh Virtual Node n'est pas défini commeTCP.

• Assurez-vous que le conteneur X-Ray déployé avec votre application expose le port UDP 2000 et s'exécute en tant qu'utilisateur. 1337 Pour plus d'informations, consultez l'exemple d'Amazon ECS X-Ray sur GitHub.

• Assurez-vous que le suivi est activé sur le conteneur Envoy. Si vous utilisez l'image App Mesh Envoy, vous pouvez activer X-Ray en définissant la variable d'ENABLE_ENVOY_XRAY_TRACINGenvironnement sur une valeur de 1 et la variable d'XRAY_DAEMON_PORTenvironnement sur2000.

• Si vous avez instrumenté X-Ray dans le code de votre application avec l'un des langages spécifiques SDKs , assurez-vous qu'il est correctement configuré en suivant les guides correspondant à votre langue.

• Si tous les éléments précédents sont correctement configurés, consultez les journaux des conteneurs X-Ray pour détecter les erreurs et suivez les instructions de la section Dépannage AWS X-Ray. Vous trouverez une explication plus détaillée de l'intégration de X-Ray dans App Mesh dans Integrating X-Ray with App Mesh.

Si votre problème n'est toujours pas résolu, pensez à en ouvrir un GitHub ou à contacter le AWS Support.

Impossible de voir les métriques Envoy pour mes applications dans CloudWatch les métriques Amazon

Symptômes

Votre application dans App Mesh n'émet pas de métriques générées par le proxy Envoy vers CloudWatch des métriques.

Résolution

Lorsque vous utilisez CloudWatch des métriques dans App Mesh, vous devez configurer correctement plusieurs composants pour permettre la communication entre votre proxy Envoy, le sidecar de l' CloudWatch agent et le service de CloudWatch métriques. Suivez les étapes suivantes pour vérifier que CloudWatch les métriques du proxy Envoy ont été correctement configurées :

• Assurez-vous que vous utilisez l'image de l' CloudWatch agent pour App Mesh. Pour plus d'informations, consultez la section CloudWatchAgent App Mesh activé GitHub.

• Assurez-vous d'avoir correctement configuré l' CloudWatch agent pour App Mesh en suivant les instructions d'utilisation spécifiques à la plate-forme. Pour plus d'informations, consultez la section CloudWatchAgent App Mesh activé GitHub.

• Si tous les éléments précédents sont correctement configurés, consultez les journaux du conteneur de l' CloudWatch agent pour détecter les erreurs et suivez les instructions fournies dans la section Dépannage de l' CloudWatch agent.

Si votre problème n'est toujours pas résolu, pensez à en ouvrir un GitHub ou à contacter le AWS Support.

Impossible de configurer des règles d'échantillonnage personnalisées pour les AWS X-Ray traces

Symptômes

Votre application utilise le traçage X-Ray, mais vous ne parvenez pas à configurer les règles d'échantillonnage pour vos traces.

Résolution

Étant donné qu'App Mesh Envoy ne prend actuellement pas en charge la configuration d'échantillonnage Dynamic X-Ray, les solutions de contournement suivantes sont disponibles.

Si votre version d'Envoy est 1.19.1 ou ultérieure, les options suivantes s'offrent à vous.

• Pour définir uniquement le taux d'échantillonnage, utilisez la variable d'XRAY_SAMPLING_RATEenvironnement sur le conteneur Envoy. La valeur doit être spécifiée sous forme décimale entre 0 et 1.00 (100 %). Pour de plus amples informations, veuillez consulter AWS X-Ray variables.

• Pour configurer les règles d'échantillonnage personnalisées localisées pour le traceur X-Ray, utilisez la variable d'XRAY_SAMPLING_RULE_MANIFESTenvironnement pour spécifier un chemin de fichier dans le système de fichiers du conteneur Envoy. Pour plus d'informations, consultez la section Règles d'échantillonnage dans le Guide du AWS X-Ray développeur.

Si votre version d'Envoy est antérieure à1.19.1, procédez comme suit.

• Utilisez la variable d'ENVOY_TRACING_CFG_FILEenvironnement pour modifier votre taux d'échantillonnage. Pour de plus amples informations, veuillez consulter Variables de configuration Envoy. Spécifiez une configuration de suivi personnalisée et définissez des règles d'échantillonnage locales. Pour plus d'informations, consultez la section Configuration d'Envoy X-Ray.

• Exemple de configuration de suivi personnalisée pour la variable d'ENVOY_TRACING_CFG_FILEenvironnement :

  tracing:
     http:
       name: envoy.tracers.xray
       typedConfig:
         "@type": type.googleapis.com/envoy.config.trace.v3.XRayConfig
         segmentName: foo/bar
         segmentFields:
           origin: AWS::AppMesh::Proxy
           aws:
             app_mesh:
               mesh_name: foo
               virtual_node_name: bar
         daemonEndpoint:
               protocol: UDP
               address: 127.0.0.1
               portValue: 2000
         samplingRuleManifest:
               filename: /tmp/sampling-rules.json

• Pour plus de détails sur la configuration du manifeste des règles d'échantillonnage dans la samplingRuleManifest propriété, consultez Configuring the X-Ray SDK for Go.

Si votre problème n'est toujours pas résolu, pensez à en ouvrir un GitHub ou à contacter le AWS Support.