[CloudWatch] CloudWatch Agent + SSM 설치 가이드 (모든 고객용)

Prerequisite

• AWS Systems Manager를 사용해 CloudWatch 에이전트를 설치하고 실행할 수 있습니다.
• 본 가이드는 EC2 인스턴스에 메모리와 디스크 사용량 지표를 추가로 수집하여 확인하기 위한 설정 가이드입니다.
• 사용자 지정 지표 수집에 대한 추가 비용이 발생합니다. 다만 그 비용이 미미합니다.[CloudWatch 과금 정책]
• 원본 : https://smilesharkhelp.zendesk.com/hc/ko/articles/10219243267087--CloudWatch-CloudWatch-Agent-SSM-%EC%84%A4%EC%B9%98-%EA%B0%80%EC%9D%B4%EB%93%9C

Process

1. CloudWatch / SSM IAM 역할 추가

• [IAM] 관리 콘솔 -> [역할] -> [역할 생성] 선택
  
• [AWS 서비스] -> [사용 사례] EC2 선택
  
   
• 정책 검색하여 체크박스 선택
  
  •  
    • 다음 4가지 정책 검색하여 선택
      
• 이름 지정 후 역할 생성
  
• 인스턴스의 IAM 역할 지정
  • [EC2] 관리 콘솔 -> 인스턴스 선택 -> [작업] -> [보안] > [IAM 역할 수정] 선택
    
  • IAM 역할 지정 후 업데이트
    

2. SSM (System Manager) 파라미터 스토어 생성

• [Systems Manager] 관리콘솔 -> [파라미터 스토어] -> [파라미터 생성] 선택
  
  
   
• 운영체제별 CloudWatch Agent용 설정 파라미터 생성
  
   
  • 이름 : 사용할 파라미터 이름을 지정
    • ex) "CloudWatchAgent-Linux" or "CloudWatchAgent-Windows"
  • 값 : 아래 운영체제 별 기본 예시 설정값을 선택하여 붙여넣기

    • Linux 설정
       

      {
           "agent": {
                "metrics_collection_interval": 60,
                "run_as_user": "root"
           },
           "metrics": {
               "append_dimensions": {
                    "InstanceId": "${aws:InstanceId}",
                    "AutoScalingGroupName": "${aws:AutoScalingGroupName}"
               },
      "aggregation_dimensions": [
                  ["AutoScalingGroupName"],
                  ["InstanceId"]
              ],
          "metrics_collected": {
              "disk": {
                  "measurement": ["disk_used_percent", "disk_inodes_free"],
                  "metrics_collection_interval": 60,
                  "resources": ["/"]
               },
               "mem": {
                   "measurement": ["mem_used_percent"],
                   "metrics_collection_interval": 60
               }
             }
          }
      } 

    • Windows 설정
       

      {
          "agent": {
              "metrics_collection_interval": 60,
              "run_as_user": "root"
          },
          "metrics": {
              "append_dimensions": {
                  "InstanceId": "${aws:InstanceId}",
                  "AutoScalingGroupName": "${aws:AutoScalingGroupName}"
              },
              "metrics_collected": {
                  "LogicalDisk": {
                      "measurement": [
                          "% Free Space"
                      ],
                      "metrics_collection_interval": 60,
                      "resources": [
                          "*"
                      ]
                   },
                   "Memory": {
                       "measurement": [
                           "Available MBytes",
                           "% Committed Bytes In Use"
                       ],
                       "metrics_collection_interval": 60
                    },
                       "Paging File": {
                           "measurement": [
                               "% Usage"
                           ],
                       "metrics_collection_interval": 60,
                       "resources": [
                           "*"
                       ]
                    }, 
                    "statsd": {
                         "metrics_aggregation_interval": 60,
                         "metrics_collection_interval": 10,
                         "service_address": ":8125"
                    }
                }
           }
      }
      
      
       

##### 이미 CWAgent 가 설치되어 있어 다른 메트릭 이름으로 설정해야될 시!!!!!!!!!

- 커스텀 메트릭 적용시 (CWAgent 가 아닌 다른 메트릭 이름 적용시)

{
"agent": {
"metrics_namespace": "CUSTOM_NAMESPACE", // 🔥 여기에 원하는 이름 입력
"metrics_collection_interval": 60,
"run_as_user": "root"
...

 

• 생성 완료
  

3. System Manager 명령 실행 - (CloudWatch Agent 설치)

• [Systems Manager] 관리콘솔 -> [명령 실행] -> [명령 실행] 버튼 클릭
  
   
• AWS-ConfigureAWSPackage 검색 후 선택
  
   
• [명령 파라메터] -> Name 필드에 AmazonCloudWatchAgent 입력
  
   

• [출력 옵션] -> [S3 버킷에 쓰기 활성화] 해제 (필요 시 설정)
  
• 대상 인스턴스 선택 후 [실행] 버튼 클릭
  
   
   
  • 태그 및 리소스 그룹 선택 방식으로 명령을 실행한 대상 인스턴스를 지정할 수 있습니다.
    
     
• 명령 실행 성공 확인
  

4. System Manager 명령 실행 - (CloudWatch Config 설정)

• [Systems Manager] 관리콘솔 -> [명령 실행] -> [명령 실행] 버튼 클릭
  
  
   
• AmazonCloudWatch-ManageAgent 검색 후 선택
  
  
   
• [명령 파라메터] -> [Optional Configuration Location] 옵션 설정
  • 이미 CWAgent 가 설치되어 있는 경우 configure(
    
     
  • 인스턴스 운영체제에 따라 파라미터 스토어에서 생성한 파라미터를 지정
    • Linux 환경 -> CloudWatchAgent-Linux
    • Windows 환경 -> CloudWatchAgent-Windows
      
       
• [출력 옵션] -> [S3 버킷에 쓰기 활성화] 해제 (필요 시 설정)
  
• 대상 인스턴스 선택 후 [실행] 버튼 클릭
  
   
   
  • 태그 및 리소스 그룹 선택 방식으로 명령을 실행한 대상 인스턴스를 지정할 수 있습니다.
• 명령 실행 성공 확인
  
   

5. CloudWatch 지표 확인

• [CloudWatch] 관리 콘솔 -> [지표] -> [모든 지표] 를 확인해 보시면 [CWAgent] 항목이 생성된 것을 볼 수 있습니다.
  
• [CWAgent] 에서 메모리 및 디스크 사용 퍼센트 체크 가능합니다.