

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

# Verificações de integridade para instâncias em um grupo do Auto Scaling
<a name="ec2-auto-scaling-health-checks"></a>

O Amazon EC2 Auto Scaling monitora continuamente o status de integridade das instâncias em um grupo do Auto Scaling para manter a capacidade desejada. 

Todas as instâncias do seu grupo do Auto Scaling começam com um status`Healthy`. Supõe-se que as instâncias estejam íntegras, a menos que o Amazon EC2 Auto Scaling receba uma notificação informando do contrário. Ele pode receber notificações de várias fontes quando uma instância se torna inadequada e precisa ser substituída. Essas fontes incluem o seguinte:
+ Amazon EC2
+ Elastic Load Balancing
+ Estrutura de PVC
+ Amazon EBS
+ Verificações de integridade personalizadas que você define

Quando o Amazon EC2 Auto Scaling determina que uma `InService` instância não está íntegra, ele a substitui por uma nova instância. A nova instância é iniciada usando as configurações atuais do grupo do Auto Scaling e seu modelo de execução associado ou configuração de execução.

O fluxograma a seguir ilustra o processo de execução de uma nova instância em um grupo do Auto Scaling. Ele começa com a execução da instância. Se a execução for bem-sucedida, a instância será adicionada ao grupo do Auto Scaling. Em seguida, o Amazon EC2 Auto Scaling realiza verificações de integridade na instância usando as verificações de estado integradas do Amazon EC2 e, após um período de carência, quaisquer verificações de integridade opcionais que você tenha ativado para o grupo. Essas verificações de integridade continuam periodicamente. Se alguma das verificações de integridade falhar, a instância será substituída.

