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.
# 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](https://aws.amazon.com/blogs/containers/migrating-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 comme`TCP`.
+ 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](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/howto-ecs-basics/deploy/2-meshify.yaml#L374-L386) sur GitHub.
+ Assurez-vous que le suivi est activé sur le conteneur Envoy. Si vous utilisez l'[image App Mesh Envoy](envoy.md), vous pouvez activer X-Ray en définissant la variable d'`ENABLE_ENVOY_XRAY_TRACING`environnement sur une valeur de `1` et la variable d'`XRAY_DAEMON_PORT`environnement sur`2000`.
+ 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](https://docs.aws.amazon.com/xray/index.html).
+ 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](https://docs.aws.amazon.com/xray/latest/devguide/xray-troubleshooting.html). 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](https://aws.amazon.com/blogs/compute/integrating-aws-x-ray-with-aws-app-mesh/).
[Si votre problème n'est toujours pas résolu, pensez à en ouvrir un GitHub ou à contacter le [AWS Support](https://aws.amazon.com/premiumsupport/).](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here)
## 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](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent) 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](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent#usage) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html).
[Si votre problème n'est toujours pas résolu, pensez à en ouvrir un GitHub ou à contacter le [AWS Support](https://aws.amazon.com/premiumsupport/).](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here)
## 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_RATE`environnement 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](envoy-config.md#envoy-xray-config).
+ Pour configurer les règles d'échantillonnage personnalisées localisées pour le traceur X-Ray, utilisez la variable d'`XRAY_SAMPLING_RULE_MANIFEST`environnement 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](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) 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_FILE`environnement pour modifier votre taux d'échantillonnage. Pour de plus amples informations, veuillez consulter [Variables de configuration Envoy](envoy-config.md). 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](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/xray.proto.html#config-trace-v3-xrayconfig).
+ Exemple de configuration de suivi personnalisée pour la variable d'`ENVOY_TRACING_CFG_FILE`environnement :
```
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](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling).
[Si votre problème n'est toujours pas résolu, pensez à en ouvrir un GitHub ou à contacter le [AWS Support](https://aws.amazon.com/premiumsupport/).](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here)