관련 원격 측정과 함께 CloudWatch 에이전트 사용 - Amazon CloudWatch

관련 원격 측정과 함께 CloudWatch 에이전트 사용

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

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

서비스 이름

에이전트는 아래의 옵션 중에서 우선순위에 따라 서비스 이름을 선택합니다.

  • Application Signals 계측 - 에이전트가 Application Signals에서 사용하는 서비스 이름을 전송합니다. 지원되는 OpenTelemetry 계측 라이브러리에서 사용하는 OTEL_SERVICE_NAME 환경 변수를 변경하여 이를 덮어쓸 수 있습니다.

  • CloudWatch 에이전트 구성 - 특정 서비스 이름을 사용하도록 에이전트를 구성할 수 있습니다. 이는 에이전트, 플러그인, 지표, 로그 또는 로그 파일 수준에서 구성할 수 있습니다.

  • Kubernetes 워크로드 이름 - Kubernetes 워크로드의 경우, 에이전트는 해당 포드의 워크로드 이름을 다음과 같은 우선순위에 따라 전송합니다.

    • 배포 이름

    • ReplicaSet 이름

    • StatefulSet 이름

    • DaemonSet 이름

    • CronJob 이름

    • 작업 이름

    • 포드 이름

    • 컨테이너 이름

  • 인스턴스 메타데이터의 리소스 태그 - Amazon EC2 워크로드의 경우, 에이전트는 태그의 이름을 다음과 같은 순서로 전송합니다.

    • 서비스

    • 애플리케이션

    에이전트가 태그에 액세스할 수 있도록 하려면 인스턴스 메타데이터를 설정해야 합니다.

  • 기본값 - 다른 서비스 이름을 찾을 수 없는 경우 에이전트는 이름을 Unknown으로 전송합니다.

환경 이름

에이전트는 아래의 옵션 중에서 우선순위에 따라 환경 이름을 선택합니다.

  • Application Signals 계측 - 에이전트가 Application Signals에서 사용하는 환경 이름을 전송합니다. 지원되는 OpenTelemetry 계측 라이브러리에서 사용하는 deployment.environment 환경 변수를 설정하여 이를 덮어쓸 수 있습니다. 예를 들어 애플리케이션은 환경 변수 OTEL_RESOURCE_ATTRIBUTES=deployment.environment=MyEnvironment를 설정할 수 있습니다.

  • CloudWatch 에이전트 구성 - 특정 환경 이름을 사용하도록 에이전트를 구성할 수 있습니다. 이는 에이전트, 플러그인, 지표, 로그 또는 로그 파일 수준에서 구성할 수 있습니다.

  • 클러스터 이름 및 워크스페이스 - Amazon EKS의 경우 eks:cluster-name/Namespace이고, Amazon EC2에서 실행되는 네이티브 Kubernetes의 경우 k8s:cluster-name/Namespace입니다.

  • 인스턴스 메타데이터의 리소스 태그 - Amazon EC2 워크로드의 경우 에이전트가 AutoScalingGroup 태그를 사용할 수 있습니다.

    에이전트가 태그에 액세스할 수 있도록 하려면 인스턴스 메타데이터를 설정해야 합니다.

  • 기본적으로, Kubernetes를 실행하지 않는 Amazon EC2 인스턴스는 환경 이름을 ec2:default로 가져옵니다.