메뉴 닫기

[Tech] AWS 콘솔에서 CloudWatch Agent 구성하기


본 포스팅에서는 EC2 지표 수집을 위한 에이전트인 CloudWatch Agent를 콘솔에서 구성하는 방법에 대해 다뤄보겠습니다.

Amazon CloudWatch란 AWS와 온프레미스, 기타 클라우드에서 리소스 및 애플리케이션을 관측하고 모니터링하는 서비스입니다.
이를 통해 서비스를 모니터링하고 성능 변화에 대응하거나 리소스 사용량을 최적화할 수도 있습니다.
특히 CloudWatch Agent를 통해 메모리, 디스크 등 다양한 시스템 수준와 애플리케이션의 사용자 지정 지표 수집 또한 가능합니다.

기존에는 CloudWatch Agent를 설치하기 위해 직접 에이전트 구성 파일을 작성하고, 설정 파일 저장 위치와 서비스 수동 시작 등의 작업을 일일히 해야했습니다.
물론 이러한 작업이 어렵거나 하는 것은 아니지만, 아직 AWS와 CLI, JSON 편집에 익숙치 않으신 분들에게는 꽤나 번거로운 작업일 수 있습니다.
따라서 해당 포스트는 이러한 분들을 위한 가이드가 되지 않을까 생각됩니다.


콘솔을 통해 EC2에 CloudWatch 에이전트를 설치하기 전, 다음과 같은 사전 조건이 있습니다.

  • SSM 에이전트 설치 및 온라인 상태
    – CloudWatch 에이전트는 SSM을 통해 원격 제어되므로 SSM 에이전트가 EC2에 사전에 설치되고 온라인 상태여야합니다.
  • 적절한 작업 권한을 가진 IAM 역할
    – EC2 인스턴스에 CloudWatch & SSM 관련 정책이 포함된 IAM 역할이 연결되어 있어야 합니다.
  • 네트워크 구성
    – 프라이빗 환경의 경우 VPC 엔드포인트 또는 NAT 게이트웨이가 필요합니다.


  1. CloudWatch 에이전트를 설치할 EC2를 선택하고 모니터링 탭에서 “CloudWatch 에이전트 구성” 버튼을 클릭합니다.


2. 구성을 시작하면 콘솔에서 작업 순서가 나타납니다. 다음을 눌러 단계를 진행합니다.


3. SSM 에이전트 검증 단계에서 SSM 에이전트 상태가 온라인이어야 합니다.
– 만약 오프라인 상태인 경우, EC2에 연결된 IAM 역할이나 보안 그룹 등 SSM 에이전트가 온라인이 되도록 먼저 문제를 해결해야 합니다.


4. IAM 권한 검증 단계입니다. 이 단계에서는 EC2에 CloudWatch Agent를 설치 및 구성에 필요한 적절한 IAM 권한이 있는지 확인합니다.
– AmazonSSMManagedInstanceCore / CloudWatchAgentServerPolicy 정책을 가진 IAM 역할이 권장됩니다.


5. CloudWatch 에이전트 검증 단계입니다. “CloudWatch 에이전트 설치” 버튼을 클릭하여 에이전트를 설치합니다.
– 만약 EC2에 CloudWatch 에이전트가 설치되지 않았거나 응답하지 않은 경우, 에이전트 설치를 시도합니다.


CloudWatch 에이전트 설치가 완료되면 “설치 완료“로 표시됩니다.


6. CloudWatch 에이전트가 설치되었다면, 에이전트 구성을 설정합니다.
– 먼저 지표 수집 빈도를 지정합니다.

지표 구성 항목에서는 에이전트가 어떤 지표들을 수집할 것인지 선택합니다. 각 리소스 별로 다양한 지표 설정이 가능합니다.

구성 작업을 완료하고 다음 단계로 넘어가면, 사용자가 설정한 구성을 CloudWatch에 전송합니다. “완료” 버튼을 눌러 에이전트 설치 작업을 완료합니다.


7. CloudWatch 에이전트가 성공적으로 설치되었다면, EC2 모니터링 탭에서 추가적으로 수집한 지표 항목이 나타납니다.
– 만약 에이전트의 구성을 수정하려는 경우, 위 작업을 동일하게 수행하고 구성 단계에서 설정을 변경하기만 하면됩니다.



이상으로 AWS 콘솔에서 CloudWatch 에이전트를 손쉽게 구성하는 방법에 대해 알아보았습니다.
만약 기존의 CloudWatch 에이전트 설정 작업이 익숙치 않거나 번거로우셨던 분들은, 콘솔에서 간단하게 설치 및 구성하는 방법을 진행해보시면 좋을 것 같습니다.

감사합니다.

📖 가이드 링크
CloudWatch 에이전트
CloudWatch 에이전트가 수집하는 지표
SSM Agent 문제 해결