기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Elastic Beanstalk 환경에 대한 배포 로그 보기
Elastic Beanstalk는 환경에 대한 각 배포에 대한 배포 로그를 생성합니다. 배포 로그는 종속성 설치, 빌드 출력, 애플리케이션 시작 및 발생한 오류를 포함하여 배포 중에 발생한 상황에 대한 통합된 시간순 보기를 제공합니다. 배포 로그를 사용하면 SSH를 인스턴스로 연결하거나 여러 로그 파일을 상호 연관시킬 필요 없이 실패한 배포를 신속하게 진단할 수 있습니다.
배포 로그는 각 인스턴스에 로컬로 기록됩니다. 콘솔, CLI, API 또는 관리형 업데이트를 통해 트리거된 배포의 경우 배포 중에 한 인스턴스가 지속적으로 Amazon S3에 로그를 업로드합니다. Elastic Beanstalk 콘솔은 Amazon S3에서 로그를 읽으므로 인스턴스에 연결하지 않고도 진행 상황을 모니터링할 수 있습니다.
배포 로그는 간결하게 설계되었습니다. 성공 시 로그에는 요약 메시지(예: 실행 및 완료된 명령)만 표시됩니다. 실패 시 로그에는 실패한 단계의 최대 50줄의 출력이 포함되므로 상세 출력을 통해 시프팅하지 않고도 오류를 확인할 수 있습니다.
**참고**
배포 로그는 [https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2.html)[2026년 3월 11일 이후에 릴리스된 Amazon Linux 2 및 Amazon Linux 2023](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2023.html) 플랫폼 버전과 2026년 4월 22일 이후에 릴리스된 [Windows](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-04-22-windows.html) 플랫폼 버전에서 사용할 수 있습니다.
## 지원되는 연산자
배포 로그는 다음 작업에 대해 생성됩니다.
+ **애플리케이션 배포 **- 환경에 새 애플리케이션 버전을 배포합니다.
+ **구성 업데이트** - 기존 인스턴스에 적용되는 환경 구성 설정 변경 및 환경에 새 인스턴스를 추가하는 업데이트.
+ **환경 생성** - 새 환경을 생성할 때의 초기 배포입니다.
+ **앱 서버 다시 시작** - 인스턴스에서 애플리케이션 서버를 다시 시작합니다.
+ **관리형 플랫폼 업데이트** - 예약된 유지 관리 기간 동안 Elastic Beanstalk가 자동으로 적용하는 플랫폼 업데이트입니다.
로그 요청, CNAMEs 또는 태그 업데이트와 같이 인스턴스에서 애플리케이션 또는 구성 상태를 수정하지 않는 작업은 배포 로그를 생성하지 않습니다.
## 배포 로그 콘텐츠
배포 로그는 배포 중에 다음 정보를 캡처합니다.
+ **배포 수명 주기** - `Starting Application deployment` 및와 같은 각 배포 단계의 시작 및 완료 메시지입니다`Completed Application deployment`.
+ **.ebextensions 출력** - 성공 시 실행된 명령의 이름입니다. 실패 시 문제를 진단하는 데 도움이 되는 마지막 50줄의 `cfn-init` 출력입니다.
+ **플랫폼 후크 출력** - 성공 시 실행된 후크 스크립트의 이름입니다. 실패 시 마지막 50줄의 후크가 출력됩니다.
+ **종속성 설치** - **npm install**, **pip install**, 및 **composer install**와 같은 패키지 관리자의 출력입니다**bundle install**. 성공하면 완료 메시지만 로깅됩니다. 실패 시 마지막 50줄의 출력이 포함됩니다.
+ **빌드 출력** - **docker build**, **go build**및 Java 빌드와 같은 빌드 명령의 출력입니다. 실패 시 마지막 50줄의 출력이 포함됩니다.
+ **애플리케이션 시작 출력** - 시작 후 애플리케이션의 초기 출력입니다. 소스는 플랫폼에 따라 다릅니다.
+ *Docker* - **docker logs** 또는의 컨테이너 로그 **docker compose logs**
+ *Java SE, Go, Node.js, Python, Ruby, .NET* – stdout 로그 처리
+ *Tomcat* - Catalina 로그 출력
+ *PHP* - PHP-FPM 마스터 및 풀 오류 로그
+ *ECS* - 각 작업 컨테이너의 컨테이너 로그
**참고**
애플리케이션 출력은 애플리케이션이 시작된 후 2초부터 캡처됩니다. 초기 시작 메시지만 포함됩니다. 애플리케이션이 출력을 생성하는 데 더 오래 걸리는 경우 배포 로그에 표시되지 않습니다. 전체 애플리케이션 로그를 보려면 번들 로그를 요청하거나 인스턴스에 직접 연결합니다. 자세한 내용은 [인스턴스 로그 보기](using-features.logging.md) 단원을 참조하십시오.
배포 단계가 실패하면 로그는 이를 로 표시하고 실패한 단계의 최대 50줄의 출력을 `[ERROR]` 포함합니다. 배포 로그에 세부 정보가 충분하지 않은 경우 로그 탭에서 전체 인스턴스 로그(`eb-engine.log`, `eb-hooks.log`및 애플리케이션 로그 포함)를 검색할 수 **있습니다**. 자세한 내용은 [Elastic Beanstalk 환경에서 Amazon EC2 인스턴스 로그 보기](using-features.logging.md) 단원을 참조하십시오.
## 콘솔에서 배포 로그 보기
Elastic Beanstalk 콘솔은 환경 대시보드에 **배포** 기록 및 로그를 볼 수 있는 배포 탭을 제공합니다.
### 배포 기록 보기
**배포 기록을 보려면**
1. [Elastic Beanstalk 콘솔](https://console.aws.amazon.com/elasticbeanstalk)을 열고 **리전** 목록에서를 선택합니다 AWS 리전.
1. 탐색 창에서 **환경**을 선택한 다음 목록에서 환경의 이름을 선택합니다.
1. 환경 대시보드에서 **배포** 탭을 선택합니다.
배포 탭에는 환경에 대한 배포 테이블이 표시됩니다. 각 행에는 다음 정보가 포함됩니다.
+ **요청 ID** - 배포의 고유 식별자입니다.
+ **상태** - *성공*, *실패* 또는 *진행 중*.
+ **유형** - *환경 생성*, *애플리케이션 배포*, *구성 업데이트*, *관리형 플랫폼 업데이트*, *앱 서버 재시작*, *환경 재구축*, *환경 복원*, *환경 도메인 전환* 또는 *환경 종료*와 같은 배포 유형입니다.
+ **정책** - *한 번에 모두*, *롤링*, *추가 배치를 사용한 롤링*, *변경 불가능* 또는 *트래픽 분할*과 같은 배포 정책입니다.
+ **시작 시간** - 배포가 시작된 시간입니다.
+ **기간** - 배포를 완료하는 데 걸린 시간입니다.
배포가 진행 중이면 탭이 업데이트를 자동으로 폴링합니다. 새로 고침 버튼을 선택하여 목록을 수동으로 다시 로드할 수도 있습니다.
### 배포 세부 정보 및 로그 보기
**배포 세부 정보를 보려면**
1. **배포** 탭에서 검사하려는 배포의 **요청 ID** 링크를 선택합니다.
1. 배포 세부 정보 페이지에는 요청 ID, 상태, 배포 유형, 시작 시간, 기간 및 배포 정책이 포함된 요약 섹션이 표시됩니다. 배포 이벤트에서 확인할 수 있는 경우 배포 정책(예: *한 번에 모두*, *롤링*, *추가 배치를 사용한 롤링*, *변경 불가능* 또는 *트래픽 분할*)이 표시됩니다.
1. 요약 아래에서 다음 탭 중 하나를 선택합니다.
+ **이벤트** - 선택한 배포에 대한 이벤트만 표시하도록 필터링된이 배포와 관련된 이벤트의 타임라인입니다.
+ **배포 로그 **- 인스턴스의 통합 배포 로그입니다. 로그 수준별로 검색 및 필터링하고 로그 파일을 다운로드할 수 있습니다.
진행 중인 배포의 경우 로그 탭이 자동으로 새로 고쳐져 새 로그 항목이 작성될 때 표시됩니다. 배포가 완료되면 콘솔이 최종 로그 상태를 가져와 전체 출력을 볼 수 있도록 합니다.
**중요**
콘솔에서 배포 로그를 보려면 환경의 Amazon S3 스토리지 버킷()에 대한 `s3:GetObject` 권한이 필요합니다`elasticbeanstalk-{{region}}-{{account-id}}`. IAM 정책에이 권한이 포함되지 않은 경우 배포 기록 및 이벤트를 계속 사용할 수 있지만 로그 탭에 오류가 표시됩니다.
## 인스턴스의 배포 로그 파일
배포 로그는 각 인스턴스의 `/var/log/deployments/` 디렉터리에 기록됩니다. 로그 파일 이름은 배포가 트리거된 방식에 따라 달라집니다.
+ **워크플로 제어 배포**(콘솔, CLI 또는 API를 통해 트리거됨) - `eb-deployment-{{request-id}}.log`, 여기서 {{request-id}}는 고유한 배포 요청 ID입니다.
+ **자체 시작 배포**(인스턴스 시작) - `eb-deployment-{{timestamp}}-{{instance-id}}.log` {{타임스탬프}}가 UTC 형식(예: `20260317T151315Z`)이고 {{instance-id}}가 Amazon EC2 인스턴스 ID인 입니다.
Elastic Beanstalk는 이러한 파일을 자동으로 교체하여 각 인스턴스에 최신 배포 로그 50개를 유지합니다.
워크플로 제어 배포의 경우 로그는 다음 경로에서 Amazon S3에 업로드됩니다.
```
s3://{{elasticbeanstalk-region-account-id}}/resources/environments/logs/deployments/{{environment-id}}/{{log-filename}}
```
자체 시작 배포의 경우 로그는 `selfstartup/` 하위 디렉터리에서 Amazon S3에 업로드됩니다.
```
s3://{{elasticbeanstalk-region-account-id}}/resources/environments/logs/deployments/{{environment-id}}/selfstartup/{{log-filename}}
```
워크플로 제어 배포의 경우 업로드를 시작하는 첫 번째 인스턴스는 전체 배포에 대한 역할을 클레임합니다. 해당 인스턴스는 배포 기간 동안 Amazon S3에 로그를 업로드합니다. 자체 시작 배포의 경우 각 인스턴스는 자체 로그를 독립적으로 업로드합니다. 모든 인스턴스는 여전히 로컬로 배포 로그를 작성합니다.
**중요**
Amazon S3에 배포 로그를 업로드하려면 인스턴스 프로파일의 환경 Amazon S3 스토리지 버킷에 대한 `s3:PutObject` 권한이 필요하며 VPC 구성은 Amazon S3에 대한 연결을 허용해야 합니다.
배포 로그 업로드는 파일당 1MB로 제한됩니다. 배포 로그가이 크기를 초과하면 인스턴스에서 전체 로그를 사용할 수 있음을 나타내는 메시지와 함께 업로드된 버전이 잘립니다.
### S3 로그 업로드 비활성화
배포 로그가 Amazon S3에 업로드되지 않도록 하려면 환경에서 다음 환경 속성을 설정합니다.
```
option_settings:
- namespace: aws:elasticbeanstalk:application:environment
option_name: EB_DEPLOYMENT_LOG_S3_DISABLED
value: true
```
이 환경 속성이 설정되면 배포 로그는 여전히 각 인스턴스의 `/var/log/deployments/`에 로컬로 기록되지만 Amazon S3에 업로드되지 않으며 콘솔 **배포** 탭에서 사용할 수 없습니다. 구성 **** 페이지의 **소프트웨어**에서 또는 EB CLI 또는를 사용하여이 속성을 설정할 수도 있습니다 AWS CLI.