View a markdown version of this page

Meilleures pratiques de résolution des problèmes liés à App Mesh - AWS App Mesh

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.

Meilleures pratiques de résolution des problèmes liés à App Mesh

Important

Avis de fin de support : le 30 septembre 2026, AWS le support pour 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 Migration depuis Amazon ECS Service Connect AWS App Mesh vers Amazon ECS.

Nous vous recommandons de suivre les bonnes pratiques décrites dans cette rubrique pour résoudre les problèmes liés à l'utilisation d'App Mesh.

Activer l'interface d'administration du proxy Envoy

Le proxy Envoy est livré avec une interface d'administration que vous pouvez utiliser pour découvrir la configuration et les statistiques et pour exécuter d'autres fonctions administratives telles que la vidange des connexions. Pour plus d'informations, consultez la section Interface d'administration dans la documentation d'Envoy.

Si vous utilisez le terminal géréImage de l'envoyé, le terminal d'administration est activé par défaut sur le port 9901. Les exemples fournis dans cette section Résolution des problèmes de configuration d'App Mesh affichent l'exemple d'URL du point de terminaison d'administration sous la formehttp://my-app.default.svc.cluster.local:9901/.

Note

Le terminal d'administration ne doit jamais être exposé à l'Internet public. En outre, nous vous recommandons de surveiller les journaux des terminaux d'administration, qui sont définis par défaut /tmp/envoy_admin_access.log par la variable d'ENVOY_ADMIN_ACCESS_LOG_FILEenvironnement.

Activer l'intégration d'Envoy DogStats D pour le déchargement des métriques

Le proxy Envoy peut être configuré pour décharger les statistiques relatives au trafic OSI de couche 4 et de couche 7 et à l'état de santé des processus internes. Bien que cette rubrique explique comment utiliser ces statistiques sans les transférer vers des puits tels que les CloudWatch métriques et Prometheus., le fait de centraliser ces statistiques pour toutes vos applications peut vous aider à diagnostiquer les problèmes et à confirmer le comportement plus rapidement. Pour plus d'informations, consultez la section Utilisation d'Amazon CloudWatch Metrics et la documentation Prometheus.

Vous pouvez configurer les métriques DogStats D en définissant les paramètres définis dansDogStatsVariables D. Pour plus d'informations sur DogStats D, consultez la documentation DogStats D. Vous trouverez une démonstration du transfert de métriques vers des AWS CloudWatch métriques dans l'App Mesh, qui décrit les principes de base d'Amazon ECS. GitHub

Activer les journaux d'accès

Nous vous recommandons d'activer les journaux d'accès sur votre application Nœuds virtuels et Passerelles virtuelles de découvrir des informations sur le trafic qui transite entre vos applications. Pour plus d'informations, consultez la section Journalisation des accès dans la documentation d'Envoy. Les journaux fournissent des informations détaillées sur le comportement du trafic OSI de couche 4 et de couche 7. Lorsque vous utilisez le format par défaut d'Envoy, vous pouvez analyser les journaux d'accès avec CloudWatch Logs Insights à l'aide de l'instruction d'analyse suivante.

parse @message "[*] \"* * *\" * * * * * * * * * * *" as StartTime, Method, Path, Protocol, ResponseCode, ResponseFlags, BytesReceived, BytesSent, DurationMillis, UpstreamServiceTimeMillis, ForwardedFor, UserAgent, RequestId, Authority, UpstreamHost

Activer la journalisation du débogage Envoy dans les environnements de pré-production

Nous vous recommandons de définir le niveau de journalisation du proxy Envoy sur debug un environnement de pré-production. Les journaux de débogage peuvent vous aider à identifier les problèmes avant de transférer la configuration App Mesh associée à votre environnement de production.

Si vous utilisez l'image Envoy, vous pouvez définir le niveau de journalisation debug via la variable d'ENVOY_LOG_LEVELenvironnement.

Note

Nous ne recommandons pas d'utiliser ce debug niveau dans les environnements de production. La définition du niveau debug augmente la journalisation et peut affecter les performances et le coût global des journaux transférés vers des solutions telles que CloudWatch Logs.

Lorsque vous utilisez le format par défaut d'Envoy, vous pouvez analyser les journaux de processus avec CloudWatch Logs Insights à l'aide de l'instruction d'analyse suivante :

parse @message "[*][*][*][*] [*] *" as Time, Thread, Level, Name, Source, Message

Surveillez la connectivité du proxy Envoy avec le plan de contrôle App Mesh

Nous vous recommandons de surveiller les métriques Envoy control_plane.connected_state pour vous assurer que le proxy Envoy communique avec le plan de contrôle App Mesh pour récupérer les ressources de configuration dynamique. Pour plus d'informations, consultez la section Serveur de gestion.