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

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

EB CLI를 설치 및 구성한 후 새 환경을 시작하고 eb create 명령을 사용하여 코드를 여기에 배포할 수 있습니다. Elastic Beanstalk 콘솔에서 생성한 환경이 이미 있는 경우, 프로젝트 폴더에서 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를 연결하려면

명령줄 터미널을 열고 사용자 폴더로 이동합니다.
환경에 새 폴더를 생성하고 엽니다.
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를 사용하여 상태를 모니터링하려면

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

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)

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

CodeCommit

환경 작성