

# CloudWatch 에이전트를 사용하여 지표, 로그, 트레이스 수집
<a name="Install-CloudWatch-Agent"></a>

CloudWatch 에이전트는 Amazon EC2 인스턴스, 온프레미스 서버 및 컨테이너화된 애플리케이션에서 지표, 로그 및 트레이스를 수집하는 소프트웨어 구성 요소입니다. 이를 통해 기본적으로 제공되는 기본 모니터링보다 더 포괄적으로 인프라와 애플리케이션을 모니터링할 수 있습니다.

**주요 이점**
+ 시스템 수준 지표(CPU, 메모리, 디스크, 네트워크) 수집 
+ 애플리케이션에서 사용자 지정 지표 수집
+ 다양한 소스에서 로그 수집 및 중앙 집중화
+ 단일 도구로 AWS 및 온프레미스 환경 모두 모니터링 
+ 수집된 데이터를 기반으로 경보 및 알림 설정 

CloudWatch 에이전트를 사용하면 다음을 수행할 수 있습니다.
+ 운영 체제 전반에 걸쳐 Amazon EC2 인스턴스에서 내부 시스템 수준 지표를 수집할 수 있습니다. 지표에는 EC2 인스턴스 지표뿐만 아니라 인게스트 지표도 포함될 수 있습니다. 수집할 수 있는 추가 지표는 [CloudWatch 에이전트가 수집하는 지표](metrics-collected-by-CloudWatch-agent.md)에 나열되어 있습니다.
+ 온프레미스 서버로부터 시스템 수준 지표를 수집합니다. 여기에는 AWS가 관리하지 않는 서버뿐만 아니라 하이브리드 환경의 서버도 포함될 수 있습니다.
+ `StatsD` 및 `collectd` 프로토콜을 사용하여 애플리케이션 또는 서비스에서 사용자 지정 지표를 검색할 수 있습니다. `StatsD`는 Windows Server가 실행되는 서버와 Linux 서버에서 모두 지원되며, `collectd`는 Linux 서버에서만 지원됩니다.
+ Linux 또는 Windows Server를 실행하는 Amazon EC2 인스턴스 및 온프레미스 서버에서 로그를 수집할 수 있습니다.
**참고**  
CloudWatch 에이전트는 FIFO 파이프에서의 로그 수집을 지원하지 않습니다.
+ 지표를 CloudWatch 또는 Amazon Managed Service for Prometheus 또는 둘 다로 전송합니다. CloudWatch 에이전트 구성 파일에는 `metrics`의 `metrics_destinations` 파라미터가 포함되어 있습니다. 이 파라미터의 `cloudwatch`, `amp` 또는 둘 다 지정할 수 있습니다.
+ 버전 1.300031.0 이상을 사용하여 CloudWatch Application Signals를 활성화할 수 있습니다. 자세한 내용은 [Application Signals](CloudWatch-Application-Monitoring-Sections.md) 섹션을 참조하세요.
+ 버전 1.300025.0 이상은 [OpenTelemetry](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html#xray-instrumenting-opentel) 또는 [X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html#xray-instrumenting-xray-sdk) 클라이언트 SDK에서 추적을 수집하여 X-Ray에 전송할 수 있습니다.

  CloudWatch 에이전트를 사용하면 별도의 트레이스 수집 대몬(daemon)을 실행할 필요 없이 트레이스를 수집할 수 있으므로 실행하고 관리하는 에이전트 수를 줄일 수 있습니다.

CloudWatch로 전송된 지표는 다른 CloudWatch 지표와 마찬가지로 CloudWatch에서 볼 수 있습니다. 에이전트를 구성할 때 다른 네임스페이스를 지정할 수 있어도 CloudWatch 에이전트가 수집하는 지표의 기본 CloudWatch 네임스페이스는 `CWAgent`입니다.

CloudWatch 에이전트가 수집한 로그는 이전 CloudWatch Logs 에이전트가 수집한 로그와 마찬가지로 Amazon CloudWatch Logs에서 처리되고 저장됩니다. CloudWatch Logs 요금에 대한 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing)을 참조하세요.

CloudWatch 에이전트가 수집한 지표는 사용자 지정 지표로 청구됩니다. CloudWatch 지표 요금에 대한 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing)을 참조하세요.

CloudWatch 에이전트는 MIT 라이선스에 따라 오픈 소스이며 [GitHub에 호스트](https://github.com/aws/amazon-cloudwatch-agent/)됩니다. CloudWatch 에이전트를 구축 또는 사용자 지정하거나 이에 기여하려는 경우 GitHub 리포지토리에서 최신 지침을 참조하세요. 잠재적인 보안 문제를 찾았다고 생각한다면 GitHub 또는 공개 게시판에 게시하지 마세요. 대신 [취약성 보고](https://aws.amazon.com/security/vulnerability-reporting/)의 지침을 따르거나 [AWS 보안에 직접 이메일](mailto:aws-security@amazon.com)을 보내시기 바랍니다.

명령줄을 사용하여 CloudWatch 에이전트를 수동으로 다운로드하여 설치하거나 AWS Systems Manager와 통합할 수 있습니다. CloudWatch 에이전트를 설치하는 일반적인 흐름은 다음과 같습니다.

1. 에이전트가 서버에서 지표를 수집하고 선택적으로 AWS Systems Manager와 통합할 수 있게 하는 IAM 역할 또는 사용자를 생성하세요.

1. 에이전트 패키지를 다운로드합니다.

1. CloudWatch 에이전트 구성 파일을 수정하고 수집하려는 지표를 지정합니다.

1. 서버에 에이전트를 설치하고 시작합니다.

**Topics**
+ [지원되는 운영 체제](supported-operating-systems.md)
+ [사전 조건](prerequisites.md)
+ [CloudWatch 에이전트 패키지 다운로드](download-CloudWatch-Agent-on-EC2-Instance-commandline-first.md)
+ [CloudWatch 에이전트 패키지의 서명 확인](verify-CloudWatch-Agent-Package-Signature.md)
+ [CloudWatch 에이전트 설치](install-CloudWatch-Agent-on-EC2-Instance.md)
+ [보안이 강화된 Linux(SELinux)로 CloudWatch 에이전트 설정](CloudWatch-Agent-SELinux.md)
+ [CloudWatch 에이전트 구성 파일 생성](create-cloudwatch-agent-configuration-file.md)
+ [CloudWatch 에이전트 시작](start-CloudWatch-Agent-on-premise-SSM-onprem.md)
+ [CloudWatch 에이전트가 수집하는 지표](metrics-collected-by-CloudWatch-agent.md)
+ [관련 원격 측정과 함께 CloudWatch 에이전트 사용](CloudWatch-Agent-RelatedEntities.md)
+ [CloudWatch 에이전트를 사용하는 일반적인 시나리오](CloudWatch-Agent-common-scenarios.md)
+ [CloudWatch 에이전트 자격 증명 기본 설정](CloudWatch-Agent-Credentials-Preference.md)
+ [CloudWatch 에이전트 문제 해결](troubleshooting-CloudWatch-Agent.md)