Usar a EB CLI para monitorar a integridade do ambiente - AWS Elastic Beanstalk
Leitura da saídaVisualização de integridade interativaOpções de visualização de integridade interativa

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 Elastic Beanstalk Command Line Interface (EB CLI) é uma ferramenta da linha de comando de gerenciamento de ambientes do 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 e configurar 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.

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.

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.

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

  3. 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.

  2. 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 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.

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.

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

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

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)