EC2 인스턴스의 지표와 로그를 CloudWatch로 푸시할 수 있게 통합 CloudWatch 에이전트를 설치하고 구성하려면 어떻게 해야 하나요?

3분 분량
0

통합 Amazon CloudWatch 에이전트를 사용하여 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에서 Amazon CloudWatch로 지표와 로그를 푸시하고 싶습니다.

해결 방법

참고: 시작하기 전에 EC2 인스턴스에서 인터넷 연결을 설정합니다. 필요한 엔드포인트에 연결하려면 EC2 인스턴스가 인터넷에 연결되어 있어야 합니다.

EC2 인스턴스에서 CloudWatch 에이전트를 실행하기 위한 IAM 역할 생성

1.    AWS Identity and Access Management(IAM) 콘솔을 엽니다.

2.    탐색 창에서 역할을 선택합니다.

3.    역할 생성을 선택합니다.

4.    이 역할을 사용할 서비스EC2를 선택합니다.

5.    다음: 권한을 선택합니다.

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

7.    다음: 태그를 선택하고 다음: 검토를 선택합니다.

8.    역할 이름에는 역할의 이름(예: CloudWatchAgentServerRole)을 입력합니다.

9.    (선택 사항) 역할 설명을 입력합니다.

10.    정책 옆에 CloudWatchAgentServerPolicy가 표시되는지 확인합니다.

11.    역할 생성을 선택합니다.

12.    새 IAM 역할을 EC2 인스턴스에 연결합니다.

EC2 인스턴스에 통합 CloudWatch 에이전트 다운로드 및 설치

Amazon Linux, Amazon Linux 2, Amazon Linux 2023

1.    CloudWatch 에이전트를 다운로드하려면 다음 명령을 실행합니다.

wget https://s3.region.amazonaws.com/amazoncloudwatch-agent-region/amazon_linux/amd64/latest/amazon-cloudwatch-agent.rpm

위 명령에서 region은 자신의 AWS 리전으로 바꿉니다.

2.    CloudWatch 에이전트를 설치하려면 다음 명령을 실행합니다.

sudo rpm -U ./amazon-cloudwatch-agent.rpm

Windows

1.    CloudWatch 에이전트를 다운로드하려면 다음 명령을 실행합니다.

https://s3.region.amazonaws.com/amazoncloudwatch-agent-region/windows/amd64/latest/amazon-cloudwatch-agent.msi

위 명령에서 region은 자신의 AWS 리전으로 바꿉니다.

2.    패키지가 있는 디렉터리로 이동한 후 다음 명령을 입력합니다.

msiexec /i amazon-cloudwatch-agent.msi

에이전트 구성 파일 생성

참고: 간단한 진행을 위해 마법사를 사용하여 에이전트 구성 파일을 생성합니다. 나중에 수동으로 파일을 편집하여 지표 또는 로그를 추가하거나 제거합니다. 자세한 내용을 보려면 에이전트 구성 파일 마법사를 완료하기 위한 팁 섹션을 참조하세요.

Amazon Linux, Amazon Linux 2, Amazon Linux 2023

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard

Windows

cd "C:\Program Files\Amazon\AmazonCloudWatchAgent"
amazon-cloudwatch-agent-config-wizard.exe

기본적으로 마법사는 다음 위치에 에이전트 구성 파일을 생성합니다. C:\Program Files\Amazon\AmazonCloudWatchAgent\config.json.

CloudWatch 에이전트 시작

Amazon Linux, Amazon Linux 2, Amazon Linux 2023

CloudWatch 에이전트를 시작하려면 다음 명령을 실행합니다.

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -c file:configuration-file-path -s

참고: 이전 예시에서 configuration-file-path를 구성 파일 경로로 바꿉니다.

Windows

PowerShell에서 관리자 권한으로 다음 명령을 입력합니다.

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -a fetch-config -m ec2 -c file:configuration-file-path -s

참고: 이전 예시에서 configuration-file-path를 구성 파일 경로로 바꿉니다.

명령 예시:

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

이제 지표와 로그가 CloudWatch로 푸시됩니다. 기본적으로 에이전트는 지표를 NameSpace CWAgent로 푸시합니다.

에이전트 구성 파일 마법사를 구성하기 위한 팁

  • **StatsD 대몬을 켜시겠습니까?**그리고 CollectD에서 지표를 모니터링하시겠습니까? EC2 인스턴스에 StatsDCollectD 플러그인을 설치한 경우에만 이러한 질문에 를 선택하세요.
  • 어떤 기본 지표 구성을 원하시나요? 세부 구성에 대한 자세한 내용을 보려면 CloudWatch 에이전트의 사전 정의된 지표 세트를 참조하세요. 이후 사용 사례에 가장 적합한 옵션을 선택하세요.
  • 가져와서 마이그레이션하려는 기존 CloudWatch Logs 에이전트 구성 파일이 있나요?awslogs 에이전트가 설치되어 실행 중인 경우 를 선택합니다. 를 선택하는 경우, 마법사는 awslogs 에이전트 구성 파일(/etc/awslogs/awslogs.conf 또는 /var/awslogs/etc/awslogs.conf)을 읽고 모니터링할 로그 파일을 결정합니다.
  • AWS Systems Manager의 기능인 파라미터 스토어에 구성을 저장하시겠습니까? 나중에 파일을 다시 사용하기 위해 이 에이전트 구성 파일을 파라미터 스토어에 저장하려면 를 선택합니다.
    중요: 파라미터 스토어에 에이전트 구성 파일을 저장할 때 에이전트를 시작하는 명령은 다양합니다.
  • 마법사를 완료하면 에이전트 구성 파일이 기본적으로 /opt/aws/amazon-cloudwatch-agent/bin/config.json에 저장됩니다. 이 파일을 수동으로 편집하여 지표 또는 로그를 추가하거나 제거할 수 있습니다.

사용자 지정 구성 파일 예시는 CloudWatch 에이전트 구성 파일: 전체 예시를 참조하세요.

참고: 에이전트 구성 파일을 수정할 때는 fetch-config 명령으로 에이전트를 시작하여 에이전트에 변경 사항이 반영되도록 하세요.

CloudWatch 에이전트 시작 및 중지

자세한 내용을 보려면 CloudWatch 에이전트 중지 및 재시작을 참조하세요.

AWS 공식
AWS 공식업데이트됨 일 년 전
댓글 없음