자동탐지 템플릿 변수

자동탐지를 설정할 때 다음의 템플릿 변수를 사용해 동적으로 컨테이너 값을 할당하세요.

템플릿 변수설명
"%%host%%"네트워크를 자동으로 탐지합니다. 싱글 네트워크 컨테이너의 경우, 해당하는 IP를 반환합니다.
"%%host_<NETWORK NAME>%%"여러 네트워크에 연결된 경우, 사용할 네트워크 이름을 특정합니다.
"%%port%%"숫자 오름차순으로 정렬했을 때, 가장 많이 노출된 포트를 사용합니다.
예를 들어 포트 80, 443, 8443을 노출하는 컨테이너의 경우 8443을 반환합니다.
"%%port_<NUMBER_X>%%"숫자 오름차순으로 정렬해 <NUMBER_X> 포트를 사용합니다.
예를 들어 컨테이너가 포트 80, 443, 8443을 노출하는 경우 "%%port_0%%는 포트 80을, "%%port_1%%"은 443을 참조합니다.
"%%port_<NAME>%%"포트 이름 <NAME>과 연관된 포트를 사용합니다.
"%%pid%%"docker inspect --format '{{.State.Pid}}' <CONTAINER_NAME>에서 반환하는 컨테이너 프로세스 ID를 가져옵니다.
"%%hostname%%"hostname 값을 컨테이너 설정에서 가져옵니다. "%%host%%" 변수가 신뢰할 수 있는 IP를(예: ECS awsvpc mode) 가져올 수 없는 경우에만 사용합니다.
"%%env_<ENV_VAR>%%"{TX-PL-LABEL}lt;ENV_VAR> 환경 변수의 요소를 Agent 프로세스에 표시된 대로 사용합니다.
"%%kube_namespace%%"쿠버네티스(Kubernetes) 네임스페이스를 자동 탐지합니다.
"%%kube_pod_name%%"쿠버네티스 팟 이름을 자동 탐지합니다.
"%%kube_pod_uid%%"쿠버네티스 팟 UID를 자동 탐지합니다.

폴백(Fall back):

  • "%%host%%" 템플릿 변수: Agent가 찾지 못하는 경우, 이 템플릿 변수는 bridge 네트워크 IP로 폴백합니다.
  • "%%host_<NETWORK NAME>%%": 특정된 <NETWORK_NAME>을 찾을 수 없는 경우 템플릿 변수는 "%%host%%"처럼 작동합니다.

사용하는 플랫폼에 따라 지원되지 않는 탬플릿 변수가 있을 수 있습니다.

플랫폼자동탐지 식별자호스트포트태그PidEnv호스트네임쿠버네티스 네임스페이스팟 이름팟 UID
도커(Docker)✅✅✅✅✅✅✅❌❌❌
ECS Fargate✅✅❌✅❌✅❌❌❌❌
쿠버네티스(Kubernetes)✅✅✅✅❌✅❌✅✅✅

참고 자료

Additional helpful documentation, links, and articles:

자동탐지 통합 템플릿 생성 및 불러오기설명서 more more 해당하는 통합 템플릿과 컨테이너 매치하기설명서 more more Agent 자동탐지에 포함할 컨테이너 관리하기설명서 more more