本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon EC2 和 AWS App Mesh
<a name="xray-services-appmesh"></a>

AWS X-Ray 與 整合[AWS App Mesh](https://docs.aws.amazon.com/app-mesh/latest/userguide/what-is-app-mesh.html)，以管理微服務的 Envoy 代理。App Mesh 提供 Envoy 的版本，您可以設定此版本將追蹤資料傳送至在相同任務或 Pod 的容器中執行的 X-Ray 協助程式。X-Ray 支援使用下列 App Mesh 相容服務進行追蹤：
+ Amazon Elastic Container Service (Amazon ECS)
+ Amazon Elastic Kubernetes Service (Amazon EKS)
+ Amazon Elastic Compute Cloud (Amazon EC2)

使用以下指示，了解如何透過 App Mesh 來啟用 X-Ray 追蹤。

![追蹤映射，顯示用戶端與 App Mesh 服務之間的追蹤。](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/appmesh-traceContents.png)


若要設定 Envoy 代理將資料傳送至 X-Ray，請在其容器定義中設定`ENABLE_ENVOY_XRAY_TRACING`[環境變數](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy.html#envoy-config)。

**注意**  
Envoy 的 App Mesh 版本目前不會根據設定的[取樣規則](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-sampling.html)傳送追蹤。相反地，它使用 Envoy 1.16.3 版或更新版本的固定取樣率為 5%，或 Envoy 1.16.3 版之前的 50% 取樣率。

**Example Amazon ECS 的 Envoy 容器定義**  

```
{
      "name": "envoy",
      "image": "public.ecr.aws/appmesh/aws-appmesh-envoy:{{envoy-version}}",
      "essential": true,
      "environment": [
        {
          "name": "APPMESH_VIRTUAL_NODE_NAME",
          "value": "mesh/myMesh/virtualNode/myNode"
        },
        {
          "name": "ENABLE_ENVOY_XRAY_TRACING",
          "value": "1"
        }
      ],
      "healthCheck": {
        "command": [
          "CMD-SHELL",
          "curl -s http://localhost:9901/server_info | cut -d' ' -f3 | grep -q live"
        ],
        "startPeriod": 10,
        "interval": 5,
        "timeout": 2,
        "retries": 3
      }
```

**注意**  
若要進一步了解可用的 Envoy 區域地址，請參閱 AWS App Mesh 《 使用者指南》中的 [Envoy 映像](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy.html)。

如需在容器中執行 X-Ray 協助程式的詳細資訊，請參閱 [在 Amazon ECS 上執行 X-Ray 協助程式](xray-daemon-ecs.md)。對於包含服務網格、微服務、Envoy 代理和 X-Ray 協助程式的範例應用程式，請在 [App Mesh 範例 GitHub 儲存庫](https://github.com/aws/aws-app-mesh-examples/tree/master/examples)中部署`colorapp`範例。

**進一步了解**
+ [開始使用 AWS App Mesh](https://docs.aws.amazon.com/app-mesh/latest/userguide/getting_started.html)
+ [AWS App Mesh 和 Amazon ECS 入門](https://docs.aws.amazon.com/app-mesh/latest/userguide/mesh-getting-started-ecs.html)