

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 아마존 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는 동일한 작업 또는 포드의 컨테이너에서 실행 중인 X-Ray 대몬(daemon)에 추적 데이터를 전송하도록 구성할 수 있는 Envoy 버전을 제공합니다. 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/ko_kr/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% 의 고정 샘플링 속도를 사용하고, 1.16.3 이전의 Envoy 버전에는 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 대몬(daemon)을 실행하는 방법에 대한 자세한 내용은 [Amazon ECS에서 X-Ray 대몬(daemon) 실행하기](xray-daemon-ecs.md) 단원을 참조하십시오. 서비스 메시, 마이크로서비스, Envoy 프록시 및 X-Ray 대몬(daemon)이 포함된 샘플 애플리케이션의 경우 App [Mesh Examples 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)