기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Envoy 구성 변수
**중요**
지원 종료 공지: 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).
다음 환경 변수를 사용하여 App Mesh 가상 노드 태스크 그룹의 Envoy 컨테이너를 구성합니다.
**참고**
App Mesh Envoy 1.17은 Envoy의 **v2 xDS** API를 지원하지 않습니다. Envoy 구성 파일을 허용하는 [Envoy 구성 변수](https://docs.aws.amazon.com/app-mesh/latest/userguide/envoy-config.html)를 사용하는 경우 해당 변수를 최신 **v3 xDS** API로 업데이트해야 합니다.
## 필수 변수
모든 App Mesh Envoy 컨테이너에는 다음과 같은 환경 변수가 필요합니다. 이 변수는 Envoy 이미지 `1.15.0` 이상 버전에서만 사용할 수 있습니다. 이전 버전의 이미지를 사용하는 경우 `APPMESH_VIRTUAL_NODE_NAME` 변수를 대신 설정해야 합니다.
`APPMESH_RESOURCE_ARN`
Envoy 컨테이너를 태스크 그룹에 추가할 때 이 환경 변수를 태스크 그룹이 나타내는 가상 노드 또는 가상 게이트웨이의 ARN으로 설정합니다. 다음 목록에는 예제 ARN이 포함되어 있습니다.
+ **가상 노드** – arn:aws:appmesh:{{Region-code}}:{{111122223333}}:mesh/{{meshName}}/virtualNode/{{virtualNodeName}}
+ **가상 게이트웨이** – arn:aws:appmesh:{{Region-code}}:{{111122223333}}:mesh/{{meshName}}/virtualGateway/{{virtualGatewayName}}
## 선택적 변수
App Mesh Envoy 컨테이너의 경우 다음 환경 변수는 선택 사항입니다.
`ENVOY_LOG_LEVEL`
Envoy 컨테이너의 로그 수준을 지정합니다.
유효한 값: `trace`, `debug`, `info`, `warn`, `error`, `critical`, `off`
기본값: `info`
`ENVOY_INITIAL_FETCH_TIMEOUT`
초기화 프로세스 중에 Envoy가 관리 서버의 첫 번째 구성 응답을 기다리는 시간을 지정합니다.
자세한 내용은 Envoy 설명서의 [구성 소스](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/config_source.proto#envoy-v3-api-field-config-core-v3-configsource-initial-fetch-timeout)를 읽어보세요. `0`으로 설정하면 제한 시간이 없습니다.
기본값: `0`
`ENVOY_CONCURRENCY`
Envoy를 시작하는 동안 `--concurrency` 명령줄 옵션을 설정합니다. 기본적으로 설정되어 있지 않습니다. 이 옵션은 Envoy 버전 `v1.24.0.0-prod` 이상에서 사용할 수 있습니다.
자세한 내용은 Envoy 설명서의 [명령줄 옵션](https://www.envoyproxy.io/docs/envoy/latest/operations/cli#cmdoption-concurrency)을 참조하세요.
### 관리 변수
이러한 환경 변수를 사용하여 Envoy의 관리 인터페이스를 구성합니다.
`ENVOY_ADMIN_ACCESS_PORT`
Envoy가 수신 대기할 사용자 지정 관리 포트를 지정합니다. 기본값: `9901`.
Envoy 관리자 포트는 가상 게이트웨이 또는 가상 노드의 리스너 포트와 달라야 합니다.
`ENVOY_ADMIN_ACCESS_LOG_FILE`
Envoy 액세스 로그를 쓸 사용자 지정 경로를 지정합니다. 기본값: `/tmp/envoy_admin_access.log`.
`ENVOY_ADMIN_ACCESS_ENABLE_IPV6`
Envoy의 관리 인터페이스가 `IPv6` 트래픽을 허용하도록 전환합니다. 그러면 이 인터페이스가 `IPv4` 및 `IPv6` 트래픽을 모두 수락할 수 있습니다. 기본적으로 이 플래그는 false로 설정되며 Envoy는 `IPv4` 트래픽만 수신합니다. 이 변수는 Envoy 이미지 버전 1.22.0 이상에서만 사용할 수 있습니다.
### Agent 변수
이러한 환경 변수를 사용하여 Envoy용 AWS App Mesh 에이전트를 구성합니다. 자세한 내용은 App Mesh [Agent for Envoy](https://docs.aws.amazon.com//app-mesh/latest/userguide/appnet-agent.html)를 참조하세요.
`APPNET_ENVOY_RESTART_COUNT`
Envoy 프록시 프로세스가 종료된 경우 이 Agent가 실행 중인 태스크 또는 포드 내에서 이 프로세스를 다시 시작하는 횟수를 지정합니다. 또한 이 Agent는 Envoy가 종료될 때마다 종료 상태를 기록하여 문제 해결을 용이하게 합니다. 이 변수의 기본값은 `0`입니다. 기본값이 설정된 경우 이 Agent는 프로세스를 다시 시작하려고 시도하지 않습니다.
기본값: `0`
최대: `10`
`PID_POLL_INTERVAL_MS`
Agent가 Envoy 프록시의 프로세스 상태를 확인하는 간격을 밀리초 단위로 지정합니다. 기본값은 `100`입니다.
기본값: `100`
최소: `100`
최대: `1000`
`LISTENER_DRAIN_WAIT_TIME_S`
Envoy 프록시가 프로세스 종료 전에 활성 연결이 닫힐 때까지 기다리는 시간을 초 단위로 지정합니다.
기본값: `20`
최소: `5`
최대: `110`
`APPNET_AGENT_ADMIN_MODE`
Agent의 관리 인터페이스 서버를 시작하고 tcp 주소 또는 Unix 소켓에 바인딩합니다.
유효값: `tcp`, `uds`
`APPNET_AGENT_HTTP_PORT`
Agent의 관리 인터페이스를 `tcp` 모드로 바인딩하는 데 사용할 포트를 지정합니다. `uid` \!= `0`인 경우 포트 값이 `1024`보다 큰지 확인합니다. 포트가 `65535`보다 작은지 확인합니다.
기본값: `9902`
`APPNET_AGENT_ADMIN_UDS_PATH`
`uds` 모드에서 Agent 관리 인터페이스의 Unix 도메인 소켓 경로를 지정합니다.
기본값: `/var/run/ecs/appnet_admin.sock`
### 추적 변수
다음 추적 드라이버를 전혀 구성하지 않거나 하나를 구성할 수 있습니다.
#### AWS X-Ray 변수
다음 환경 변수를 사용하여 AWS X-Ray으로 App Mesh를 구성합니다. 자세한 내용은 [ 개발자 안내서AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/)를 참조하세요.
`ENABLE_ENVOY_XRAY_TRACING`
`127.0.0.1:2000`을 기본 대몬(daemon) 엔드포인트로 사용하여 X-Ray 추적을 활성화합니다. 활성화하려면 값을 `1`로 설정합니다. 기본값은 `0`입니다.
`XRAY_DAEMON_PORT`
포트 값을 지정하여 기본 X-Ray 에이전트 포트 `2000`을 재정의합니다.
`XRAY_SAMPLING_RATE`
샘플링 속도를 지정하여 X-Ray 추적 프로그램의 기본 샘플링 속도인 `0.05`(5%)를 재정의합니다. 값을 `0`과 `1.00`(100%) 사이의 십진수로 지정합니다. `XRAY_SAMPLING_RULE_MANIFEST`를 지정하는 경우 이 값이 재정의됩니다. 이 변수는 Envoy 이미지 버전 `v1.19.1.1-prod` 이상에서 지원됩니다.
`XRAY_SAMPLING_RULE_MANIFEST`
Envoy 컨테이너 파일 시스템에서 파일 경로를 지정하여 X-Ray 추적 프로그램에 대한 현지화된 사용자 지정 샘플링 규칙을 구성합니다. 자세한 내용은AWS X-Ray 개발자 안내서**의 [샘플링 규칙](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling)을 참조하세요. 이 변수는 Envoy 이미지 버전 `v1.19.1.0-prod` 이상에서 지원됩니다.
`XRAY_SEGMENT_NAME`
추적 프로그램의 세그먼트 이름을 지정하여 기본 X-Ray 세그먼트 이름을 재정의합니다. 기본적으로 이 값은 `mesh/resourceName`으로 설정됩니다. 이 변수는 Envoy 이미지 버전 `v1.23.1.0-prod` 이상에서 지원됩니다.
#### Datadog 추적 변수
다음 환경 변수는 Datadog 에이전트 추적 프로그램을 사용하여 App Mesh를 구성하는 데 도움이 됩니다. 자세한 내용을 알아보려면 Datadog 설명서의 [Agent 구성](https://docs.datadoghq.com/tracing/send_traces/)을 참조하세요.
`ENABLE_ENVOY_DATADOG_TRACING`
`127.0.0.1:8126`을 기본 Datadog 에이전트 엔드포인트로 사용하여 Datadog 추적 수집을 활성화합니다. 활성화하려면 값을 `1`(기본값: `0`)로 설정합니다.
`DATADOG_TRACER_PORT`
포트 값을 지정하여 기본 Datadog 에이전트 포트 `8126`을 재정의합니다.
`DATADOG_TRACER_ADDRESS`
IP 주소를 지정하여 기본 Datadog 에이전트 주소 `127.0.0.1`을 재정의합니다.
`DD_SERVICE`
추적의 서비스 이름을 지정하여 기본 DataDog 서비스 이름 `envoy-meshName`/`virtualNodeName`을 재정의합니다. 이 변수는 Envoy 이미지 버전 `v1.18.3.0-prod` 이상에서 지원됩니다.
#### Jaeger 추적 변수
다음 환경 변수를 사용하여 Jaeger 추적으로 App Mesh를 구성합니다. 자세한 내용은 Jaeger 설명서의 [시작하기](https://www.jaegertracing.io/docs/1.21/getting-started/)를 참조하세요. 이러한 변수는 Envoy 이미지 버전 `1.16.1.0-prod` 이상에서 지원됩니다.
`ENABLE_ENVOY_JAEGER_TRACING`
`127.0.0.1:9411`을 기본 Jaeger 엔드포인트로 사용하여 Jaeger 추적 수집을 활성화합니다. 활성화하려면 값을 `1`(기본값: `0`)로 설정합니다.
`JAEGER_TRACER_PORT`
포트 값을 지정하여 기본 Jaeger 포트 `9411`을 재정의합니다.
`JAEGER_TRACER_ADDRESS`
IP 주소를 지정하여 기본 Jaeger 주소 `127.0.0.1`을 재정의합니다.
`JAEGER_TRACER_VERSION`
수집기에 `JSON` 또는 `PROTO` 인코딩 형식의 추적이 필요한지 여부를 지정합니다. 기본적으로 이 값은 `PROTO`로 설정됩니다. 이 변수는 Envoy 이미지 버전 `v1.23.1.0-prod` 이상에서 지원됩니다.
#### Envoy 추적 변수
자체 추적 구성을 사용하도록 다음 환경 변수를 설정합니다.
`ENVOY_TRACING_CFG_FILE`
Envoy 컨테이너 파일 시스템에서 파일 경로를 지정합니다. 자세한 내용은 Envoy 설명서의 [https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/http_tracer.proto#envoy-v3-api-msg-config-trace-v3-tracing](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/http_tracer.proto#envoy-v3-api-msg-config-trace-v3-tracing)을 참조하세요.
추적 구성에 추적 클러스터를 지정해야 하는 경우 동일한 추적 구성 파일의 `static_resources`에서 관련 클러스터 구성을 구성해야 합니다. 예를 들어 Zipkin에는 추적 수집기를 호스팅하는 클러스터 이름에 대한 [https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/zipkin.proto#config-trace-v3-zipkinconfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/zipkin.proto#config-trace-v3-zipkinconfig) 필드가 있으며 해당 클러스터를 정적으로 정의해야 합니다.
### DogStatsD 변수
다음 환경 변수를 사용하여 DogStatsD로 App Mesh를 구성합니다. 자세한 내용은 [DogStatsD](https://docs.datadoghq.com/developers/dogstatsd/) 설명서를 참조하세요.
`ENABLE_ENVOY_DOG_STATSD`
`127.0.0.1:8125`를 기본 대몬(daemon) 엔드포인트로 사용하여 DogStatSD 통계를 활성화합니다. 활성화하려면 값을 `1`로 설정합니다.
`STATSD_PORT`
포트 값을 지정하여 기본 DogStatd 대몬(daemon) 포트를 재정의합니다.
`STATSD_ADDRESS`
IP 주소 값을 지정하여 기본 DogStatd 대몬(daemon) IP 주소를 재정의합니다. 기본값: `127.0.0.1`. 이 변수는 Envoy 이미지 `1.15.0` 이상 버전에서만 사용할 수 있습니다.
`STATSD_SOCKET_PATH`
DogStatd 대몬(daemon)의 UNIX 도메인 소켓을 지정합니다. 이 변수를 지정하지 않고 DogStatsD를 활성화한 경우, 이 값의 기본값은 DogStatd 대몬(daemon) IP 주소 포트 `127.0.0.1:8125`입니다. 통계 싱크 구성을 포함하는 `ENVOY_STATS_SINKS_CFG_FILE` 변수를 지정하면 모든 DogStatd 변수를 재정의합니다. 이 변수는 Envoy 이미지 버전 `v1.19.1.0-prod` 이상에서 지원됩니다.
### App Mesh 변수
다음 변수는 App Mesh를 구성하는 데 도움이 됩니다.
`APPMESH_RESOURCE_CLUSTER`
기본적으로 App Mesh는 Envoy가 지표 및 트레이스에서 자신을 참조할 때 `APPMESH_RESOURCE_ARN`에서 지정한 리소스의 이름을 사용합니다. `APPMESH_RESOURCE_CLUSTER` 환경 변수를 사용자 고유의 이름으로 설정하여 이 동작을 재정의할 수 있습니다. 이 변수는 Envoy 이미지 `1.15.0` 이상 버전에서만 사용할 수 있습니다.
`APPMESH_METRIC_EXTENSION_VERSION`
값을 `1`으로 설정하여 App Mesh 지표 확장을 활성화합니다. App Mesh 지표 확장 사용에 대한 자세한 내용은 [App Mesh의 지표 확장](metrics.md) 섹션을 참조하세요.
`APPMESH_DUALSTACK_ENDPOINT`
값을 `1`으로 설정하여 App Mesh Dual Stack 엔드포인트에 연결합니다. 이 플래그가 설정되면 Envoy는 이중 스택 지원 도메인을 사용합니다. 기본적으로 이 플래그는 false로 설정되며 `IPv4` 도메인에만 연결됩니다. 이 변수는 Envoy 이미지 버전 1.22.0 이상에서만 사용할 수 있습니다.
### Envoy 통계 변수
다음 환경 변수를 사용하여 Envoy 통계로 App Mesh를 구성할 수 있습니다. 자세한 내용은 [Envoy 통계](https://www.envoyproxy.io/docs/envoy/v1.6.0/api-v2/config/metrics/v2/stats.proto) 설명서를 참조하세요.
`ENABLE_ENVOY_STATS_TAGS`
App Mesh에서 정의한 태그 `appmesh.mesh` 및 `appmesh.virtual_node`를 사용할 수 있도록 합니다. 자세한 내용은 Envoy 설명서의 [config.metrics.v3.TagSpecifier](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-tagspecifier)를 참조하세요. 활성화하려면 값을 `1`로 설정합니다.
`ENVOY_STATS_CONFIG_FILE`
Envoy 컨테이너 파일 시스템에서 파일 경로를 지정하여 기본 통계 태그 구성 파일을 사용자 고유의 구성 파일로 재정의합니다. 자세한 내용은 [config.metrics.v3.statsConfig](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statsconfig)를 참조하세요.
통계 필터가 포함된 사용자 지정 통계 구성을 설정하면 Envoy가 더 이상 사용자 환경의 App Mesh 상태와 제대로 동기화되지 않는 상태가 될 수 있습니다. 이것이 Envoy의 [버그](https://github.com/envoyproxy/envoy/issues/9856)입니다. Envoy에서 통계 필터링을 수행하지 않는 것이 좋습니다. 필터링이 꼭 필요한 경우 로드맵에 이 [문제](https://github.com/aws/aws-app-mesh-roadmap/issues/283)의 몇 가지 해결 방법을 나열했습니다.
`ENVOY_STATS_SINKS_CFG_FILE`
Envoy 컨테이너 파일 시스템에서 파일 경로를 지정하여 기본 구성을 사용자 고유의 구성 파일로 재정의합니다. 자세한 내용은 Envoy 설명서의 [config.metrics.v3.StatsSink](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/metrics/v3/stats.proto#config-metrics-v3-statssink)를 참조하세요.
### 더 이상 사용되지 않는 변수
환경 변수는 `APPMESH_VIRTUAL_NODE_NAME` 및 `APPMESH_RESOURCE_NAME`은 Envoy 버전 `1.15.0` 이상에서 더 이상 지원되지 않습니다. 하지만 기존 메시에서는 여전히 지원됩니다. Envoy 버전 `1.15.0` 이상에서 이러한 변수를 사용하는 대신, 모든 App Mesh 엔드포인트에 `APPMESH_RESOURCE_ARN`을 사용하세요.