

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usar a EB CLI para monitorar a integridade do ambiente
<a name="health-enhanced-ebcli"></a>

A interface de linha de comando do [Elastic Beanstalk (EB CLI) é uma ferramenta de linha](eb-cli3.md) de comando para gerenciar ambientes. AWS Elastic Beanstalk Também é possível usar a CLI do EB para monitorar a integridade do ambiente em tempo real e com mais granularidade do que está disponível atualmente no console do Elastic Beanstalk

Depois de [instalar](eb-cli3.md#eb-cli3-install) e [configurar](eb-cli3-configuration.md) a EB CLI, você pode iniciar um novo ambiente e implantar seu código com o comando **eb create**. Se você já tem um ambiente criado no console do Elastic Beanstalk, é possível anexar a CLI do EB a ele, executando **eb init** em uma pasta do projeto e seguindo as solicitações (a pasta do projeto pode estar vazia). 

**Importante**  
Certifique-se de que está usando a versão mais recente da EB CLI executando `pip install` com a opção `--upgrade`:  

```
$ sudo pip install --upgrade awsebcli
```
Para concluir as instruções de instalação da CLI do EB, consulte [Instalar a EB CLI com script de configuração (recomendado)](eb-cli3.md#eb-cli3-install).

Para usar a EB CLI para monitorar a integridade do ambiente, configure primeiro uma pasta de projeto local executando **eb init** e seguindo as solicitações. Para obter instruções completas, consulte [Configurar a EB CLI](eb-cli3-configuration.md).

Se você já tem um ambiente em execução no Elastic Beanstalk e deseja usar a CLI do EB para monitorar a integridade, siga estas etapas para anexá-lo ao ambiente existente.

**Para anexar a EB CLI a um ambiente existente**

1. Abra um terminal de linha de comando e navegue até a pasta do usuário.

1. Crie e abra uma nova pasta para o seu ambiente.

1. Execute o comando **eb init** e escolha o aplicativo e o ambiente cuja integridade que você quer monitorar. Se você tiver apenas um ambiente executando o aplicativo escolhido, a CLI do EB o selecionará automaticamente e não será necessário escolher o ambiente, como mostra o exemplo a seguir.

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

**Para monitorar a integridade usando a EB CLI**

1. Abra uma linha de comando e navegue até a pasta do projeto.

1. Execute o comando **eb health** para exibir o status de integridade das instâncias em seu ambiente. Neste exemplo, há cinco instâncias em execução em um ambiente 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
   ```

   Neste exemplo, há uma única instância em execução em um ambiente 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
   ```

## Leitura da saída
<a name="health-enhanced-ebcli-output"></a>

A saída exibe o nome do ambiente, a integridade geral do ambiente e a data atual na parte superior da tela.

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

As próximas três linhas exibem o tipo de ambiente (” WebServer "neste caso), a configuração (Ruby 2.1 com Puma) e um detalhamento de quantas instâncias estão em cada um dos sete estados.

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

O resto da saída é dividido em quatro seções. A primeira exibe o *status* e a *causa* do status do ambiente geral e, em seguida, de cada instância. O exemplo a seguir mostra duas instâncias no ambiente com o status `Info` e a causa indicando que uma implantação foi iniciada.

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

Para informações sobre o status de integridade e cores, consulte [Status e cores de integridade](health-enhanced-status.md).

A seção de **solicitações** exibe informações de logs do servidor Web sobre cada instância. Neste exemplo, cada instância está fazendo solicitações normalmente e não há erros.

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

A seção de **cpu** mostra as métricas do sistema operacional de cada instância. A saída difere de acordo com o sistema operacional. Veja aqui a saída para ambientes 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
```

Veja aqui a saída para ambientes 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
```

Para obter informações sobre as métricas de servidor e de sistema operacional mostradas, consulte [Métricas de instância](health-enhanced-metrics.md).

A seção final, de **implantações**, mostra o status da implantação de cada instância. Se uma implantação contínua falhar, use o ID da implantação, o status e o rótulo da versão mostrados para identificar as instâncias no ambiente que estão executando a versão incorreta.

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

## Visualização de integridade interativa
<a name="health-enhanced-ebcli-interactive"></a>

O comando **eb health** exibe um snapshot da integridade do ambiente. Para atualizar as informações exibidas a cada 10 segundos, use a opção `--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, ▼ ▲ ◄ ►)
```

Este exemplo mostra um ambiente que foi recentemente ampliado de uma para cinco instâncias. A operação de escalabilidade foi bem-sucedida e agora todas as instâncias passam pelas verificações de integridade e estão prontas para fazer solicitações. No modo interativo, o status de integridade é atualizado a cada 10 segundos. No canto superior direito, um temporizador faz a contagem regressiva para a próxima atualização.

No canto inferior esquerdo, o relatório exibe uma lista de opções. Para sair do modo interativo, pressione **Q**. Para rolar, pressione as teclas de seta. Para ver uma lista de comandos adicionais, pressione **H**.

## Opções de visualização de integridade interativa
<a name="health-enhanced-ebcli-options"></a>

Na visualização interativa da integridade do ambiente, use o teclado para ajustar a visualização e informar ao Elastic Beanstalk para substituir ou reinicializar instâncias individuais. Para ver uma lista de comandos disponíveis na visualização do relatório de integridade no modo interativo, pressione **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)
```