기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 지표 내보내기
**중요**
지원 종료 알림: 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).
Envoy는 자체 운영과 인바운드 및 아웃바운드 트래픽의 다양한 측정기준에 대한 많은 통계를 내보냅니다. Envoy 통계에 대한 자세한 내용은 Envoy 설명서의 [통계](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/observability/statistics)를 참조하세요. 이러한 지표는 일반적으로 `9901`인 프록시의 관리 포트에 있는 `/stats` 엔드포인트를 통해 사용할 수 있습니다.
단일 리스터를 사용하는지 또는 여러 리스너를 사용하는지에 따라 `stat` 접두사가 달라집니다. 다음은 차이점을 보여 주는 몇 가지 예입니다.
**주의**
단일 리스너를 다중 리스너 기능으로 업데이트하면 다음 표에 나와 있는 업데이트된 통계 접두사로 인해 주요 변경 사항이 발생할 수 있습니다.
Envoy 이미지 `1.22.2.1-prod` 이상을 사용하는 것이 좋습니다. 이렇게 하면 Prometheus 엔드포인트에서 유사한 메트릭 이름을 볼 수 있습니다.
| 단일 리스너(SL)/“ingress” 리스너 접두사가 붙은 기존 통계 | 다중 리스터(ML)/"ingress.." 리스너 접두사가 붙은 새 통계 |
| --- | --- |
| `http.*ingress*.rds.rds_ingress_http_5555.version_text` | `http.*ingress.http.5555*.rds.rds_ingress_http_5555.version_text` `http.*ingress.http.6666*.rds.rds_ingress_http_6666.version_text` |
| `listener.0.0.0.0_15000.http.*ingress*.downstream_rq_2xx` | `listener.0.0.0.0_15000.http.*ingress.http.5555*.downstream_rq_2xx` `listener.0.0.0.0_15000.http.*ingress.http.6666*.downstream_rq_2xx` |
| `http.*ingress*.downstream_cx_length_ms` | `http.*ingress.http.5555*.downstream_cx_length_ms` `http.*ingress.http.6666*.downstream_cx_length_ms` |
통계 엔드포인트에 대한 자세한 내용은 Envoy 설명서의 [통계 엔드포인트](https://www.envoyproxy.io/docs/envoy/latest/operations/admin#get--stats)를 참조하세요. 관리 인터페이스에 대한 자세한 내용은 [Envoy 프록시 관리 인터페이스 활성화](troubleshooting-best-practices.md#ts-bp-enable-proxy-admin-interface) 섹션을 참조하세요.
## Amazon EKS를 포함하는 App Mesh용 Prometheus
**중요**
지원 종료 알림: 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).
Prometheus는 오픈 소스 모니터링 및 알림 도구 키트입니다. 해당 기능 중 하나는 다른 시스템에서 사용할 수 있는 지표를 내보내는 형식을 지정하는 것입니다. Prometheus에 대한 자세한 내용은 Prometheus 설명서의 [개요](https://prometheus.io/docs/introduction/overview/)를 참조하세요. Envoy는 파라미터 `/stats?format=prometheus`를 전달하여 통계 엔드포인트를 통해 지표를 내보낼 수 있습니다.
Envoy 이미지 빌드 v1.22.2.1-prod를 사용하는 고객의 경우 수신 리스너별 통계를 나타내는 두 가지 추가 측정기준이 있습니다.
+ `appmesh.listener_protocol`
+ `appmesh.listener_port`
아래는 Prometheus의 기존 통계와 새 통계를 비교한 것입니다.
+ “수신” 리스너 접두사가 붙은 기존 통계
```
envoy_http_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",envoy_http_conn_manager_prefix="ingress"} 931433
```
+ "ingress.." \$1 Appmesh Envoy Image v1.22.2.1-prod 이상이 있는 새 통계
```
envoy_http_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",appmesh_listener_protocol="http",appmesh_listener_port="5555",envoy_http_conn_manager_prefix="ingress"} 20
```
+ "ingress.." \$1 사용자 지정 Envoy Imagebuild가 있는 새 통계
```
envoy_http_http_5555_downstream_rq_xx{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_node="foodteller-vn",envoy_response_code_class="2",envoy_http_conn_manager_prefix="ingress"} 15983
```
여러 리스너의 경우 `cds_ingress___self_redirect___` 특수 클러스터는 리스너별로 다릅니다.
+ “수신” 리스너 접두사가 붙은 기존 통계
```
envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",Mesh="multiple-listeners-mesh",VirtualGateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_http_15001"} 0
```
+ "ingress.."가 있는 새 통계
```
envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_1111_http_15001"} 0
envoy_cluster_assignment_stale{appmesh_mesh="multiple-listeners-mesh",appmesh_virtual_gateway="tellergateway-vg",envoy_cluster_name="cds_ingress_multiple-listeners-mesh_tellergateway-vg_self_redirect_2222_http_15001"} 0
```
### Prometheus 설치
1. Helm에 EKS 리포지토리를 추가합니다.
```
helm repo add eks https://aws.github.io/eks-charts
```
1. App Mesh Prometheus 설치
```
helm upgrade -i appmesh-prometheus eks/appmesh-prometheus \
--namespace appmesh-system
```
### Prometheus 예제
다음은 Prometheus용 `PersistentVolumeClaim` 영구 스토리지를 생성하는 예제입니다.
```
helm upgrade -i appmesh-prometheus eks/appmesh-prometheus \
--namespace appmesh-system \
--set retention=12h \
--set persistentVolumeClaim.claimName=prometheus
```
### Prometheus 사용 방법 살펴보기
+ [EKS를 사용한 App Mesh - 관찰성: Prometheus](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-prometheus.md)
### Prometheus 및 Amazon EKS를 포함하는 Prometheus에 대해 자세히 알아보려면 다음을 참조하세요.
+ [Prometheus 설명서](https://prometheus.io/docs/introduction/overview/)
+ **EKS -** [Prometheus의 제어 영역 지표](https://docs.aws.amazon.com/eks/latest/userguide/prometheus.html)
## App Mesh용 CloudWatch
**중요**
지원 종료 알림: 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).
**Envoy 통계를 Amazon EKS에서 CloudWatch로 내보내기**
클러스터에 CloudWatch Agent를 설치하고 프록시에서 지표의 하위 세트를 수집하도록 구성할 수 있습니다. Amazon EKS 클러스터가 아직 없는 경우 GitHub에서 [살펴보기: Amazon EKS를 포함하는 App Mesh](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/eks)의 단계에 따라 클러스터를 생성할 수 있습니다. 동일한 안내를 따라 클러스터에 샘플 애플리케이션을 설치할 수 있습니다.
클러스터에 대해 적절한 IAM 권한을 설정하고 에이전트를 설치하려면 [Prometheus 지표 수집과 함께 CloudWatch Agent 설치](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-Setup.html)의 단계를 따르세요. 기본 설치에는 Envoy 통계의 유용한 하위 세트를 가져오는 Prometheus 수집 구성이 포함되어 있습니다. 자세한 내용은 [App Mesh용 Prometheus 지표](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-metrics.html#ContainerInsights-Prometheus-metrics-appmesh)를 참조하세요.
에이전트가 수집하는 지표를 표시하도록 구성된 App Mesh 사용자 지정 CloudWatch 대시보드를 생성하려면 [Prometheus 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-viewmetrics.html) 자습서의 단계를 따르세요. 트래픽이 App Mesh 애플리케이션으로 유입되면 그래프가 해당 지표로 채워지기 시작합니다.
### CloudWatch의 지표 필터링
App Mesh [지표 확장](https://docs.aws.amazon.com/app-mesh/latest/userguide/metrics.html#metrics-extension)은 메시에서 정의한 리소스의 동작에 대한 인사이트를 제공하는 유용한 지표의 하위 세트를 제공합니다. CloudWatch 에이전트는 Prometheus 지표 수집을 지원하므로, Envoy에서 가져와서 CloudWatch로 전송할 지표를 선택하는 수집 구성을 제공할 수 있습니다.
Prometheus를 사용하여 지표를 스크랩하는 예제는 [지표 확장](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/howto-metrics-extension-ecs) 안내에서 확인할 수 있습니다.
### CloudWatch 예제
[AWS 샘플 리포지토리](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent)에서 CloudWatch의 샘플 구성을 찾을 수 있습니다.
### CloudWatch 사용 방법 살펴보기
+ [App Mesh 워크샵](https://www.appmeshworkshop.com/introduction/)의 [모니터링 및 로깅 기능 추가](https://www.appmeshworkshop.com/monitoring/)
+ [EKS를 사용한 App Mesh - 관찰성: CloudWatch](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/eks/o11y-cloudwatch.md)
+ [ECS의 App Mesh 지표 확장 사용](https://github.com/aws/aws-app-mesh-examples/tree/main/walkthroughs/howto-metrics-extension-ecs)
## 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).
Envoy는 수백 개의 지표를 몇 가지 다른 측정기준으로 세분화하여 생성합니다. 지표가 App Mesh와 연관되는 방식은 간단하지 않습니다. 가상 서비스의 경우 어떤 가상 서비스가 특정 가상 노드나 가상 게이트웨이와 통신하고 있는지 확인할 수 있는 메커니즘이 없습니다.
App Mesh 지표 확장은 메시에서 실행되는 Envoy 프록시를 개선합니다. 이러한 개선을 통해 프록시는 사용자가 정의한 리소스를 인식하는 추가 지표를 내보낼 수 있습니다. 이 소규모 추가 지표 세트는 App Mesh에서 정의한 리소스의 동작에 대한 더 나은 인사이트를 얻는 데 도움이 됩니다.
App Mesh 지표 확장을 활성화하려면 환경 변수 `APPMESH_METRIC_EXTENSION_VERSION`을 `1`로 설정합니다.
```
APPMESH_METRIC_EXTENSION_VERSION=1
```
Envoy 구성 변수에 대한 자세한 내용은 [Envoy 구성 변수](envoy-config.md) 섹션을 참조하세요.
### 인바운드 트래픽 관련 지표
+ `ActiveConnectionCount`
+ `envoy.appmesh.ActiveConnectionCount` - 활성 TCP 연결의 수.
+ *측정기준* - Mesh, VirtualNode, VirtualGateway
+ **`NewConnectionCount`**
+ `envoy.appmesh.NewConnectionCount` - 총 TCP 연결 수.
+ *측정기준* - Mesh, VirtualNode, VirtualGateway
+ **`ProcessedBytes`**
+ `envoy.appmesh.ProcessedBytes` - 다운스트림 클라이언트에서 전송 및 수신한 총 TCP 바이트 수.
+ *측정기준* - Mesh, VirtualNode, VirtualGateway
+ **`RequestCount`**
+ `envoy.appmesh.RequestCount` - 처리된 HTTP 요청 수.
+ *측정기준* - Mesh, VirtualNode, VirtualGateway
+ **`GrpcRequestCount`**
+ `envoy.appmesh.GrpcRequestCount` - 처리된 gPRC 요청 수.
+ *측정기준* - Mesh, VirtualNode, VirtualGateway
### 아웃바운드 트래픽과 관련된 지표
가상 노드 또는 가상 게이트웨이 중에서 아웃바운드 지표를 가져온 소스에 따라 다양한 측정기준이 표시됩니다.
+ `TargetProcessedBytes`
+ `envoy.appmesh.TargetProcessedBytes` - Envoy의 대상 업스트림에서 전송 및 수신된 총 TCP 바이트 수입니다.
+
*측정기준*:
+ 가상 노드 측정기준 - Mesh, VirtualNode, TargetVirtualService, TargetVirtualNode
+ 가상 게이트웨이 측정기준 - Mesh, VirtualGateway, TargetVirtualService, TargetVirtualNode
+ **`HTTPCode_Target_2XX_Count`**
+ `envoy.appmesh.HTTPCode_Target_2XX_Count` - Envoy의 대상 업스트림에 대한 HTTP 요청 중에서 2xx HTTP 응답을 받은 요청 수입니다.
+
*측정기준*:
+ 가상 노드 측정기준 - Mesh, VirtualNode, TargetVirtualService, TargetVirtualNode
+ 가상 게이트웨이 측정기준 - Mesh, VirtualGateway, TargetVirtualService, TargetVirtualNode
+ **`HTTPCode_Target_3XX_Count`**
+ `envoy.appmesh.HTTPCode_Target_3XX_Count` - Envoy의 대상 업스트림에 대한 HTTP 요청 중에서 3xx HTTP 응답을 받은 요청 수입니다.
+
*측정기준*:
+ 가상 노드 측정기준 - Mesh, VirtualNode, TargetVirtualService, TargetVirtualNode
+ 가상 게이트웨이 측정기준 - Mesh, VirtualGateway, TargetVirtualService, TargetVirtualNode
+ **`HTTPCode_Target_4XX_Count`**
+ `envoy.appmesh.HTTPCode_Target_4XX_Count` - Envoy의 대상 업스트림에 대한 HTTP 요청 중에서 4xx HTTP 응답을 받은 요청 수입니다.
+
*측정기준*:
+ 가상 노드 측정기준 - Mesh, VirtualNode, TargetVirtualService, TargetVirtualNode
+ 가상 게이트웨이 측정기준 - Mesh, VirtualGateway, TargetVirtualService, TargetVirtualNode
+ **`HTTPCode_Target_5XX_Count`**
+ `envoy.appmesh.HTTPCode_Target_5XX_Count` - Envoy의 대상 업스트림에 대한 HTTP 요청 중에서 5xx HTTP 응답을 받은 요청 수입니다.
+
*측정기준*:
+ 가상 노드 측정기준 - Mesh, VirtualNode, TargetVirtualService, TargetVirtualNode
+ 가상 게이트웨이 측정기준 - Mesh, VirtualGateway, TargetVirtualService, TargetVirtualNode
+ **`RequestCountPerTarget`**
+ `envoy.appmesh.RequestCountPerTarget` - Envoy의 대상 업스트림으로 전송된 요청 수입니다.
+
*측정기준*:
+ 가상 노드 측정기준 - Mesh, VirtualNode, TargetVirtualService, TargetVirtualNode
+ 가상 게이트웨이 측정기준 - Mesh, VirtualGateway, TargetVirtualService, TargetVirtualNode
+ **`TargetResponseTime`**
+ `envoy.appmesh.TargetResponseTime` - Envoy의 대상 업스트림에 요청을 보낸 시점부터 전체 응답을 받을 때까지 소요된 시간입니다.
+
*측정기준*:
+ 가상 노드 측정기준 - Mesh, VirtualNode, TargetVirtualService, TargetVirtualNode
+ 가상 게이트웨이 측정기준 - Mesh, VirtualGateway, TargetVirtualService, TargetVirtualNode
## App Mesh용 Datadog
**중요**
지원 종료 알림: 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).
Datadog은 클라우드 애플리케이션의 엔드투엔드 모니터링, 지표 및 로깅을 위한 모니터링 및 보안 애플리케이션입니다. Datadog을 사용하면 인프라, 애플리케이션 및 타사 애플리케이션을 완벽하게 관찰할 수 있습니다.
### Datadog 설치
+ EKS - EKS로 Datadog을 설정하려면 [Datadog 설명서](https://docs.datadoghq.com/integrations/amazon_app_mesh/?tab=eks)의 다음 단계를 따르세요.
+ ECS EC2 - ECS EC2로 Datadog을 설정하려면 [Datadog 설명서](https://docs.datadoghq.com/integrations/amazon_app_mesh/?tab=ecsec2)의 다음 단계를 따르세요.
### Datadog에 대해 자세히 알아보려면 다음을 참조하세요.
+ [Datadog 설명서](https://docs.datadoghq.com/)