AWS Elastic Beanstalk
개발자 가이드

EB CLI를 사용하여 환경 상태 모니터링

Elastic Beanstalk 명령줄 인터페이스(EB CLI)는 AWS Elastic Beanstalk 환경을 관리하기 위한 명령줄 도구입니다. EB CLI를 사용하여 실시간으로, 또한 AWS Management 콘솔에서 현재 사용할 수 있는 것보다 더 세부적으로 환경의 상태를 모니터링할 수 있습니다.

EB CLI를 설치구성한 후 새 환경을 시작하고 eb create 명령을 사용하여 코드를 여기에 배포할 수 있습니다. AWS Management 콘솔에서 생성한 환경이 이미 있는 경우, 프로젝트 폴더에서 eb init를 실행하고 프롬프트에 따라 환경에 EB CLI를 연결할 수 있습니다(프로젝트 폴더는 비어 있을 수 있음).

중요

pip install 옵션과 함께 --upgrade을 실행하여 최신 버전의 EB CLI를 사용 중인지 확인합니다.

$ sudo pip install --upgrade awsebcli

EB CLI 설치 지침 전문은 설치 스크립트를 사용하여 EB CLI 설치 단원을 참조하십시오.

EB CLI를 사용하여 환경의 상태를 모니터링하려면 먼저 eb init를 실행하고 프롬프트에 따라 로컬 프로젝트 폴더를 구성해야 합니다. 전체 지침은 EB CLI 구성을 참조하십시오.

Elastic Beanstalk에서 실행 중인 환경이 이미 있고 EB CLI를 사용하여 환경의 상태를 모니터링하려면, 다음 단계에 따라 기존 환경에 연결합니다.

기존 환경에 EB CLI를 연결하려면

  1. 명령줄 터미널을 열고 사용자 폴더로 이동합니다.

  2. 환경에 새 폴더를 생성하고 엽니다.

  3. eb init 명령을 실행한 후 애플리케이션 및 상태를 모니터링할 환경을 선택합니다. 선택한 애플리케이션을 실행하는 환경이 하나만 있는 경우, 다음 예제와 같이 EB CLI가 이를 자동으로 선택하므로 사용자가 환경을 선택할 필요가 없습니다.

    ~/project$ eb init Select an application to use 1) elastic-beanstalk-example 2) [ Create new Application ] (default is 2): 1 Select the default environment. You can change this later by typing "eb use [environment_name]". 1) elasticBeanstalkEx2-env 2) elasticBeanstalkExa-env (default is 1): 1

EB CLI를 사용하여 상태를 모니터링하려면

  1. 명령줄을 열고 프로젝트 폴더로 이동합니다.

  2. eb health 명령을 실행하여 환경에 있는 인스턴스의 상태를 표시합니다. 이 예제에서는 Linux 환경에서 실행되는 인스턴스가 다섯 개입니다.

    ~/project $ eb health elasticBeanstalkExa-env Ok 2015-07-08 23:13:20 WebServer Ruby 2.1 (Puma) total ok warning degraded severe info pending unknown 5 5 0 0 0 0 0 0 instance-id status cause health Overall Ok i-d581497d Ok i-d481497c Ok i-136e00c0 Ok i-126e00c1 Ok i-8b2cf575 Ok instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests Overall 671.8 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000 i-d581497d 143.0 1430 0 0 0 0.003 0.002 0.001 0.001 0.000 i-d481497c 128.8 1288 0 0 0 0.003 0.002 0.001 0.001 0.000 i-136e00c0 125.4 1254 0 0 0 0.004 0.002 0.001 0.001 0.000 i-126e00c1 133.4 1334 0 0 0 0.003 0.002 0.001 0.001 0.000 i-8b2cf575 141.2 1412 0 0 0 0.003 0.002 0.001 0.001 0.000 instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu i-d581497d t2.micro 1a 12 mins 0.0 0.04 6.2 0.0 1.0 92.5 0.1 i-d481497c t2.micro 1a 12 mins 0.01 0.09 5.9 0.0 1.6 92.4 0.1 i-136e00c0 t2.micro 1b 12 mins 0.15 0.07 5.5 0.0 0.9 93.2 0.0 i-126e00c1 t2.micro 1b 12 mins 0.17 0.14 5.7 0.0 1.4 92.7 0.1 i-8b2cf575 t2.micro 1c 1 hour 0.19 0.08 6.5 0.0 1.2 92.1 0.1 instance-id status id version ago deployments i-d581497d Deployed 1 Sample Application 12 mins i-d481497c Deployed 1 Sample Application 12 mins i-136e00c0 Deployed 1 Sample Application 12 mins i-126e00c1 Deployed 1 Sample Application 12 mins i-8b2cf575 Deployed 1 Sample Application 1 hour

    이 예제에서는 Windows 환경에서 실행되는 단일 인스턴스가 하나입니다.

    ~/project $ eb health WindowsSampleApp-env Ok 2018-05-22 17:33:19 WebServer IIS 10.0 running on 64bit Windows Server 2016/2.2.0 total ok warning degraded severe info pending unknown 1 1 0 0 0 0 0 0 instance-id status cause health Overall Ok i-065716fba0e08a351 Ok instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests Overall 13.7 100.0 0.0 0.0 0.0 1.403 0.970 0.710 0.413 0.079 i-065716fba0e08a351 2.4 100.0 0.0 0.0 0.0 1.102* 0.865 0.601 0.413 0.091 instance-id type az running % user time % privileged time % idle time cpu i-065716fba0e08a351 t2.large 1b 4 hours 0.2 0.1 99.7 instance-id status id version ago deployments i-065716fba0e08a351 Deployed 2 Sample Application 4 hours

