App Mesh 可觀測性疑難排解

確定 App Mesh Virtual Node 接聽程式通訊協定未設定為 TCP。

請確定與應用程式一起部署的 X-Ray 容器公開 UDP 連接埠2000並以使用者 身分執行1337。如需詳細資訊，請參閱 GitHub 上的 Amazon ECS X-Ray 範例。

確定 Envoy 容器已啟用追蹤。如果您使用的是 App Mesh Envoy 映像，您可以將ENABLE_ENVOY_XRAY_TRACING環境變數設定為 的值1，並將XRAY_DAEMON_PORT環境變數設定為 ，以啟用 X-Ray2000。

如果您已使用其中一種語言特定的 SDKs 在應用程式程式碼中檢測 X-Ray，則請依照語言的指南來確保設定正確。

如果先前所有項目都設定正確，請檢閱 X-Ray 容器日誌是否有錯誤，並遵循故障診斷 AWS X-Ray中的指引。如需 App Mesh 中 X-Ray 整合的更詳細說明，請參閱將 X-Ray 與 App Mesh 整合。

請確定您使用 App Mesh 的 CloudWatch 代理程式映像。如需詳細資訊，請參閱 GitHub 上的 App Mesh CloudWatch 代理程式。

請確定您已遵循平台特定的使用說明，適當地設定 App Mesh 的 CloudWatch 代理程式。如需詳細資訊，請參閱 GitHub 上的 App Mesh CloudWatch 代理程式。

如果先前所有項目都設定正確，請檢閱 CloudWatch 代理程式容器日誌是否有錯誤，並遵循 CloudWatch 代理程式疑難排解中提供的指引。

若要只設定取樣率，請使用 Envoy 容器上的 XRAY_SAMPLING_RATE環境變數。值應指定為介於 0和 1.00(100%) 之間的小數。如需詳細資訊，請參閱AWS X-Ray 變數。

若要設定 X-Ray 追蹤器的當地語系化自訂取樣規則，請使用 XRAY_SAMPLING_RULE_MANIFEST環境變數在 Envoy 容器檔案系統中指定檔案路徑。如需詳細資訊，請參閱《 AWS X-Ray 開發人員指南》中的取樣規則。

使用 ENVOY_TRACING_CFG_FILE環境變數來變更您的取樣率。如需詳細資訊，請參閱Envoy 組態變數。指定自訂追蹤組態並定義本機取樣規則。如需詳細資訊，請參閱 Envoy X-Ray 組態。

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 屬性中取樣規則資訊清單組態的詳細資訊，請參閱設定適用於 Go 的 X-Ray 開發套件。