

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

# EB CLI를 사용하여 환경 상태 모니터링
<a name="health-enhanced-ebcli"></a>

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

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

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

```
$ sudo pip install --upgrade awsebcli
```
EB CLI 설치에 대한 전체 지침은 [설정 스크립트를 사용하여 EB CLI 설치(권장)](eb-cli3.md#eb-cli3-install) 단원을 참조하세요.

EB CLI를 사용하여 환경의 상태를 모니터링하려면 먼저 **eb init**를 실행하고 프롬프트에 따라 로컬 프로젝트 폴더를 구성해야 합니다. 전체 지침은 [EB CLI 구성](eb-cli3-configuration.md) 섹션을 참조하세요.

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

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

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

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

1. **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. 명령줄을 열고 프로젝트 폴더로 이동합니다.

1. **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
   ```

## 출력 읽기
<a name="health-enhanced-ebcli-output"></a>

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

```
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
```

상태 및 색상에 대한 자세한 내용은 [상태 색상 및 상태](health-enhanced-status.md) 단원을 참조하세요.

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

```
  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
```

서버 및 표시되는 운영 체제 측정치에 대한 자세한 내용은 [인스턴스 지표](health-enhanced-metrics.md) 단원을 참조하세요.

마지막 섹션인 **배포**에는 각 인스턴스의 배포 상태가 표시됩니다. 롤링 배포에 실패할 경우 표시된 배포 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
```

## 대화형 상태 보기
<a name="health-enhanced-ebcli-interactive"></a>

**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**를 누릅니다.

## 대화형 상태 보기 옵션
<a name="health-enhanced-ebcli-options"></a>

환경 상태를 대화식으로 보는 경우, 키보드 키를 사용하여 보기를 조정하고 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)
```