![\[Um diagrama geral que mostra quando as verificações de integridade são iniciadas.\]](http://docs.aws.amazon.com/pt_br/autoscaling/ec2/userguide/images/how-health-checks-work.png)


Instâncias não íntegras também podem ocorrer quando uma instância é terminada inesperadamente, por exemplo, devido a uma interrupção da instância spot ou terminação manual por um usuário. Novamente, o Amazon EC2 Auto Scaling iniciará automaticamente uma instância de substituição nesses casos para manter a capacidade desejada.

**Topics**
+ [Sobre as verificações de integridade do seu grupo do Auto Scaling](health-checks-overview.md)
+ [Definir um período de carência da verificação de integridade para um grupo do Auto Scaling](health-check-grace-period.md)
+ [Monitore as instâncias do Auto Scaling com volumes do Amazon EBS com problemas usando verificações de integridade](monitor-and-replace-instances-with-impaired-ebs-volumes.md)
+ [Configuração de uma verificação de integridade personalizada para seu grupo do Auto Scaling](set-up-a-custom-health-check.md)
+ [Veja o motivo das falhas na verificação de integridade](replace-unhealthy-instance.md)
+ [Solução de problemas de instâncias não íntegras no Amazon EC2 Auto Scaling](ts-as-healthchecks.md)

# Sobre as verificações de integridade do seu grupo do Auto Scaling
<a name="health-checks-overview"></a>

Este tópico fornece uma visão geral dos tipos de verificação de integridade disponíveis e descreve as principais considerações para integrar as verificações de integridade do Amazon EC2 Auto Scaling às suas aplicações.

**Topics**
+ [Tipo de verificação de integridade](#available-health-checks)
+ [Verificações de integridade do Amazon EC2](#instance-health-detection)
+ [Verificações de saúde do Elastic Load Balancing](#elastic-load-balancing-health-checks)
+ [Verificações de integridade do VPC Lattice](#vpc-lattice-health-checks)
+ [Como o Amazon EC2 Auto Scaling minimiza o tempo de inatividade](#minimize-downtime)
+ [Verificações de integridade para instâncias em uma associação de alta atividade](#health-checks-for-instance-in-a-warm-pool)
+ [Considerações sobre a verificação de integridade](#health-check-considerations)

## Tipo de verificação de integridade
<a name="available-health-checks"></a>

O Amazon EC2 Auto Scaling pode determinar o status de integridade de uma instância da `InService` usando uma ou mais das seguintes verificações de integridade:


****  

| Tipo de verificação de integridade | O que ele verifica | 
| --- | --- | 
|  Verificações de status do Amazon EC2 e eventos programados  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/autoscaling/ec2/userguide/health-checks-overview.html) Esse é o tipo padrão de verificação de integridade para um grupo do Auto Scaling.   | 
|  Verificações de saúde do Elastic Load Balancing  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/autoscaling/ec2/userguide/health-checks-overview.html) Para executar esse tipo de verificação de integridade, é necessário habilitá-lo para seu grupo do Auto Scaling.  | 
|  Verificações de integridade do VPC Lattice  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/autoscaling/ec2/userguide/health-checks-overview.html) Para executar esse tipo de verificação de integridade, é necessário habilitá-lo para seu grupo do Auto Scaling.  | 
|  Verificações de saúde do Amazon EBS  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/autoscaling/ec2/userguide/health-checks-overview.html) Para executar esse tipo de verificação de integridade, é necessário habilitá-lo para seu grupo do Auto Scaling.  | 
|  Verificações de integridade personalizadas  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/autoscaling/ec2/userguide/health-checks-overview.html)  | 

## Verificações de integridade do Amazon EC2
<a name="instance-health-detection"></a>

Depois que uma instância é executada, ela é anexada ao grupo do Auto Scaling e entra no estado`InService`. Para obter mais informações sobre os diferentes status do ciclo de vida de instâncias em um grupo do Auto Scaling, consulte [Ciclo de vida das instâncias do Amazon EC2 Auto Scaling](ec2-auto-scaling-lifecycle.md).

O Amazon EC2 Auto Scaling verifica periodicamente o status de integridade de todas as instâncias no grupo do Auto Scaling para garantir que elas estejam em execução e em boas condições. 

**Verificações do status**  
O Amazon EC2 Auto Scaling usa os resultados das verificações de status da instância do Amazon EC2 para determinar o status de integridade de uma instância. Se a instância estiver em qualquer estado do Amazon EC2 diferente de `running` ou se o status para as verificações de status mudar para `impaired`, o Amazon EC2 Auto Scaling considerará a instância como não íntegra e a substituirá. Isso inclui quando a instância tenha qualquer um dos seguintes estados:
+  `stopping` 
+  `stopped` 
+  `shutting-down` 
+  `terminated` 

As verificações de status do Amazon EC2 não exigem nenhuma configuração especial e estão sempre habilitadas. Para obter mais informações, consulte [Tipos de verificações de status](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-system-instance-status-check.html#types-of-instance-status-checks) no *Manual do usuário do Amazon EC2 para instâncias do Linux*. 

**Importante**  
O Amazon EC2 Auto Scaling permite que essas verificações de status falhem ocasionalmente sem realizar qualquer ação. Quando uma verificação de status falha, o Amazon EC2 Auto Scaling espera alguns AWS minutos para corrigir o problema. Ele não marca imediatamente uma instância `Unhealthy` quando seu status para as verificações de status se torna `impaired`. Além disso, o EC2 Auto Scaling não marcará a instância como `Unhealthy` se uma verificação de status retornar `insufficient-data`.  
No entanto, se o Amazon EC2 Auto Scaling detectar que uma instância não está mais no estado`running`, essa situação será tratada como uma falha imediata. Neste caso, marca imediatamente a instância `Unhealthy` e a substitui. 

**Eventos agendados**  
O Amazon EC2 pode agendar ocasionalmente eventos em suas instâncias que serão executados após um carimbo de data/hora específico. Para obter mais informações, consulte [Eventos programados para sua instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-instances-status-check_sched.html) no *Guia do usuário do Amazon EC2 para instâncias do Linux*.

Se uma de suas instâncias for afetada por um evento programado, o Amazon EC2 Auto Scaling considerará a instância como não íntegra e a substituirá. A instância não começa a ser encerrada até que a data e a hora especificadas no carimbo de data/hora sejam atingidas.

## Verificações de saúde do Elastic Load Balancing
<a name="elastic-load-balancing-health-checks"></a>

Quando você habilita as verificações de integridade do Elastic Load Balancing para seu grupo do Auto Scaling, o Amazon EC2 Auto Scaling pode usar os resultados dessas verificações de integridade para determinar o status de integridade de uma instância.

Antes de ativar as verificações de integridade do Elastic Load Balancing para o seu grupo do Auto Scaling, é necessário configurar um balanceador de carga do Elastic Load Balancing e configurar uma verificação de integridade para ele a fim de determinar se as instâncias estão íntegras. Para obter mais informações, consulte [Para anexar um balanceador de carga do Elastic Load Balancing a uma camada](getting-started-elastic-load-balancing.md).

Depois de anexar o balanceador de carga ao seu grupo do Auto Scaling, ocorre o seguinte: 
+ O Amazon EC2 Auto Scaling registrará as instâncias no grupo do Auto Scaling com o balanceador de carga.
+ Depois que uma instância termina de registrar, ela entra no estado `InService` e fica disponível para uso com o balanceador de carga.

Por padrão, o Amazon EC2 Auto Scaling ignora os resultados das verificações de integridade do Elastic Load Balancing. Depois de fazer isso, quando o Elastic Load Balancing relata uma instância registrada como`Unhealthy`, o Amazon EC2 Auto Scaling marca a instância `Unhealthy` na próxima verificação de integridade periódica e a substitui.

Se a drenagem da conexão (atraso de cancelamento de registro) estiver habilitada para seu balanceador de carga, o Amazon EC2 Auto Scaling aguardará que as solicitações em andamento sejam concluídas ou que o tempo limite máximo expire antes de terminar instâncias não íntegras. 

**nota**  
Para obter instruções sobre como anexar o balanceador de carga e ativar as verificações de integridade do Elastic Load Balancing para seu grupo do Auto Scaling, consulte [Este tópico descreve como anexar um balanceador de carga Elastic Load Balancing ao grupo do Auto Scaling.](attach-load-balancer-asg.md).  
Quando você habilita as verificações de integridade do Elastic Load Balancing para um grupo, o Amazon EC2 Auto Scaling pode substituir instâncias que o Elastic Load Balancing relata como não íntegras, mas somente depois que o balanceador de carga estiver no `InService` estado. Para obter mais informações, consulte [Verificar o status do anexo de seu balanceador de carga](load-balancer-status.md).

## Verificações de integridade do VPC Lattice
<a name="vpc-lattice-health-checks"></a>

Por padrão, o Amazon EC2 Auto Scaling ignora os resultados das verificações de integridade da VPC Lattice. Opcionalmente, você pode ativar essas verificações de integridade para seu grupo do Auto Scaling. Depois de fazer isso, quando o VPC Lattice relata uma instância registrada como`Unhealthy`, o Amazon EC2 Auto Scaling marca a instância `Unhealthy` na próxima verificação de integridade periódica e a substitui. O processo de registrar instâncias e, em seguida, verificar sua integridade funciona da mesma forma que as verificações de integridade do Elastic Load Balancing.

**nota**  
Para obter instruções sobre como anexar o grupo-alvo do VPC Lattice e ativar as verificações de integridade do VPC Lattice para o grupo do Auto Scaling, consulte [Anexe um grupo de destino VPC Lattice ao seu grupo do Auto Scaling](attach-vpc-lattice-target-group-asg.md).  
Quando você habilita verificações de integridade do VPC Lattice para um grupo, o Amazon EC2 Auto Scaling pode substituir instâncias que o VPC Lattice relata como não íntegras, mas somente depois que o grupo de destino estiver no estado `InService`. Para obter mais informações, consulte [Verifique o status do anexo do grupo de destino do VPC Lattice](verify-target-group-attachment-status.md).

## Como o Amazon EC2 Auto Scaling minimiza o tempo de inatividade
<a name="minimize-downtime"></a>

Por padrão, as novas instâncias são provisionadas ao mesmo tempo em que as instâncias existentes são terminadas, o que pode impedir que novas solicitações sejam aceitas até que as novas instâncias estejam totalmente operacionais. 

Se o Amazon EC2 Auto Scaling determinar que alguma instância não está mais em execução (ou `Unhealthy` foi marcada [set-instance-health](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/set-instance-health.html)com o comando), ele a substituirá imediatamente. No entanto, se houver outras instâncias não íntegras, o Amazon EC2 Auto Scaling usará a abordagem a seguir para se recuperar de falhas. Esta abordagem minimiza qualquer tempo de inatividade que possa ocorrer devido a problemas temporários ou verificações de integridade mal configuradas. 
+ Se houver uma ação de escalabilidade em andamento e seu grupo do Auto Scaling estiver abaixo da capacidade desejada em 10% ou mais, o Amazon EC2 Auto Scaling aguarda a atividade de escalabilidade em andamento antes de substituir as instâncias não íntegras.
+ Ao aumentar a escala horizontalmente, o Amazon EC2 Auto Scaling aguarda que as instâncias passem por uma verificação de integridade inicial. Ele também aguarda que o aquecimento padrão de instância seja concluído para garantir que as novas instâncias estejam prontas.
+ Depois que as instâncias terminarem de aquecer e o grupo tiver aumentado para acima de 90% da capacidade desejada, o Amazon EC2 Auto Scaling substituirá as instâncias não íntegras da seguinte maneira: 
  + O Amazon EC2 Auto Scaling substitui apenas até 10% da capacidade desejada do grupo por vez. Ele faz isso até que todas as instâncias não íntegras sejam substituídas. 
  + Ao substituir instâncias, ele espera que as novas instâncias passem por uma verificação de integridade inicial. Ele também aguarda que o aquecimento padrão de instância seja concluído antes de continuar.

**nota**  
Se o tamanho de um grupo do Auto Scaling for suficientemente pequeno para que o valor resultante de 10% seja menor que um, o Amazon EC2 Auto Scaling substituirá cada uma das instâncias não íntegras de cada vez. Isso pode resultar em tempo de inatividade para o grupo.
É possível modificar o valor padrão de 10% [definindo uma política de manutenção de instâncias](https://docs.aws.amazon.com//autoscaling/ec2/userguide/set-instance-maintenance-policy-on-group.html) para alterar a taxa na qual o Auto Scaling substitui instâncias não íntegras. No entanto, o Auto Scaling ainda pode limitar a taxa de marcação de instâncias como não íntegras.  
Por exemplo, se todas as instâncias em um grupo do Auto Scaling forem relatadas como não íntegras pelas verificações de integridade do Elastic Load Balancing e o balanceador de carga estiver no estado `InService`, o Amazon EC2 Auto Scaling poderá marcar menos instâncias não íntegras de cada vez. Isso pode resultar em muito menos instâncias substituídas por vez do que os 10% aplicados em outros cenários. Isso fornece tempo para resolver o problema sem que o Amazon EC2 Auto Scaling encerre automaticamente todo o grupo.

## Verificações de integridade para instâncias em uma associação de alta atividade
<a name="health-checks-for-instance-in-a-warm-pool"></a>

Saiba mais sobre as verificações de integridade do Amazon EC2 Auto Scaling para instâncias em um pool ativo. Para obter mais informações, consulte [Visualizar o status e o motivo de falhas da verificação de integridade](warm-pools-health-checks-monitor-view-status.md). 

## Considerações sobre a verificação de integridade
<a name="health-check-considerations"></a>

Veja a seguir algumas considerações ao usar as verificações de integridade do Amazon EC2 Auto Scaling.
+ Se precisar que algo aconteça na instância que está sendo terminada ou na instância que está iniciando, você poderá usar ganchos do ciclo de vida. Esses hooks permitem que você execute uma ação personalizada à medida que o Amazon EC2 Auto Scaling inicia ou encerra instâncias. Para obter mais informações, consulte [Ganchos do ciclo de vida do Amazon EC2 Auto Scaling](lifecycle-hooks.md). 
+ O Amazon EC2 Auto Scaling não fornece um modo de remover as verificações de status e eventos programados do Amazon EC2 das verificações de integridade. Se você não quiser que as instâncias sejam substituídas, recomendamos suspender o processo `ReplaceUnhealthy` e `HealthCheck` para grupos do Auto Scaling individuais. Para obter mais informações, consulte [Suspender e retomar os processos do Amazon EC2 Auto Scaling](as-suspend-resume-processes.md). 
+ Para redefinir manualmente o status de integridade de uma instância não `Healthy` íntegra, tente usar o [set-instance-health](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/set-instance-health.html)comando. Se você receber um erro, provavelmente a instância já está encerrando. Geralmente, redefinir o status de integridade de uma instância `Healthy` com o [set-instance-health](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/set-instance-health.html)comando só é útil nos casos em que o `ReplaceUnhealthy` processo ou o `Terminate` processo estão suspensos. 
+ Se você precisar solucionar problemas de uma instância sem a interferência de verificações de integridade, poderá colocar a instância no estado `Standby`. O Amazon EC2 Auto Scaling não executa verificações de integridade em instâncias que estão no estado `Standby`. Para obter mais informações, consulte [Remover temporiamente instâncias do grupo do Auto Scaling](as-enter-exit-standby.md). 
+ Quando a instância é encerrada, qualquer endereço IP elástico é dissociado e não é automaticamente associado à nova instância. É necessário associar manualmente os endereços IP elásticos à nova instância ou fazer isso automaticamente com uma solução baseada em gancho do ciclo de vida. Para obter mais informações, consulte [Endereços IP elásticos](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html) no *Guia do usuário do Amazon EC2*.
+ Da mesma forma, quando sua instância é terminada, seus volumes de EBS anexados são desvinculados (ou excluídos, dependendo do atributo `DeleteOnTermination`). É necessário anexar manualmente esses volumes do EBS à nova instância ou fazer isso automaticamente com uma solução baseada em gancho do ciclo de vida. Para obter mais informações, consulte [Associar um volume do Amazon EBS a uma instância](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-attaching-volume.html) no *Guia do usuário do Amazon EBS*.

# Definir um período de carência da verificação de integridade para um grupo do Auto Scaling
<a name="health-check-grace-period"></a>

Quando uma verificação de integridade do Amazon EC2 Auto Scaling determina que uma `InService` instância não está íntegra, ela a substitui por uma nova instância. O período de carência da verificação de integridade especifica o tempo mínimo (em segundos) que uma nova instância será mantida em serviço antes de ser terminada, caso não esteja íntegra.

Um exemplo de caso de uso pode ser a exigência de que o Amazon EC2 Auto Scaling evite realizar ações se as verificações de integridade do Elastic Load Balancing falharem porque uma instância ainda está sendo inicializada. As verificações de integridade do Elastic Load Balancing são executadas em paralelo, começando quando a instância é registrada no balanceador de carga. O período de carência evita que o Amazon EC2 Auto Scaling marque suas instâncias recém-iniciadas `Unhealthy` e as encerre desnecessariamente se elas não passarem imediatamente nessas verificações de integridade após entrarem no `InService` estado.

Por padrão, o período de carência da verificação de integridade é de 300 segundos quando você cria um grupo do Auto Scaling. Seu valor padrão é 0 segundos quando você cria um grupo de Auto Scaling usando o AWS CLI ou um SDK. O valor 0 desativa um período de carência da verificação de integridade. 

Definir um valor muito alto reduz a eficácia das verificações de integridade do Amazon EC2 Auto Scaling. Se você usar ganchos do ciclo de vida para iniciar a instância, poderá definir o valor do período de carência da verificação de integridade como 0. Com ganchos do ciclo de vida, o Amazon EC2 Auto Scaling fornece uma maneira de garantir que as instâncias sejam sempre inicializadas antes de entrarem no estado `InService`. Para obter mais informações, consulte [Ganchos do ciclo de vida do Amazon EC2 Auto Scaling](lifecycle-hooks.md).

O período de carência se aplica às seguintes instâncias:
+ Instâncias recém-lançadas
+ Instâncias que são colocadas de volta em serviço após estarem em espera
+ Instâncias que você anexa manualmente ao grupo

**Importante**  
Durante o período de carência da verificação de integridade, se o Amazon EC2 Auto Scaling detectar que uma instância não está mais no estado Amazon EC2, `running` ele marcará imediatamente a instância `Unhealthy` e a substituirá. Por exemplo, se você interromper uma instância em um grupo do Auto Scaling, ela será marcada `Unhealthy` e substituída.

## Definir um período de carência da verificação de integridade para um grupo
<a name="set-health-check-grace-period"></a>

Definir um período de carência da verificação de integridade para grupos do Auto Scaling existentes.

------
#### [ Console ]

**Para modificar o período de carência da verificação de integridade para um grupo novo ()**  
Quando você cria o grupo do Auto Scaling, na página **Configure advanced options** (Configurar opções avançadas), em **Health checks** (Verificações de integridade), **Health check grace period** (Período de carência da verificação de integridade), insira a quantidade de tempo em segundos. Esse é o tempo que o Amazon EC2 Auto Scaling precisa aguardar antes de verificar o status de integridade de uma instância depois que ela entra no estado`InService`.

------
#### [ AWS CLI ]

**Para modificar o período de carência da verificação de integridade para um grupo novo ()**  
Adicione a `--health-check-grace-period` opção ao [create-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-auto-scaling-group.html)comando. O exemplo a seguir configura o período de carência da verificação de integridade com um valor de `60` segundos para um novo grupo do Auto Scaling denominado `my-asg`.

```
aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
  --health-check-grace-period 60 ...
```

------

------
#### [ Console ]

**Para modificar o período de carência da verificação de integridade para um grupo existente ()**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e escolha **Auto Scaling Groups** no painel de navegação.

1. Na barra de navegação na parte superior da tela, escolha a mesma Região da AWS na qual você criou o grupo do Auto Scaling.

1. Marque a caixa de seleção ao lado do grupo do Auto Scaling.

   Um painel dividido é aberto na parte inferior da página. 

1. Na guia **Detalhes**, escolha **Verificações de integridade**, **Editar**.

1. Em **Health check grace period** (Período de carência da verificação de integridade), insira a quantidade de tempo em segundos. Esse é o tempo que o Amazon EC2 Auto Scaling precisa aguardar antes de verificar o status de integridade de uma instância depois que ela entra no estado`InService`.

1. Selecione **Atualizar**.

------
#### [ AWS CLI ]

**Para modificar o período de carência da verificação de integridade para um grupo existente ()**  
Adicione a `--health-check-grace-period` opção ao [update-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/update-auto-scaling-group.html)comando. O exemplo a seguir configura o período de carência da verificação de integridade com um valor de `120` segundos para um grupo do Auto Scaling existente denominado `my-asg`.

```
aws autoscaling update-auto-scaling-group --auto-scaling-group-name my-asg \
  --health-check-grace-period 120
```

------

**nota**  
Também é altamente recomendável definir o tempo de aquecimento padrão da instância para o grupo do Auto Scaling. Para obter mais informações, consulte [Definir o aquecimento padrão da instância para um grupo do Auto Scaling](ec2-auto-scaling-default-instance-warmup.md).

# Monitore as instâncias do Auto Scaling com volumes do Amazon EBS com problemas usando verificações de integridade
<a name="monitor-and-replace-instances-with-impaired-ebs-volumes"></a>

Você pode ativar as verificações de integridade do Amazon EBS para seu grupo do Auto Scaling para garantir que o Amazon EC2 Auto Scaling monitore todo o sistema no qual sua aplicação é executada. 

Depois que você ativar essas verificações de integridade, o Amazon EC2 Auto Scaling receberá os resultados das verificações de estado do Amazon EC2 realizadas nos volumes EBS anexados de uma instância. Se um volume não estiver acessível ou não passar nas verificações de I/O status, a verificação de integridade falhará e a instância correspondente será considerada não íntegra. Quando o Amazon EC2 Auto Scaling determina que uma instância não está íntegra, ele a substitui por uma nova instância. 

Este tópico pressupõe que você esteja familiarizado com as verificações de estado do EBS anexadas. Caso contrário, consulte a seção [Verificações de estado do EBS anexado](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-system-instance-status-check.html#attached-ebs-status-checks) do *Guia do usuário do Amazon EC2* para obter mais informações. O tópico a seguir descreve como ativar as verificações de integridade do Amazon EC2 Auto Scaling que dependem das verificações de estado do EBS anexado. 

**nota**  
Você pode ativar as verificações de integridade do Amazon EBS para todos os seus grupos do Auto Scaling. No entanto, essas verificações de integridade só estão disponíveis para [instâncias criadas no Nitro System da AWS](https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html).

## Ativar as verificações de integridade do Amazon EBS para um grupo
<a name="turn-on-ebs-health-checks"></a>

Você pode ativar as verificações de integridade do Amazon EBS para grupos do Auto Scaling novos e existentes.

------
#### [ Console ]

**Ativação das verificações de integridade do Amazon EBS para um novo grupo**  
Ao criar o grupo do Auto Scaling, na página **Configurar opções avançadas**, para **Verificações de integridade**, **Tipos adicionais de verificação de integridade**, selecione **Ativar verificações de integridade do Amazon EBS**. Em seguida, para **Período de carência da verificação de integridade**, insira a quantidade de tempo em segundos. Esse é o tempo que o Amazon EC2 Auto Scaling precisa aguardar antes de verificar o status de integridade de uma instância depois que ela entra no estado`InService`. Para obter mais informações, consulte [Definir um período de carência da verificação de integridade para um grupo do Auto Scaling](health-check-grace-period.md). 

------
#### [ AWS CLI ]

**Ativação das verificações de integridade do Amazon EBS para um novo grupo**  
Adicione a `--health-check-type` opção ao [create-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-auto-scaling-group.html)comando. O exemplo a seguir especifica **`EBS`** para a opção `--health-check-type` para um novo grupo do Auto Scaling chamado `my-asg`.

```
aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
  --health-check-type "EBS" --health-check-grace-period 60 ...
```

Você pode especificar vários valores para o elemento `--health-check-type`. Por exemplo, para adicionar os tipos de verificações de integridade do Amazon EBS e do Elastic Load Balancing, use o seguinte comando. 

```
aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
  --health-check-type "EBS,ELB" --health-check-grace-period 60 ...
```

Os nomes dos valores diferenciam maiúsculas de minúsculas.

------

------
#### [ Console ]

**Ativação das verificações de integridade do Amazon EBS para um grupo existente**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e escolha **Auto Scaling Groups** no painel de navegação.

1. Na barra de navegação na parte superior da tela, escolha a mesma Região da AWS na qual você criou o grupo do Auto Scaling.

1. Marque a caixa de seleção ao lado de um grupo existente.

   Um painel dividido é aberto na parte inferior da página **Auto Scaling groups** (Grupos do Auto Scaling). 

1. Na guia **Detalhes**, escolha **Verificações de integridade**, **Editar**.

1. Em **Verificações de integridade**, **Tipos adicionais de verificação de integridade**, selecione **Ativar verificações de integridade do Amazon EBS**.

1. Em **Período de carência da verificação de integridade**, insira a quantidade de tempo em segundos. Esse é o tempo que o Amazon EC2 Auto Scaling precisa aguardar antes de verificar o status de integridade de uma instância depois que ela entra no estado`InService`. Para obter mais informações, consulte [Definir um período de carência da verificação de integridade para um grupo do Auto Scaling](health-check-grace-period.md). 

1. Selecione **Atualizar**.

------
#### [ AWS CLI ]

**Ativação das verificações de integridade do Amazon EBS para um grupo existente**  
Adicione a `--health-check-type` opção ao [update-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/update-auto-scaling-group.html)comando. O exemplo a seguir especifica `EBS` para a opção `--health-check-type` para um grupo do Auto Scaling existente chamado `my-asg`.

```
aws autoscaling update-auto-scaling-group --auto-scaling-group-name my-asg \
  --health-check-type "EBS" --health-check-grace-period 60
```

Para usar vários tipos de verificações de integridade, você pode especificar vários valores (por exemplo, `EBS,ELB`) para a opção `--health-check-type`. 

Os nomes dos valores diferenciam maiúsculas de minúsculas.

------

# Desativar as verificações de integridade do Amazon EBS para um grupo do Auto Scaling
<a name="turn-off-ebs-health-checks"></a>

O tópico a seguir descreve como desativar as verificações de integridade do Amazon EBS para um grupo do Auto Scaling. Se você não precisar mais das verificações de integridade do Amazon EBS, use o procedimento a seguir para desativá-las.

------
#### [ Console ]

**Desativação das verificações de integridade do Amazon EBS para um novo grupo**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e escolha **Auto Scaling Groups** no painel de navegação.

1. Marque a caixa de seleção ao lado de um grupo existente.

   Um painel dividido é aberto na parte inferior da página **Auto Scaling groups** (Grupos do Auto Scaling). 

1. Na guia **Detalhes**, escolha **Verificações de integridade**, **Editar**.

1. Em **Verificações de integridade**, **Tipos adicionais de verificação de integridade**, desmarque **Ativar verificações de integridade do Amazon EBS**.

1. Selecione **Atualizar**.

------
#### [ AWS CLI ]

**Desativação das verificações de integridade do Amazon EBS para um novo grupo**  
Para atualizar as verificações de saúde em um grupo do Auto Scaling para que ele não use mais as verificações de saúde do Amazon EBS, use o comando. [update-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/update-auto-scaling-group.html) Inclua a opção `--health-check-type` e um valor de `EC2`.

```
aws autoscaling update-auto-scaling-group --auto-scaling-group-name my-asg \
  --health-check-type "EC2"
```

Para desativar as verificações de integridade do Amazon EBS sem desativar outros tipos de verificação de integridade (como o Elastic Load Balancing), é necessário especificá-las em vez de `EC2`. Por exemplo, para verificações de integridade do Elastic Load Balancing, especifique `ELB` para a opção `--health-check-type`. 

Os nomes dos valores diferenciam maiúsculas de minúsculas.

------

# Configuração de uma verificação de integridade personalizada para seu grupo do Auto Scaling
<a name="set-up-a-custom-health-check"></a>

Você pode usar verificações de integridade personalizadas para complementar as opções de verificação de integridade existentes fornecidas pelo Amazon EC2 Auto Scaling. Ao combinar verificações de integridade personalizadas com outros tipos de verificação de integridade, é possível criar um sistema abrangente de monitoramento de integridade adaptado às necessidades da sua aplicação.

Para começar, crie testes personalizados para verificar se as instâncias em seu grupo do Auto Scaling estão funcionando corretamente e podem lidar com o tráfego de entrada. Se a verificação de integridade que você configurar detectar que uma instância não está respondendo, marque essa instância específica como `Unhealthy`, o que faz com que o Amazon EC2 Auto Scaling a substitua imediatamente. 

Você pode enviar as informações de integridade da instância diretamente ao Amazon EC2 Auto Scaling usando a AWS CLI ou um SDK. Os exemplos a seguir mostram como usar o AWS CLI para configurar o status de integridade de uma instância e depois verificar o status de integridade da instância.

Use o [set-instance-health](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/set-instance-health.html)comando a seguir para definir o status de integridade da instância especificada como`Unhealthy`.

```
aws autoscaling set-instance-health --instance-id i-1234567890abcdef0 --health-status Unhealthy
```

Por padrão, esse comando respeita o período de carência da verificação de integridade. Porém, é possível substituir esse comportamento e não respeitar o período de carência incluindo a opção`--no-should-respect-grace-period`.

Use o [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)comando a seguir para verificar se o status de integridade da instância é`Unhealthy`.

```
aws autoscaling describe-auto-scaling-groups --auto-scaling-group-names my-asg
```

O exemplo a seguir é de uma resposta que mostra que o status de integridade da instância é `Unhealthy` e que a instância está sendo encerrada.

```
{
    "AutoScalingGroups": [
        {
            ....
            "Instances": [
                {
                    "ProtectedFromScaleIn": false,
                    "AvailabilityZone": "us-west-2a",
                    "LaunchTemplate": {
                        "LaunchTemplateName": "my-launch-template",
                        "Version": "1",
                        "LaunchTemplateId": "lt-1234567890abcdef0"
                    },
                    "InstanceId": "i-1234567890abcdef0",
                    "InstanceType": "t2.micro",
                    "HealthStatus": "Unhealthy",
                    "LifecycleState": "Terminating"
                },
                ...
            ]
        }
    ]
}
```

# Veja o motivo das falhas na verificação de integridade
<a name="replace-unhealthy-instance"></a>

Usando o procedimento a seguir, você pode exibir informações sobre todas as instâncias substituídas devido a uma verificação de integridade.

Por padrão, o Amazon EC2 Auto Scaling cria uma nova atividade de escalabilidade para encerrar a instância não íntegra e, em seguida, finaliza-a. Enquanto a instância estiver sendo encerrada, outra atividade de escalonamento iniciará uma nova instância. Você pode alterar esse comportamento para iniciar uma nova instância primeiro usando uma política de manutenção de instâncias. Para obter mais informações, consulte [Políticas de manutenção de instância](ec2-auto-scaling-instance-maintenance-policy.md).

------
#### [ Console ]

**Para visualizar o motivo das falhas de verificação de integridade ()**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e escolha **Auto Scaling Groups** no painel de navegação.

1. Marque a caixa de seleção ao lado do grupo do Auto Scaling. 

   Um painel dividido é aberto na parte inferior da página **Auto Scaling groups** (Grupos do Auto Scaling). 

1. Na guia **Activity** (Atividade), em **Activity history** (Histórico de atividades), a coluna **Status** mostra se o seu grupo do Auto Scaling iniciou ou terminou instâncias com êxito.

   Se ele terminou quaisquer instâncias não íntegras, a coluna **Cause** (Causa) mostrará a data e a hora do término e o motivo da falha na verificação de integridade. Por exemplo, .`At 2022-05-14T20:11:53Z an instance was taken out of service in response to a user health-check` Essa mensagem indica que uma verificação de integridade personalizada marcou a instância como não íntegra. 

   Para obter ajuda com falhas na verificação de integridade, consulte [Solução de problemas de instâncias não íntegras no Amazon EC2 Auto Scaling](ts-as-healthchecks.md). 

------
#### [ AWS CLI ]

**Para visualizar o motivo das falhas de verificação de integridade ()**  
Use o seguinte comando [describe-scaling-activities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-scaling-activities.html): 

```
aws autoscaling describe-scaling-activities --auto-scaling-group-name my-asg
```

A seguir, um exemplo de resposta, no que `Cause` contém o motivo da falha na verificação de integridade.

```
{
  "Activities": [
    {
      "ActivityId": "4c65e23d-a35a-4e7d-b6e4-2eaa8753dc12",
      "AutoScalingGroupName": "my-asg",
      "Description": "Terminating EC2 instance: i-04925c838b6438f14",
      "Cause": "At 2021-04-01T21:48:35Z an instance was taken out of service in response to a user health-check.",
      "StartTime": "2021-04-01T21:48:35.859Z",
      "EndTime": "2021-04-01T21:49:18Z",
      "StatusCode": "Successful",
      "Progress": 100,
      "Details": "{\"Subnet ID\":\"subnet-5ea0c127\",\"Availability Zone\":\"us-west-2a\"...}",
      "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:283179a2-f3ce-423d-93f6-66bb518232f7:autoScalingGroupName/my-asg"
    },
...
  ]
}
```

Para obter uma descrição dos campos na saída, consulte [Atividade](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_Activity.html) na *Referência da API do Amazon EC2 Auto Scaling*.

Para descrever as atividades de escalabilidade após a exclusão do grupo Auto Scaling, adicione `--include-deleted-groups` a opção ao [describe-scaling-activities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-scaling-activities.html)comando. 

------

# Solução de problemas de instâncias não íntegras no Amazon EC2 Auto Scaling
<a name="ts-as-healthchecks"></a>

A seguir estão mensagens de erro apresentadas pelo Amazon EC2 Auto Scaling, as possíveis causas e as etapas que você pode tomar para resolver o problema.

Para recuperar uma mensagem de erro, consulte [Veja o motivo das falhas na verificação de integridade](replace-unhealthy-instance.md).

**Topics**
+ [Uma instância foi retirada de serviço em resposta a uma falha de verificação de status de instância do EC2](#ts-failed-status-checks)
+ [Uma instância foi retirada de serviço em resposta a uma verificação de integridade do EC2 que indicou que ela tinha sido terminada ou interrompida](#ts-terminated-or-stopped)
+ [Uma instância foi retirada de serviço em resposta a uma falha na verificação de integridade do sistema ELB](#ts-failed-elb-health-checks)
+ [Recursos adicionais do](#troubleshoot-health-checks-additional-resources)

## Uma instância foi retirada de serviço em resposta a uma falha de verificação de status de instância do EC2
<a name="ts-failed-status-checks"></a>

**Problema**: instâncias do Auto Scaling falham nas verificações de status do Amazon EC2. 

**Causa 1**: se houver problemas que fazem com que o Amazon EC2 considere as instâncias do grupo do Auto Scaling prejudicadas, o Amazon EC2 Auto Scaling substituirá automaticamente as instâncias prejudicadas como parte da verificação de integridade. 

**Solução 1:**: Quando uma verificação de status de instância falha, geralmente você precisa lidar com o problema por conta própria fazendo alterações de configuração da instância até que a aplicação não apresente mais problemas. Para resolver esse problema, siga estas etapas:

1. Crie manualmente uma instância do Amazon EC2 que não faça parte do grupo do Auto Scaling e investigue o problema. Para obter ajuda geral na investigação de instâncias comprometidas, consulte [Solução de problemas em instâncias com falha nas verificações de status](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstances.html) no *Guia do usuário do Amazon EC2*.

1. Depois de confirmar que sua instância foi executada com êxito e está íntegra, implante uma nova configuração de instância, livre de erros, no grupo do Auto Scaling.

1. Exclua a instância criada para evitar cobranças contínuas na conta da AWS . 

## Uma instância foi retirada de serviço em resposta a uma verificação de integridade do EC2 que indicou que ela tinha sido terminada ou interrompida
<a name="ts-terminated-or-stopped"></a>

**Problema**: instâncias do Auto Scaling que foram interrompidas, reinicializadas ou terminadas são substituídas. 

**Causa 1**: um usuário interrompeu, reinicializou ou terminou manualmente a instância.

**Solução 1:**: Se precisar interromper ou reinicializar as instâncias no seu grupo do Auto Scaling, recomendamos colocar as instâncias em espera primeiro. Para obter mais informações, consulte [Remover temporiamente instâncias do grupo do Auto Scaling](as-enter-exit-standby.md). 

**Causa 2**: o Amazon EC2 Auto Scaling tenta substituir instâncias spot depois que o serviço spot do Amazon EC2 interrompe as instâncias, porque o preço spot aumenta além do seu preço máximo ou a capacidade não está mais disponível. 

**Solução 2**: não há garantia de que exista uma instância spot para atender à solicitação em qualquer momento específico. No entanto, você pode tentar o seguinte:
+ Use um preço máximo spot mais alto (possivelmente, o preço sob demanda). Ao definir seu preço máximo mais alto, a chance do serviço spot do Amazon EC2 iniciar e manter a quantidade necessária de capacidade é maior.
+ Aumente o número de grupos de capacidade diferentes dos quais você pode iniciar instâncias executando vários tipos de instâncias em várias zonas de disponibilidade. Para obter mais informações, consulte [Grupos do Auto Scaling com vários tipos de instâncias e opções de compra](ec2-auto-scaling-mixed-instances-groups.md).
+ Se você usar vários tipos de instâncias, considere ativar o recurso de rebalanceamento de capacidade. Ele será útil se você quiser que o serviço spot do Amazon EC2 tente iniciar uma nova instância spot antes que uma instância em execução seja encerrada. Para obter mais informações, consulte [Rebalanceamento de capacidade no Auto Scaling para substituir instâncias spot em risco](ec2-auto-scaling-capacity-rebalancing.md).

**Causa 3**: O Amazon EC2 encerrará todas as instâncias que ainda estiverem em execução 30 minutos antes do horário final do bloco de capacidade. Essa terminação abrupta faz com que o seu grupo do Auto Scaling tente iniciar novas instâncias para manter a capacidade desejada, mesmo que o bloco de capacidade esteja terminando. 

**Solução 3**: Para resolver esse problema, tente as seguintes soluções:
+ Diminua a capacidade desejada do grupo do Auto Scaling para evitar que ele tente iniciar novas instâncias. Para obter mais informações, consulte [Escalabilidade manual para o Amazon EC2 Auto Scaling](ec2-auto-scaling-scaling-manually.md).
+ Certifique-se de reduzir a escala horizontalmente em seu grupo do Auto Scaling 30 minutos antes do horário de término do bloco de capacidade para que você não encontre esse erro com frequência. Certifique-se de que os ganchos do ciclo de vida tenham sido concluídos 30 minutos antes do horário de término do bloco de capacidade. Para obter mais informações, consulte [Use Capacity Blocks para workloads de machine learning.](launch-template-capacity-blocks.md).

## Uma instância foi retirada de serviço em resposta a uma falha na verificação de integridade do sistema ELB
<a name="ts-failed-elb-health-checks"></a>

**Problema**: instâncias do Auto Scaling poderiam ser aprovadas nas verificações de status do EC2. Mas elas poderiam falhar nas verificações de saúde do Elastic Load Balancing para os grupos de destino ou Classic Load Balancers com os quais o grupo do Auto Scaling está registrado. 

**Causa 1**: se o seu grupo do Auto Scaling depender de verificações de integridade fornecidas pelo Elastic Load Balancing, o Amazon EC2 Auto Scaling determinará o status da integridade de suas instâncias verificando os resultados tanto das verificações de status do EC2 quanto das verificações de integridade do Elastic Load Balancing. O balanceador de carga executa verificações de integridade enviando uma solicitação para cada instância e aguardando a resposta correta ou estabelecendo uma conexão com a instância. Uma instância pode falhar na verificação de integridade do Elastic Load Balancing porque uma aplicação em execução na instância tem problemas que fazem com que o balanceador de carga a considere fora de serviço. 

**Solução 1**: para passar nas verificações de integridade do Elastic Load Balancing: 
+ Verifique se as configurações da verificação de integridade dos seus grupos de destino estão configuradas corretamente. Você define as configurações de verificação de integridade para seu balanceador de carga por grupo de destino. Para obter mais informações, consulte [Configurar verificações de integridade para destinos](getting-started-elastic-load-balancing.md#elb-health-checks-for-targets).
+ Anote os códigos de sucesso que o balanceador de carga está esperando e verifique se a aplicação está configurada corretamente para retornar esses códigos com sucesso. 
+ Verifique se os grupos de segurança do balanceador de carga e do grupo do Auto Scaling estão configurados corretamente. 
+ Verifique se o balanceador de carga está configurado nas mesmas zonas de disponibilidade do grupo do Auto Scaling. 

**Solução 2**: atualizar o grupo do Auto Scaling para desativar as verificações de integridade do Elastic Load Balancing. Para obter instruções sobre como desativar essas verificações de integridade, consulte [Desvinculação de um grupo de destino ou Classic Load Balancer](https://docs.aws.amazon.com//autoscaling/ec2/userguide/attach-load-balancer-asg.html#as-remove-load-balancer). 

**Causa 2**: há uma incompatibilidade entre o período de carência da verificação de integridade e o tempo de inicialização da instância.

**Solução 3**: Edite o período de carência da verificação de integridade para o grupo do Auto Scaling. Defina o período de carência da verificação de integridade do seu grupo do Auto Scaling como um período suficientemente longo para suportar o número de verificações de integridade consecutivas bem-sucedidas necessárias antes que o Elastic Load Balancing considere uma instância recém-iniciada como íntegra. Para obter mais informações, consulte [Definir um período de carência da verificação de integridade para um grupo do Auto Scaling](health-check-grace-period.md). 

## Recursos adicionais do
<a name="troubleshoot-health-checks-additional-resources"></a>

Se você tiver um problema diferente, consulte os seguintes AWS re:Post artigos para obter ajuda adicional na solução de problemas:
+  [Por que o Amazon EC2 Auto Scaling falhou ao terminar uma instância?](https://repost.aws/knowledge-center/auto-scaling-instance-how-terminated) 
+  [Por que o Amazon EC2 Auto Scaling não encerrou uma instância não íntegra?](https://repost.aws/knowledge-center/auto-scaling-terminate-instance) 