

# 관련 원격 측정과 함께 CloudWatch 에이전트 사용
<a name="CloudWatch-Agent-RelatedEntities"></a>

CloudWatch로 전송되는 지표 및 로그에는 원격 측정의 상관관계를 분석하기 위한 선택적 엔터티가 포함될 수 있습니다. 엔터티는 [관련 내용 살펴보기](ExploreRelated.md) 창에서 사용됩니다. CloudWatch 에이전트는 서비스 이름과 환경 이름이 포함된 엔터티를 전송합니다.

에이전트는 아래의 데이터에서 서비스 이름과 환경 이름을 선택합니다.

**서비스 이름**

에이전트는 아래의 옵션 중에서 우선순위에 따라 서비스 이름을 선택합니다.
+ **Application Signals 계측** - 에이전트가 Application Signals에서 사용하는 서비스 이름을 전송합니다. 지원되는 OpenTelemetry 계측 라이브러리에서 사용하는 `OTEL_SERVICE_NAME` 환경 변수를 변경하여 이를 덮어쓸 수 있습니다.
+ **CloudWatch 에이전트 구성** - 특정 서비스 이름을 사용하도록 [에이전트를 구성](CloudWatch-Agent-configure-related-telemetry.md)할 수 있습니다. 이는 에이전트, 플러그인, 지표, 로그 또는 로그 파일 수준에서 구성할 수 있습니다.
+ **Kubernetes 워크로드 이름** - Kubernetes 워크로드의 경우, 에이전트는 해당 포드의 워크로드 이름을 다음과 같은 우선순위에 따라 전송합니다.
  + 배포 이름
  + ReplicaSet 이름
  + StatefulSet 이름
  + DaemonSet 이름
  + CronJob 이름
  + 작업 이름
  + 포드 이름
  + 컨테이너 이름
+ **인스턴스 메타데이터의 리소스 태그** - Amazon EC2 워크로드의 경우, 에이전트는 태그의 이름을 다음과 같은 순서로 전송합니다.
  + 서비스
  + 애플리케이션
  + 앱

  에이전트가 태그에 액세스할 수 있도록 하려면 [인스턴스 메타데이터를 설정](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS)해야 합니다.
+ **기본값** - 다른 서비스 이름을 찾을 수 없는 경우 에이전트는 이름을 `Unknown`으로 전송합니다.

**환경 이름**

에이전트는 아래의 옵션 중에서 우선순위에 따라 환경 이름을 선택합니다.
+ **Application Signals 계측** - 에이전트가 Application Signals에서 사용하는 환경 이름을 전송합니다. 지원되는 OpenTelemetry 계측 라이브러리에서 사용하는 `deployment.environment` 환경 변수를 설정하여 이를 덮어쓸 수 있습니다. 예를 들어 애플리케이션은 환경 변수 `OTEL_RESOURCE_ATTRIBUTES=deployment.environment=MyEnvironment`를 설정할 수 있습니다.
+ **CloudWatch 에이전트 구성** - 특정 환경 이름을 사용하도록 [에이전트를 구성](CloudWatch-Agent-configure-related-telemetry.md)할 수 있습니다. 이는 에이전트, 플러그인, 지표, 로그 또는 로그 파일 수준에서 구성할 수 있습니다.
+ **클러스터 이름 및 워크스페이스** - Amazon EKS의 경우 `eks:cluster-name/Namespace`이고, Amazon EC2에서 실행되는 네이티브 Kubernetes의 경우 `k8s:cluster-name/Namespace`입니다.
+ **인스턴스 메타데이터의 리소스 태그** - Amazon EC2 워크로드의 경우 에이전트가 `AutoScalingGroup` 태그를 사용할 수 있습니다.

  에이전트가 태그에 액세스할 수 있도록 하려면 [인스턴스 메타데이터를 설정](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS)해야 합니다.
+ 기본적으로, Kubernetes를 실행하지 않는 Amazon EC2 인스턴스는 환경 이름을 `ec2:default`로 가져옵니다.