기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CloudWatch로 CodeDeploy 에이전트 로그 전송
[통합 CloudWatch 에이전트](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html), 줄여서 CloudWatch 에이전트를 사용하여 CodeDeploy 에이전트 지표 및 로그 데이터를 CloudWatch로 전송할 수 있습니다.
CodeDeploy 에이전트와 함께 사용할 CloudWatch 에이전트를 설치하고 구성하려면 다음 지침을 따르세요.
## 사전 조건
시작하기 전에 다음 작업을 완료하세요.
+ CodeDeploy 에이전트를 설치하고 실행 중인지 확인합니다. 자세한 내용은 [CodeDeploy 에이전트 설치](codedeploy-agent-operations-install.md) 및 [CodeDeploy 에이전트가 실행 중인지 확인](codedeploy-agent-operations-verify.md) 섹션을 참조하세요.
+ CloudWatch 에이전트를 설치합니다. 자세한 내용은 [CloudWatch 에이전트 설치](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html)를 참조하세요.
+ CodeDeploy IAM 인스턴스 프로파일에 다음 권한을 추가합니다.
+ CloudWatchLogsFullAccess
+ CloudWatchAgentServerPolicy
CodeDeploy 인스턴스 프로파일에 대한 자세한 정보는 [CodeDeploy 시작하기](getting-started-codedeploy.md)의 [4단계: Amazon EC2 인스턴스에 대한 IAM 인스턴스 프로파일 만들기](getting-started-create-iam-instance-profile.md) 섹션을 참조하세요.
## CodeDeploy 로그를 수집하도록 CloudWatch 에이전트 구성
마법사를 단계별로 진행하거나 구성 파일을 수동으로 생성 또는 편집하여 CloudWatch 에이전트를 구성할 수 있습니다.
**마법사를 사용하여 CloudWatch 에이전트 구성(Linux)**
1. [CloudWatch 에이전트 구성 마법사 실행](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard)에 설명된 대로 마법사를 실행합니다.
1. 마법사에서 “`Do you want to monitor any log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 에이전트 로그 파일을 지정합니다.
1. `Log file path`에 CodeDeploy 로그 파일의 경로를 입력합니다(예: **/var/log/aws/codedeploy-agent/codedeploy-agent.log**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-log**).
1. “`Do you want to specify any additional log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 에이전트 배포 로그를 지정합니다.
1. `Log file path`에 CodeDeploy 배포 로그 파일의 경로를 입력합니다(예: **/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-deployment-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**).
1. “`Do you want to specify any additional log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 에이전트 업데이트 도구 로그를 지정합니다.
1. `Log file path`에 CodeDeploy 업데이트 도구 로그 파일의 경로를 입력합니다(예: **/tmp/codedeploy-agent.update.log**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-updater-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-updater-log**).
**마법사를 사용하여 CloudWatch 에이전트 구성(Windows)**
1. [CloudWatch 에이전트 구성 마법사 실행](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard)에 설명된 대로 마법사를 실행합니다.
1. 마법사에서 “`Do you want to monitor any customized log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 로그 파일을 지정합니다.
1. `Log file path`에 CodeDeploy 에이전트 로그 파일의 경로를 입력합니다(예: **C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-log**).
1. “`Do you want to specify any additional log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 에이전트 배포 로그를 지정합니다.
1. `Log file path`에 CodeDeploy 배포 로그 파일의 경로를 입력합니다(예: **C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-deployment-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**).
**구성 파일을 수동으로 생성 또는 편집하여 CloudWatch 에이전트 구성(Linux)**
1. [수동으로 CloudWatch 에이전트 구성 파일 생성 또는 편집](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)에 설명된 대로 CloudWatch 에이전트 구성 파일을 생성 또는 편집합니다.
1. 파일 이름이 `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json`이고 다음 코드를 포함해야 합니다.
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-agent-log"
},
{
"file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
},
{
"file_path": "/tmp/codedeploy-agent.update.log",
"log_group_name": "codedeploy-agent-updater-log",
"log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
}
]
}
}
}
...
```
**구성 파일을 수동으로 생성 또는 편집하여 CloudWatch 에이전트 구성(Windows)**
1. [수동으로 CloudWatch 에이전트 구성 파일 생성 또는 편집](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)에 설명된 대로 CloudWatch 에이전트 구성 파일을 생성 또는 편집합니다.
1. 파일 이름이 `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json`이고 다음 코드를 포함해야 합니다.
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-codedeploy-agent-log"
},
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
}
]
},
...
}
},
...
```
## CloudWatch 에이전트 재시작
변경한 후 [CloudWatch 에이전트 시작](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet)에 설명된 대로 CloudWatch 에이전트를 다시 시작합니다.