기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CodeDeploy EC2/온프레미스 배포에 대한 로그 데이터 보기
<a name="deployments-view-logs"></a>

CloudWatch 콘솔에서 집계 데이터를 보도록 Amazon CloudWatch 에이전트를 설정하거나 로그 파일을 검토하기 위해 개별 인스턴스에 로그인하여 CodeDeploy 배포에서 생성된 로그 데이터를 볼 수 있습니다.

**참고**  
 AWS Lambda 또는 Amazon ECS 배포에는 로그가 지원되지 않습니다. EC2/온프레미스 배포에만 사용할 수 있습니다.

**Topics**
+ [Amazon CloudWatch 콘솔에서 로그 파일 데이터 보기](#deployments-view-logs-cloudwatch)
+ [인스턴스의 로그 파일 보기](#deployments-view-logs-instance)

## Amazon CloudWatch 콘솔에서 로그 파일 데이터 보기
<a name="deployments-view-logs-cloudwatch"></a>

Amazon CloudWatch 에이전트가 인스턴스에 설치되면 해당 인스턴스에 대한 모든 배포의 배포 데이터를 CloudWatch 콘솔에서 볼 수 있게 됩니다. 간소화를 위해 인스턴스별로 로그 파일을 보는 대신 CloudWatch를 사용하여 중앙에서 로그 파일을 모니터링하는 것이 좋습니다. 자세한 내용은 [CloudWatch로 CodeDeploy 에이전트 로그 전송](codedeploy-agent-operations-cloudwatch-agent.md) 단원을 참조하십시오.

## 인스턴스의 로그 파일 보기
<a name="deployments-view-logs-instance"></a>

개별 인스턴스에 대한 배포 로그 데이터를 보려면 인스턴스에 로그인하여 오류 또는 기타 배포 이벤트에 대한 정보를 찾아볼 수 있습니다.

**Topics**
+ [Amazon Linux, RHEL 및 Ubuntu Server 인스턴스에서 배포 로그 파일을 보려면 다음을 수행하세요.](#deployments-view-logs-instance-unix)
+ [Windows Server 인스턴스에서 배포 로그 파일을 보려면](#deployments-view-logs-instance-windows)

### Amazon Linux, RHEL 및 Ubuntu Server 인스턴스에서 배포 로그 파일을 보려면 다음을 수행하세요.
<a name="deployments-view-logs-instance-unix"></a>

Amazon Linux, RHEL 및 Ubuntu Server 인스턴스에서 배포 로그는 다음 위치에 저장됩니다.

 `/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log`

Amazon Linux, RHEL 및 Ubuntu Server 인스턴스에서 배포 로그를 보거나 분석하려면 인스턴스에 로그인한 후 다음 명령을 입력하여 CodeDeploy 에이전트 로그 파일을 엽니다.

```
less /var/log/aws/codedeploy-agent/codedeploy-agent.log
```

버전 2.0.x 이상의 경우 에이전트 로그는 매일 또는 파일이 64MB(구성 가능)에 도달하면 교체됩니다. 교체된 아카이브의 이름은 `codedeploy-agent.YYYYMMDD.log` (당일 교체의 경우 숫자 접미사 포함)이며 7일 후에 정리됩니다. 스크립트 로그(`scripts.log`)는 최대 8개의 아카이브된 파일(구성 가능)과 함께 64MB로 크기가 회전됩니다.

다음 명령을 입력하여 로그 파일에서 오류 메시지를 찾습니다.


<table>
<thead>
  <tr><th>명령</th><th>결과</th></tr>
</thead>
<tbody>
  <tr><td><b>&amp; ERROR </b></td><td>로그 파일에 오류 메시지만 표시. <b>ERROR</b> 단어 앞뒤에 단일 공백을 사용합니다.</td></tr>
  <tr><td><b>/ ERROR </b></td><td>다음 오류 메시지를 검색합니다.¹ </td></tr>
  <tr><td><b>? ERROR </b></td><td>이전 오류 메시지를 검색합니다.² <b>ERROR</b> 단어 앞뒤에 공백을 하나 사용합니다.</td></tr>
  <tr><td><b>G</b></td><td>로그 파일의 끝 부분으로 이동합니다.</td></tr>
  <tr><td><b>g</b></td><td>로그 파일의 시작 부분으로 이동.</td></tr>
  <tr><td><b>q</b></td><td>로그 파일 종료.</td></tr>
  <tr><td><b>h</b></td><td>추가 명령에 대해 알아봅니다.</td></tr>
  <tr><td colspan="2">¹ <b>/ ERROR </b> 입력 후 다음 오류 메시지에 <b>n</b>을(를) 입력합니다. 이전 오류 메시지에 <b>N</b>을(를) 입력합니다.<br />² <b>? ERROR </b> 입력 후 다음 오류 메시지에 <b>n</b>을(를) 입력하거나 이전 오류 메시지에 <b>N</b>을(를) 입력합니다.</td></tr>
</tbody>
</table>


다음 명령을 입력하여 CodeDeploy 스크립트 로그 파일을 열 수도 있습니다.

```
less /opt/codedeploy-agent/deployment-root/{{deployment-group-ID}}/{{deployment-ID}}/logs/scripts.log
```

다음 명령을 입력하여 로그 파일에서 오류 메시지를 찾습니다.


<table>
<thead>
  <tr><th>명령</th><th>결과</th></tr>
</thead>
<tbody>
  <tr><td><b>&amp;stderr</b></td><td>로그 파일에 오류 메시지만 표시.</td></tr>
  <tr><td><b>/stderr</b></td><td>다음 오류 메시지 검색.¹</td></tr>
  <tr><td><b>?stderr</b></td><td>이전 오류 메시지 검색.²</td></tr>
  <tr><td><b>G</b></td><td>로그 파일의 끝 부분으로 이동.</td></tr>
  <tr><td><b>g</b></td><td>로그 파일의 시작 부분으로 이동.</td></tr>
  <tr><td><b>q</b></td><td>로그 파일 종료.</td></tr>
  <tr><td><b>h</b></td><td>추가 명령에 대해 알아봅니다.</td></tr>
  <tr><td colspan="2">¹<b>/stderr</b> 입력 후 다음 오류 메시지 메시지 앞으로 <b>n</b>을(를) 입력합니다. 이전 오류 메시지 뒤로 <b>N</b>을(를) 입력합니다.<br />² <b>?stderr</b> 입력 후 다음 오류 메시지 뒤로 <b>n</b>을(를) 입력합니다. 이전 오류 메시지 앞으로 <b>N</b>을(를) 입력합니다.</td></tr>
</tbody>
</table>


### Windows Server 인스턴스에서 배포 로그 파일을 보려면
<a name="deployments-view-logs-instance-windows"></a>

**CodeDeploy 에이전트 로그 파일**: Windows Server 인스턴스에서 CodeDeploy 에이전트 로그 파일은 다음 위치에 저장됩니다.

버전 2.0.x 이상의 경우:

`C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent.log`

버전 1.8.x 이하의 경우:

`C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt`

Windows Server 인스턴스에서 CodeDeploy 에이전트 로그 파일을 보거나 분석하려면 인스턴스에 로그인한 후 다음 명령을 입력하여 파일을 엽니다.

버전 2.0.x 이상의 경우:

```
notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent.log
```

버전 1.8.x 이하의 경우:

```
notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt
```

로그 파일에서 오류 메시지를 찾아보려면 Ctrl\+F를 누르고 **ERROR**을(를) 입력한 다음 Enter 키를 눌러 첫 번째 오류를 찾습니다.

**CodeDeploy 스크립트 로그 파일**: Windows Server 인스턴스에서 배포 로그는 다음 위치에 저장됩니다.

`C:\ProgramData\Amazon\CodeDeploy\{{deployment-group-id}}\{{deployment-id}}\logs\scripts.log`

위치:
+ {{deployment-group-id}}는 `examplebf3a9c7a-7c19-4657-8684-b0c68d0cd3c4`와(과) 같은 문자열입니다.
+ {{deployment-id}}는 `d-12EXAMPLE`와(과) 같은 식별자입니다.

다음 명령을 입력하여 CodeDeploy 스크립트 로그 파일을 엽니다.

```
notepad C:\ProgramData\Amazon\CodeDeploy\{{deployment-group-ID}}\{{deployment-ID}}\logs\scripts.log
```

버전 2.0.x 이상의 경우 에이전트 로그는 매일 또는 파일이 64MB(구성 가능)에 도달하면 교체됩니다. 스크립트 로그는 최대 8개의 아카이브된 파일(구성 가능)과 함께 64MB로 크기가 회전됩니다.

로그 파일에서 오류 메시지를 찾아보려면 Ctrl\+F를 누르고 **stderr**을(를) 입력한 다음 Enter 키를 눌러 첫 번째 오류를 찾습니다.