출력 읽기

출력은 화면 상단에 환경 이름, 환경의 전반적인 상태, 현재 날짜를 표시합니다.

elasticBeanstalkExa-env Ok 2015-07-08 23:13:20

다음 세 줄에는 환경 유형(이 사례에서는 "WebServer"), 구성(Ruby 2.1과 Puma), 각 일곱 가지 상태의 인스턴스 개수 정보가 표시됩니다.

WebServer Ruby 2.1 (Puma) total ok warning degraded severe info pending unknown 5 5 0 0 0 0 0 0

출력의 나머지 부분은 네 가지 섹션으로 나뉩니다. 첫 번째에는 환경 전반 및 각 인스턴스의 상태 및 상태의 원인이 표시됩니다. 다음 예제에서는 환경에서 상태가 Info인 두 인스턴스와 배포가 시작되었음을 나타내는 원인을 보여줍니다.

instance-id status cause health Overall Ok i-d581497d Info Performing application deployment (running for 3 seconds) i-d481497c Info Performing application deployment (running for 3 seconds) i-136e00c0 Ok i-126e00c1 Ok i-8b2cf575 Ok

상태 및 색상에 대한 자세한 내용은 상태의 색과 상태를 참조하십시오.

요청 섹션에는 각 인스턴스에 대한 웹 서버 로그의 정보가 표시됩니다. 이 예제에서 각 인스턴스는 정상적으로 요청을 받고 있으며 오류가 없습니다.

instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests Overall 13.7 100.0 0.0 0.0 0.0 1.403 0.970 0.710 0.413 0.079 i-d581497d 2.4 100.0 0.0 0.0 0.0 1.102* 0.865 0.601 0.413 0.091 i-d481497c 2.7 100.0 0.0 0.0 0.0 0.842* 0.788 0.480 0.305 0.062 i-136e00c0 4.1 100.0 0.0 0.0 0.0 1.520* 1.088 0.883 0.524 0.104 i-126e00c1 2.2 100.0 0.0 0.0 0.0 1.334* 0.791 0.760 0.344 0.197 i-8b2cf575 2.3 100.0 0.0 0.0 0.0 1.162* 0.867 0.698 0.477 0.076

cpu 섹션에는 각 인스턴스의 운영 체제 측정치가 표시됩니다. 출력은 운영 체제마다 다릅니다. Linux 환경에 대한 출력입니다.

instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu i-d581497d t2.micro 1a 12 mins 0.0 0.03 0.2 0.0 0.0 99.7 0.1 i-d481497c t2.micro 1a 12 mins 0.0 0.03 0.3 0.0 0.0 99.7 0.0 i-136e00c0 t2.micro 1b 12 mins 0.0 0.04 0.1 0.0 0.0 99.9 0.0 i-126e00c1 t2.micro 1b 12 mins 0.01 0.04 0.2 0.0 0.0 99.7 0.1 i-8b2cf575 t2.micro 1c 1 hour 0.0 0.01 0.2 0.0 0.1 99.6 0.1

Windows 환경에 대한 출력입니다.

instance-id type az running % user time % privileged time % idle time i-065716fba0e08a351 t2.large 1b 4 hours 0.2 0.0 99.8

서버 및 표시되는 운영 체제 측정치에 대한 자세한 내용은 인스턴스 측정치를 참조하십시오.

