기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 추적
**중요**
지원 종료 알림: 2026년 9월 30일에 AWS 는에 대한 지원을 중단합니다 AWS App Mesh. 2026년 9월 30일 이후에는 AWS App Mesh 콘솔 또는 AWS App Mesh 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은이 블로그 게시물 [Migrating from to Amazon ECS Service Connect를 참조 AWS App Mesh 하세요](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect).
**중요**
추적을 완전히 구현하려면 애플리케이션을 업데이트해야 합니다.
선택한 서비스에서 사용 가능한 모든 데이터를 보려면 해당 라이브러리를 사용하여 애플리케이션을 계측해야 합니다.
## AWS X-Ray로 App Mesh 모니터링
**중요**
지원 종료 알림: 2026년 9월 30일에 AWS 는에 대한 지원을 중단합니다 AWS App Mesh. 2026년 9월 30일 이후에는 AWS App Mesh 콘솔 또는 AWS App Mesh 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은이 블로그 게시물 [Migrating from to Amazon ECS Service Connect를 참조 AWS App Mesh 하세요](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect).
AWS X-Ray는 애플리케이션이 제공하는 요청에서 수집된 데이터를 보고, 필터링하고, 인사이트를 얻을 수 있는 도구를 제공하는 서비스입니다. 이러한 인사이트는 앱을 최적화할 수 있는 문제와 기회를 식별하는 데 도움이 됩니다. 요청과 응답, 애플리케이션이 다른 AWS 서비스에 대해 수행하는 다운스트림 호출에 대한 자세한 정보를 볼 수 있습니다.
X-Ray는 App Mesh와 통합되어 Envoy 마이크로서비스를 관리합니다. Envoy의 추적 데이터는 컨테이너에서 실행되는 X-Ray 대몬(daemon)으로 전송됩니다.
해당 언어에 맞는 [SDK](https://docs.aws.amazon.com/xray/index.html) 안내서를 사용하여 애플리케이션 코드에 X-Ray를 구현합니다.
### App Mesh를 통해 X-Ray 추적 활성화
+
**서비스 유형에 따라 다음을 수행합니다.**
+ **ECS -** Envoy 프록시 컨테이너 정의에서 `ENABLE_ENVOY_XRAY_TRACING` 환경 변수를 `1`으로 설정하고 `XRAY_DAEMON_PORT` 환경 변수를 `2000`으로 설정합니다.
+ **EKS -** App Mesh 컨트롤러 구성에서 `--set tracing.enabled=true` 및 `--set tracing.provider=x-ray`를 포함합니다.
+ X-Ray 컨테이너에서 포트 `2000`을 노출하고 사용자 `1337` 권한으로 실행합니다.
### X-Ray 예제
Amazon ECS용 Envoy 컨테이너 정의
```
{
"name": "envoy",
"image": "840364872350.dkr.ecr.us-west-2.amazonaws.com/aws-appmesh-envoy:v1.15.1.0-prod",
"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
}
```
Amazon EKS용 App Mesh 컨트롤러 업데이트
```
helm upgrade -i appmesh-controller eks/appmesh-controller \
--namespace appmesh-system \
--set region=${AWS_REGION} \
--set serviceAccount.create=false \
--set serviceAccount.name=appmesh-controller \
--set tracing.enabled=true \
--set tracing.provider=x-ray
```
### X-Ray 사용 방법 살펴보기
+ [AWS X-Ray로 모니터링](https://github.com/aws/aws-app-mesh-examples/tree/main/examples/apps/colorapp#monitor-with-aws-x-ray)
+ [Amazon EKS의 App Mesh - 관찰성: X-Ray](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-xray.md)
+ AWS App Mesh [Workhop](https://www.appmeshworkshop.com/introduction/)에서 [X-Ray를 사용한 분산 추적](https://www.appmeshworkshop.com/x-ray/)
### AWS X-Ray에 대해 자세히 알아보려면
+ [AWS X-Ray 설명서](https://docs.aws.amazon.com/xray/index.html)
### App Mesh를 사용한 AWS X-Ray 문제 해결
+ [내 애플리케이션에 대한 AWS X-Ray 추적을 볼 수 없습니다.](https://docs.aws.amazon.com/app-mesh/latest/userguide/troubleshoot-observability.html)
## Amazon EKS를 사용하는 App Mesh용 Jaeger
Jaeger는 오픈 소스의 엔드투엔드 분산 추적 시스템입니다. 네트워크를 프로파일링하고 모니터링하는 데 사용할 수 있습니다. Jaeger는 복잡한 클라우드 네이티브 애플리케이션 문제를 해결하는 데도 도움을 줄 수 있습니다.
Jaeger를 애플리케이션 코드로 구현하려면 Jaeger 설명서 [추적 라이브러리](https://www.jaegertracing.io/docs/1.21/client-libraries/)에서 해당 언어에 맞는 가이드를 찾을 수 있습니다.
### Helm을 사용하여 Jaeger 설치
1. Helm에 EKS 리포지토리를 추가합니다.
```
helm repo add eks https://aws.github.io/eks-charts
```
1. App Mesh Jaeger 설치
```
helm upgrade -i appmesh-jaeger eks/appmesh-jaeger \
--namespace appmesh-system
```
### Jaeger 예제
다음은 Jaeger용 `PersistentVolumeClaim` 영구 스토리지를 생성하는 예제입니다.
```
helm upgrade -i appmesh-controller eks/appmesh-controller \
--namespace appmesh-system \
--set tracing.enabled=true \
--set tracing.provider=jaeger \
--set tracing.address=appmesh-jaeger.appmesh-system \
--set tracing.port=9411
```
### Jaeger 사용 방법 살펴보기
+ [EKS를 사용한 App Mesh - 관찰성: Jaeger](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-jaeger.md)
### Jaeger에 대한 자세한 내용은 다음을 참조하세요.
+ [Jaeger 설명서](https://www.jaegertracing.io/)
## 추적용 Datadog
Datadog는 지표뿐만 아니라 추적에도 사용할 수 있습니다. 자세한 내용 및 설치 지침은 [Datadog 설명서](https://docs.datadoghq.com/tracing/setup_overview/)에서 애플리케이션 언어별 안내서를 참조하세요.