개요

• System Management(ssm)을 이용해 EC2 Instance에 CloudWatch Agent를 설치하는 방법에 대해 알아봅시다.

인스턴스에 CloudWatch Agent 설치하기

1. 인스턴스를 위한 역할 생성

1. IAM 콘솔> 역할 > 역할 생성

2. 신뢰할 수 있는 엔터티 유형: AWS 서비스
   일반 사용 사례: EC2를 선택
   

3. 정책 목록에서 CloudWatchAgentServerPolicy 옆의 확인란을 선택합니다.
   

4. Systems Manager(ssm)를 사용하여 CloudWatch Agent를 설치하거나 구성하려면 AmazonSSMManagedInstanceCore 옆의 확인란을 선택합니다.
   

5. 역할 이름을 입력합니다.
   

2. 인스턴스에 역할 부여

• 인스턴스에 역할을 부여합니다.
  

3. 인스턴스에 ssm 접근 후 CloudWatch Agent 설치

!중요
SSM Agent는 다음 Amazon Machine Images(AMIs)에 기본적으로 설치됩니다.

• Amazon Linux
• Amazon Linux 2
• Amazon Linux 2 ECS 최적화 기본 AMIs
• SUSE Linux Enterprise Server(SLES) 12 및 15
• Ubuntu Server 16.04, 18.04 및 20.04

다른 Linux AMIs에서 생성된 EC2 인스턴스에서는 SSM Agent를 수동으로 설치해야 합니다.
EC2 인스턴스에 에이전트를 설치하는 방법에 대한 내용은 SSM Agent 상태 확인 및 에이전트 시작을 참조하세요.

방법 1.

• 사전에 IAM 사용자에 ssm:StartSession 권한이 부여된 정책이 연결되어 있다면, CLI 환경에서 아래와 같이 접근 후 설치가 가능합니다.

$ aws ssm start-session --target <인스턴스 ID> --profile <profile 명>

CloudWatch Agent를 설치합니다.

$ sudo yum install amazon-cloudwatch-agent -y

방법 2.

System Manager 콘솔 > 명령 실행 > 명령 실행

명령 실행

명령 문서 목록에서 AWS-ConfigureAWSPackage를 선택합니다.

명령 파라미터

• Action: install을 선택합니다.
• Name: AmazonCloudWatchAgent를 입력합니다.
• Version: 최신 버전의 에이전트를 설치하도록 버전을 최신 상태로 설정한 채로 유지합니다.

대상

CloudWatch 에이전트를 설치할 인스턴스를 선택합니다.

명령을 실행합니다.

구성 파일 확인

/opt/aws/amazon-cloudwatch-agent/etc 경로에 CloudWatch Agent 구성 파일인 common-config.toml이 저장되어 있습니다.

Windows Server를 실행하는 서버에서는 이 파일이 C:\ProgramData\Amazon\AmazonCloudWatchAgent 디렉터리에 있습니다.

자세한 사항은 AWS 공식 문서를 확인하세요.