마지막 섹션인 배포에는 각 인스턴스의 배포 상태가 표시됩니다. 롤링 배포에 실패할 경우 표시된 배포 ID, 상태 및 버전 레이블을 사용하여 잘못된 버전을 실행하는 환경의 인스턴스를 식별할 수 있습니다.

instance-id status id version ago deployments i-d581497d Deployed 1 Sample Application 12 mins i-d481497c Deployed 1 Sample Application 12 mins i-136e00c0 Deployed 1 Sample Application 12 mins i-126e00c1 Deployed 1 Sample Application 12 mins i-8b2cf575 Deployed 1 Sample Application 1 hour

대화형 상태 보기

eb health 명령은 환경의 상태에 대한 스냅샷을 표시합니다. 표시된 정보를 10초마다 새로 고치려면 --refresh 옵션을 사용합니다.

$ eb health --refresh elasticBeanstalkExa-env Ok 2015-07-09 22:10:04 (1 secs) WebServer Ruby 2.1 (Puma) total ok warning degraded severe info pending unknown 5 5 0 0 0 0 0 0 instance-id status cause health Overall Ok i-bb65c145 Ok Application deployment completed 35 seconds ago and took 26 seconds i-ba65c144 Ok Application deployment completed 17 seconds ago and took 25 seconds i-f6a2d525 Ok Application deployment completed 53 seconds ago and took 26 seconds i-e8a2d53b Ok Application deployment completed 32 seconds ago and took 31 seconds i-e81cca40 Ok instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests Overall 671.8 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000 i-bb65c145 143.0 1430 0 0 0 0.003 0.002 0.001 0.001 0.000 i-ba65c144 128.8 1288 0 0 0 0.003 0.002 0.001 0.001 0.000 i-f6a2d525 125.4 1254 0 0 0 0.004 0.002 0.001 0.001 0.000 i-e8a2d53b 133.4 1334 0 0 0 0.003 0.002 0.001 0.001 0.000 i-e81cca40 141.2 1412 0 0 0 0.003 0.002 0.001 0.001 0.000 instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu i-bb65c145 t2.micro 1a 12 mins 0.0 0.03 0.2 0.0 0.0 99.7 0.1 i-ba65c144 t2.micro 1a 12 mins 0.0 0.03 0.3 0.0 0.0 99.7 0.0 i-f6a2d525 t2.micro 1b 12 mins 0.0 0.04 0.1 0.0 0.0 99.9 0.0 i-e8a2d53b t2.micro 1b 12 mins 0.01 0.04 0.2 0.0 0.0 99.7 0.1 i-e81cca40 t2.micro 1c 1 hour 0.0 0.01 0.2 0.0 0.1 99.6 0.1 instance-id status id version ago deployments i-bb65c145 Deployed 1 Sample Application 12 mins i-ba65c144 Deployed 1 Sample Application 12 mins i-f6a2d525 Deployed 1 Sample Application 12 mins i-e8a2d53b Deployed 1 Sample Application 12 mins i-e81cca40 Deployed 1 Sample Application 1 hour (Commands: Help,Quit, ▼ ▲ ◄ ►)

이 예제에서는 인스턴스를 최근에 한 개에서 다섯 개로 확장한 환경을 보여 줍니다. 확장 작업에 성공했으며, 모든 인스턴스가 이제 상태 확인을 통과하고 요청을 받을 준비가 되었습니다. 대화형 모드에서 상태는 10초마다 업데이트됩니다. 오른쪽 위 모서리에서 타이머는 다음 업데이트를 향해 움직입니다.

왼쪽 아래 모서리에서 보고서는 옵션 목록을 표시합니다. 대화형 모드를 종료하려면 Q를 누릅니다. 스크롤하려면 화살표 키를 누릅니다. 추가 명령 목록을 보려면 H를 누릅니다.

대화형 상태 보기 옵션

환경 상태를 대화식으로 보는 경우, 키보드 키를 사용하여 보기를 조정하고 Elastic Beanstalk에 개별 인스턴스를 바꾸거나 재부팅하라고 알릴 수 있습니다. 대화형 모드에서 상태 보고서를 보면서 사용 가능한 명령 목록을 보려면 H를 누릅니다.

up,down,home,end Scroll vertically left,right Scroll horizontally F Freeze/unfreeze data X Replace instance B Reboot instance <,> Move sort column left/right -,+ Sort order descending/ascending P Save health snapshot data file Z Toggle color/mono mode Q Quit this program Views 1 All tables/split view 2 Status Table 3 Request Summary Table 4 CPU%/Load Table H This help menu (press Q or ESC to return)