View a markdown version of this page

Elastic Beanstalk 환경에 대한 배포 로그 보기 - AWS Elastic Beanstalk
지원되는 연산자로그 내용콘솔인스턴스 로그 파일

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

Elastic Beanstalk 환경에 대한 배포 로그 보기

Elastic Beanstalk는 환경에 대한 각 배포에 대한 배포 로그를 생성합니다. 배포 로그는 종속성 설치, 빌드 출력, 애플리케이션 시작 및 발생한 오류를 포함하여 배포 중에 발생한 상황에 대한 통합된 시간순 보기를 제공합니다. 배포 로그를 사용하면 SSH를 인스턴스로 연결하거나 여러 로그 파일을 상호 연관시킬 필요 없이 실패한 배포를 신속하게 진단할 수 있습니다.

배포 로그는 각 인스턴스에 로컬로 기록됩니다. 콘솔, CLI, API 또는 관리형 업데이트를 통해 트리거된 배포의 경우 배포 중에 하나의 인스턴스가 지속적으로 Amazon S3에 로그를 업로드합니다. Elastic Beanstalk 콘솔은 Amazon S3에서 로그를 읽으므로 인스턴스에 연결하지 않고도 진행 상황을 모니터링할 수 있습니다.

배포 로그는 간결하게 설계되었습니다. 성공 시 로그에는 요약 메시지(예: 실행 및 완료된 명령)만 표시됩니다. 실패 시 로그에는 실패한 단계의 최대 50줄의 출력이 포함되므로 상세 출력을 통해 시프팅하지 않고도 오류를 확인할 수 있습니다.

참고

배포 로그는 2026년 3월 11일 이후에 릴리스된 Amazon Linux 2 및 Amazon Linux 2023 플랫폼 버전에서 사용할 수 있습니다. https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-03-11-al2023.html Windows 플랫폼은 현재 지원되지 않습니다.

지원되는 연산자

배포 로그는 다음 작업에 대해 생성됩니다.

  • 애플리케이션 배포 - 환경에 새 애플리케이션 버전을 배포합니다.

  • 구성 업데이트 - 인스턴스 업데이트가 필요한 환경 구성 설정 변경.

  • 환경 생성 - 새 환경을 생성할 때의 초기 배포입니다.

  • 앱 서버 다시 시작 - 인스턴스에서 애플리케이션 서버를 다시 시작합니다.

로그 요청, 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초부터 캡처됩니다. 초기 시작 메시지만 포함됩니다. 애플리케이션이 출력을 생성하는 데 더 오래 걸리는 경우 배포 로그에 표시되지 않습니다. 전체 애플리케이션 로그를 보려면 번들 로그를 요청하거나 인스턴스에 직접 연결합니다. 자세한 내용은 인스턴스 로그 보기 단원을 참조하십시오.

배포 단계가 실패하면 로그는 이를 로 표시하고 실패한 단계의 최대 50줄의 출력을 [ERROR] 포함합니다. 배포 로그에 세부 정보가 충분하지 않은 경우 로그 탭에서 전체 인스턴스 로그(eb-engine.log, eb-hooks.log및 애플리케이션 로그 포함)를 검색할 수 있습니다. 자세한 내용은 Elastic Beanstalk 환경에서 Amazon EC2 인스턴스 로그 보기 단원을 참조하십시오.

콘솔에서 배포 로그 보기

Elastic Beanstalk 콘솔은 환경 대시보드에 배포 기록 및 로그를 볼 수 있는 배포 탭을 제공합니다.

배포 기록 보기

배포 기록을 보려면

  1. Elastic Beanstalk 콘솔을 열고 리전 목록에서를 선택합니다 AWS 리전.

  2. 탐색 창에서 환경을 선택한 다음 목록에서 환경의 이름을 선택합니다.

  3. 환경 대시보드에서 배포 탭을 선택합니다.

    배포 탭에는 환경에 대한 배포 테이블이 표시됩니다. 각 행에는 다음 정보가 포함됩니다.

    • 요청 ID - 배포의 고유 식별자입니다.

    • 상태 - 성공, 실패 또는 진행 중.

    • 유형 - 환경 생성, 애플리케이션 배포, 구성 업데이트, 관리형 플랫폼 업데이트, 앱 서버 재시작, 환경 재구축, 환경 복원, 환경 도메인 전환 또는 환경 종료와 같은 배포 유형입니다.

    • 시작 시간 - 배포가 시작된 시간입니다.

    • 기간 - 배포를 완료하는 데 걸린 시간입니다.

배포가 진행 중이면 탭이 업데이트를 자동으로 폴링합니다. 새로 고침 버튼을 선택하여 목록을 수동으로 다시 로드할 수도 있습니다.

배포 세부 정보 및 로그 보기

배포 세부 정보를 보려면

  1. 배포 탭에서 검사하려는 배포의 요청 ID 링크를 선택합니다.

  2. 배포 세부 정보 페이지에는 요청 ID, 상태, 배포 유형, 시작 시간, 기간 및 배포 정책이 포함된 요약 섹션이 표시됩니다. 배포 이벤트에서 확인할 수 있는 경우 배포 정책(예: 한 번에 모두, 롤링, 추가 배치를 사용한 롤링, 변경 불가능 또는 트래픽 분할)이 표시됩니다.

  3. 요약 아래에서 다음 탭 중 하나를 선택합니다.

    • 이벤트 - 선택한 배포에 대한 이벤트만 표시하도록 필터링된이 배포와 관련된 이벤트의 타임라인입니다.

    • 배포 로그 - 인스턴스의 통합 배포 로그입니다. 로그 수준별로 검색 및 필터링하고 로그 파일을 다운로드할 수 있습니다.

진행 중인 배포의 경우 로그 탭이 자동으로 새로 고쳐져 새 로그 항목이 작성될 때 표시됩니다. 배포가 완료되면 콘솔이 최종 로그 상태를 가져와 전체 출력이 표시되는지 확인합니다.

중요

콘솔에서 배포 로그를 보려면 환경의 Amazon S3 스토리지 버킷()에 대한 s3:GetObject 권한이 필요합니다elasticbeanstalk-region-account-id. IAM 정책에이 권한이 포함되지 않은 경우 배포 기록 및 이벤트를 계속 사용할 수 있지만 로그 탭에 오류가 표시됩니다.

인스턴스의 배포 로그 파일

배포 로그는 각 인스턴스의 /var/log/deployments/ 디렉터리에 기록됩니다. 로그 파일 이름은 배포가 트리거된 방식에 따라 달라집니다.

  • 워크플로 제어 배포(콘솔, CLI 또는 API를 통해 트리거됨) - eb-deployment-request-id.log, 여기서 request-id는 고유한 배포 요청 ID입니다.

  • 자체 시작 배포(인스턴스 시작 또는 재시작 앱 서버) - eb-deployment-unix-timestamp.log.

Elastic Beanstalk는 이러한 파일을 자동으로 교체하여 각 인스턴스에 최신 배포 로그 50개를 유지합니다.

워크플로 제어 배포의 경우 로그는 다음 경로에서 Amazon S3에 업로드됩니다.

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/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.