[AWS] Windows CloudWatch Agent 설치 방법

CloudWatch는 애플리케이션을 모니터링할 수 있도록 해주는 서비스입니다

하지만 memory, disk를 수집하기 위해선 Agent를 설치해줘야 합니다

오늘은 Windows에서 CloudWatchAgent를 설치하는 방법을 포스팅해보겠습니다

 

역할 만들기

일반 사용 사례에서 EC2를 선택하고, 정책으로 CloudWatchAgentServerPolicy를 넣어서 역할을 만들어야 합니다 

만든 역할은 인스턴스에 설정해 주세요(작업 > 보안 > IAM 역할 수정)

 

 

Windows CloudWatchAgent 설치

1. 제일 먼저 windows 인스턴스에 접속 후 aws configure 설정해주세요 

 

 

2. 파워쉘에서 CloudWatchAgent 설치 파일 다운로드해주세요 

Invoke-WebRequest https://s3.amazonaws.com/amazoncloudwatch-agent/windows/amd64/latest/amazon-cloudwatch-agent.msi -OutFile C:amazon-cloudwatch-agent.msi

 

설치 파일이 다운로드된 디렉터리로 이동한 후 실행시켜 주세요

msiexec /i amazon-cloudwatch-agent.msi

 

 

agent를 실행시켜 주세요

확인 명령어
& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a status

실행 명령어 
& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a start

 

 

 

3. CloudWatch 에이전트 구성 파일을 생성해주세요

{
   "agent":{
      "metrics_collection_interval":60,
      "region":"ap-northeast-2",
      "logfile":"/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log",
      "debug":false
   },
   "metrics":{
      "namespace":"Windows/CloudWatchAgent",
      "metrics_collected":{
         "LogicalDisk":{
            "measurement":[
               {
                  "name":"% Free Space",
                  "rename":"DiskFreeSpaceUtilization",
                  "unit":"Percent"
               }
            ],
            "metrics_collection_interval":60,
            "resources":[
               "C:"
            ]
         },
         "Memory":{
            "measurement":[
               {
                  "name":"% Committed Bytes In Use",
                  "unit":"Percent"
               }
            ],
            "metrics_collection_interval":60
         }
      },
      "append_dimensions":{
         "InstanceId":"${aws:InstanceId}"
      }
   }
}

공식 닥큐를 참고하여 원하는 메트릭을 설정합니다 

저는 간단하게 메모리와 디스크만 넣었습니다 

 

설정 파일을 생성한 디렉터리 위치와 설정 파일 이름을 잘 기억해두시길 바랍니다

 

 

** 참고: 마법사 사용해서 구성파일 만드는 방법입니다, 수동으로 설정 파일 만드는 것이 어렵다면 마법사를 활용해 보세요!

경로 이동
cd "C:\Program Files\Amazon\AmazonCloudWatchAgent"

마법사 실행
amazon-cloudwatch-agent-config-wizard.exe

 

 

4. 설정 파일을 적용시켜서 CloudWatch 에이전트 서비스를 시작합니다

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m ec2 -s -c file:"C:\Program Files\Amazon\AmazonCloudWatchAgent\cw-config.json"

 

 

 

5. CloudWatch에서 지표 확인하기

config 파일에서 설정한 namespace가 뜬것이 확인되면 성공한 것입니다

 

 

 

 

참고

https://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-commandline-fleet.html

https://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html