App Mesh 可观测性故障排除

确保 App Mesh 虚拟节点侦听器协议未设置为 TCP。

确保与您的应用程序一起部署的 X-Ray 容器公开 UDP 端口2000并以用户身份运行。1337有关更多信息，请参阅上的 Amazon ECS X-Ray 示例 GitHub。

确保 Envoy 容器已启用追踪。如果您使用的是 App Mesh Envoy 镜像，则可以通过将环境变量设置为将ENABLE_ENVOY_XRAY_TRACING环境变量设置为1 并将 XRAY_DAEMON_PORT环境变量设置为2000来启用 X-Ray。

如果您使用某个特定语言的 SDK 在应用程序代码中对 X-Ray 进行了检测，请按照您的语言指南确保其配置正确。

如果前面的所有项目都配置正确，请查看 X-Ray 容器日志中是否存在错误，并按照疑难解答中的指导进行操作 Amazon X-Ray。有关在 App Mesh 中集成 X-Ray 的更详细说明，请参阅将 X-Ray 与 App Mesh 集成。

确保您使用的是 App Mesh 的 CloudWatch 代理映像。有关更多信息，请参阅上的 App Mesh CloudWatch 代理 GitHub。

确保按照平台特定的使用说明正确配置了 App Mesh 的 CloudWatch 代理。有关更多信息，请参阅上的 App Mesh CloudWatch 代理 GitHub。

如果前面的所有项目都配置正确，请查看 CloudWatch 代理容器日志中是否存在错误，并按照 CloudWatch 代理故障排除中提供的指导进行操作。

要仅设置采样率，请使用 Envoy 容器上的 XRAY_SAMPLING_RATE 环境变量。该值应指定为介于 0 和之间的小数 1.00 (100%)。有关更多信息，请参阅 Amazon X-Ray 变量。

要为 X-Ray tracer 配置本地化的自定义采样规则，请使用 XRAY_SAMPLING_RULE_MANIFEST 环境变量指定 Envoy 容器文件系统中的文件路径。有关更多信息，请参阅《Amazon X-Ray 开发人员指南》中的采样规则。

使用 ENVOY_TRACING_CFG_FILE 环境变量来更改采样率。有关更多信息，请参阅 Envoy 配置变量。指定自定义跟踪配置并定义本地采样规则。有关更多信息，请参阅 Envoy Cay 配置。

ENVOY_TRACING_CFG_FILE 环境变量的自定义跟踪配置示例：

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

有关 samplingRuleManifest 属性中采样规则清单配置的详细信息，请参阅配置 X-Ray SDK for Go。