eb logs - AWS Elastic Beanstalk
설명조건옵션출력예시

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

eb logs

설명

eb logs 명령은 기본적으로 CloudWatch Logs로의 로그 스트리밍을 활성화하거나 비활성화하고, 인스턴스 로그 또는 CloudWatch Logs 로그를 검색하기 위한 용도로 사용됩니다. 이 명령은 --cloudwatch-logs(-cw) 옵션을 사용하여 로그 스트리밍을 활성화하거나 비활성화합니다. 이 옵션을 사용하지 않으면 로그를 검색합니다.

로그를 검색할 때 --all, --zip, --stream 등의 옵션을 지정하여 전체 로그를 검색할 수 있습니다. 이러한 옵션을 지정하지 않으면 Elastic Beanstalk는 테일 로그를 검색합니다.

이 명령은 지정된 환경 또는 기본 환경의 로그를 처리합니다. 관련 로그는 컨테이너 유형에 따라 다릅니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 platform.yaml 파일이 포함된 경우, 해당 명령은 빌더 환경의 로그 또한 처리합니다.

자세한 내용은 Amazon CloudWatch Logs에서 Elastic Beanstalk 사용 섹션을 참조하세요.

조건

CloudWatch Logs로의 로그 스트리밍을 활성화하거나 비활성화하려면: 

eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [environment-name]

인스턴스 로그를 검색하려면: 

eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance instance-id] [--log-group log-group] [environment-name]

환경 상태 로그를 검색하려면: 

eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [environment-name]

옵션

이름

설명

-cw [enable | disable]

또는

--cloudwatch-logs [enable | disable]

CloudWatch Logs로의 로그 스트리밍을 활성화하거나 비활성화합니다. 인수를 입력하지 않으면 로그 스트리밍이 활성화됩니다. --cloudwatch-log-source(-cls) 옵션을 추가로 지정하지 않으면 인스턴스 로그 스트리밍이 활성화되거나 비활성화됩니다.

-cls instance | environment-health | all

또는

--cloudwatch-log-source instance | environment-health | all

CloudWatch Logs를 사용할 때 로그 소스를 지정합니다. 활성화 또는 비활성화 명령을 사용하여 CloudWatch Logs 스트리밍을 활성화하거나 비활성화할 로그입니다. 검색 명령을 사용하여 CloudWatch Logs에서 검색할 로그입니다.

유효한 값:

  • --cloudwatch-logs(활성화 또는 비활성화) 사용 - instance | environment-health | all

  • --cloudwatch-logs(검색) 사용 안 함 - instance | environment-health

값의 의미:

  • instance(기본값) - 인스턴스 로그

  • environment-health - 환경 상태 로그(환경에서 확장 상태를 활성화한 경우에만 지원됨)

  • all - 모든 로그 소스

-a

또는

--all

전체 로그를 검색하고 이를 .elasticbeanstalk/logs 디렉터리에 저장합니다.

-z

또는

--zip

전체 로그를 검색하고, 이를 .zip 파일로 압축한 후, 해당 파일을 .elasticbeanstalk/logs 디렉터리에 저장합니다.

--stream

스트림(연속 출력)에서 로그를 작성합니다. 이 옵션을 사용하면 명령이 중단할 때까지 실행됩니다(Ctrl+C 누름).

-i instance-id

또는

--instance instance-id

지정된 인스턴스의 로그만 검색합니다.

-g log-group

또는

--log-group log-group

로그를 검색할 CloudWatch Logs 로그 그룹을 지정합니다. 이 옵션은 CloudWatch Logs로의 인스턴스 로그 스트리밍이 활성화된 경우에만 유효합니다.

인스턴스 로그 스트리밍을 활성화하고 --log-group 옵션을 지정하지 않으면 다음 중 하나가 기본 로그 그룹으로 설정됩니다:

  • Amazon Linux 2 – /aws/elasticbeanstalk/environment-name/var/log/eb-engine.log

  • Windows 플랫폼 - /aws/elasticbeanstalk/environment-name/EBDeploy-Log

  • Amazon Linux AMI(AL1) – /aws/elasticbeanstalk/environment-name/var/log/eb-activity.log

    참고

    2022년 7월 18일 Elastic Beanstalk는 Amazon Linux AMI(AL1) 에 기반한 모든 플랫폼 브랜치의 상태를 사용 중지로 설정했습니다. 완전 지원이 가능한 현재 Amazon Linux 2023 플랫폼 브랜치로 마이그레이션하는 방법에 대한 자세한 내용은 Elastic Beanstalk Linux 애플리케이션을 Amazon Linux 2023 또는 Amazon Linux 2로 마이그레이션을(를) 참조하세요.

각 로그 파일에 해당하는 로그 그룹과 관련된 자세한 내용은 Elastic Beanstalk로 CloudWatch Logs를 설정하는 방법을 참조하세요.

일반 옵션

출력

기본적으로 로그를 터미널에 직접 표시됩니다. 페이징 프로그램을 사용하여 출력을 표시합니다. Q 또는 q를 눌러 종료합니다.

--stream을 사용하면, 터미널에 기존 로그를 함께 표시하고 실행을 유지합니다. Ctrl+C를 눌러 종료합니다.

--all 및 --zip을 사용하면, 로그를 로컬 파일에 저장하고 파일 위치를 표시합니다.

예시

다음 예는 CloudWatch Logs로의 인스턴스 로그 스트리밍을 활성화합니다.

$ eb logs -cw enable
Enabling instance log streaming to CloudWatch for your environment
After the environment is updated you can view your logs by following the link:
https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/environment-name/
Printing Status:
2018-07-11 21:05:20    INFO: Environment update is starting.
2018-07-11 21:05:27    INFO: Updating environment environment-name's configuration settings.
2018-07-11 21:06:45    INFO: Successfully deployed new configuration to environment.

다음 예는 .zip 파일로 인스턴스 로그를 검색합니다.

$ eb logs --zip
Retrieving logs...
Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip