Amazon Linux 2023에 CloudWatch Agents를 설치해 봤습니다.
Amazon Linux 2023에 CloudWatch Agents를 설치해 봤습니다.
2026.05.12
안녕하세요 클래스메소드 김재욱(Kim Jaewook) 입니다. 이번 블로그에서는 Amazon Linux 2023에 CloudWatch Agents를 설치해 봤습니다.
EC2는 5월 12일을 기준으로 Amazon Linux 2023의 가장 최신 AMI를 사용해서 생성했습니다.
CloudWatch Agents 설치
먼저 EC2에 접속해서 CloudWatch Agents를 설치합니다.
$ sudo dnf install amazon-cloudwatch-agent
Last metadata expiration check: 0:1:44 ago on Tue May 12 xx:xx:xx 2026.
Dependencies resolved.
=====================================================================
Package Architecture Version Size
=====================================================================
Installing:
amazon-cloudwatch-agent x86_64 1.300064.2-1.amzn2023 68 M
Transaction Summary
=====================================================================
Install 1 Package
Total download size: 68 M
Installed size: 228 M
Is this ok [y/N]: y
Downloading Packages:
amazon-cloudwatch-agent-1.300064.2-1.amzn2023.x86_64.rpm
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
create group cwagent, result: 0
create user cwagent, result: 0
Installed:
amazon-cloudwatch-agent-1.300064.2-1.amzn2023.x86_64
Complete!
이번에 CloudWatch Agents에서 취득할 메트릭은 다음과 같습니다.
| 모니터링 대상 항목 | 메트릭 | 임계값 | 메트릭 수집 간격 | 통계 | 비고 |
|---|---|---|---|---|---|
| 메모리 사용률 | mem_used_percent | 80% 이상 | 5분 | 평균값(Average) | 메모리 사용률이 80% 이상인 경우 알림을 전송합니다. |
| 디스크 사용률 | disk_used_percent | 80% 이상 | 5분 | 평균값(Average) | 디스크 사용률이 80% 이상인 경우(디스크 여유 공간이 20% 이하인 경우) 알림을 전송합니다. |
config.json에 mem_used_percent와 disk_used_percent의 메트릭 수집 간격을 설정합니다.
$ sudo vi /opt/aws/amazon-cloudwatch-agent/bin/config.json
{
"metrics": {
"metrics_collected": {
"mem": {
"metrics_collection_interval": 300,
"measurement": ["mem_used_percent"]
},
"disk": {
"metrics_collection_interval": 300,
"measurement": ["disk_used_percent"],
"resources": ["/"]
}
}
}
}
마지막으로 CloudWatch Agents를 기동합니다.
$ sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl \
-a fetch-config -m ec2 -s \
-c file:/opt/aws/amazon-cloudwatch-agent/bin/config.json
****** processing amazon-cloudwatch-agent ******
Starting config-downloader...
I! Trying to detect region from ec2
D! [EC2] Found active network interface
Start configuration validation...
Reading json config file path:
/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.d/file_config.json.tmp
I! Valid Json input schema.
Configuration validation first phase succeeded
Starting config-translator...
Configuration validation second phase succeeded
Configuration validation succeeded
amazon-cloudwatch-agent has already been stopped
Created symlink
/etc/systemd/system/multi-user.target.wants/amazon-cloudwatch-agent.service
→ /etc/systemd/system/amazon-cloudwatch-agent.service
결과 확인
이제 CloudWatch 콘솔 화면에서 모든 지표에서 CWAgent 네임 스페이스가 생성된 것을 확인할 수 있습니다.
네임 스페이스를 클릭해 보면 device, fstype, host, path와 host를 확인할 수 있습니다.
마지막으로 mem_used_percent와 disk_used_percent 메트릭을 확인할 수 있습니다.
