# Monitorar recursos do Amazon EC2 O monitoramento é uma parte importante para manter a confiabilidade, a disponibilidade e a performance das instâncias do Amazon EC2 e das soluções da AWS. É necessário coletar dados de monitoramento de todas as partes de suas soluções da AWS para facilitar a depuração de uma falha de vários pontos (caso ocorra). AWSA fornece várias ferramentas que é possível usar para monitorar o Amazon EC2. Os painéis do console do Amazon EC2 e do CloudWatch fornecem uma visão rápida do estado do ambiente do Amazon EC2. Além disso, fornecemos o seguinte: + **Verificações do status do sistema**: monitore os sistemas da AWS necessários para usar a instância e garantir que eles estejam funcionando corretamente. Essas verificações detectam problemas com sua instância que exigem a participação da AWS para corrigi-los. Quando ocorre uma falha em uma verificação de status do sistema, é possível optar por esperar a AWS corrigir o problema ou resolvê-lo por conta própria (por exemplo, interrompendo e reiniciando ou encerrando e substituindo uma instância). Exemplos de problemas que causam falha nas verificações de status do sistema incluem: + Perda de conectividade de rede + Perda de energia do sistema + Problemas de software no host físico + Problemas de hardware de host físico que afetam a acessibilidade de rede Para obter mais informações, consulte [Verificações do status das instâncias do Amazon EC2](monitoring-system-instance-status-check.md). + **Verificações do status da instância**: monitore o software e a configuração de rede da instância individual. Essas verificações detectam problemas que exigem seu envolvimento para correção. Quando ocorre uma falha em uma verificação de status da instância, normalmente, você precisará resolver o problema por conta própria (por exemplo, reinicializando a instância ou fazendo modificações no sistema operacional). Exemplos de problemas que podem causar falha nas verificações de status da instância incluem: + Verificações de status de sistema com falha + Configuração incorreta do startup ou da rede + Memória exaurida + Sistema de arquivos corrompido + Kernel incompatível Para obter mais informações, consulte [Verificações do status das instâncias do Amazon EC2](monitoring-system-instance-status-check.md). + **Alarmes do Amazon CloudWatch**: observe uma única métrica ao longo de um período que você especificar e realize uma ou mais ações com base no valor da métrica em relação a um determinado limite ao longo de vários períodos. A ação é uma notificação enviada para um tópico do Amazon Simple Notification Service (Amazon SNS) ou por uma política do Amazon EC2 Auto Scaling. Os alertas invocam ações apenas para alterações de estado mantidas. Os alarmes do CloudWatch não invocarão ações simplesmente porque estão em um estado específico. O estado deve ter sido alterado e mantido por um número específico de períodos. Para obter mais informações, consulte [Monitorar instâncias usando o CloudWatch](using-cloudwatch.md). + **Eventos do Amazon EventBridge**: automatize os serviços da AWS e responda automaticamente a eventos do sistema. Os eventos dos produtos da AWS são entregues ao EventBridge em tempo quase real, e é possível especificar ações automáticas a serem executadas quando um evento corresponde a uma regra elaborada por você. Para obter mais informações, consulte [Automatizar o Amazon EC2 usando o EventBridge](automating_with_eventbridge.md). + **Logs do AWS CloudTrail**: capture informações detalhadas sobre as chamadas feitas para a API do Amazon EC2 e armazene-as como arquivos de log no Amazon S3. É possível usar esses logs do CloudTrail para determinar quais chamadas foram feitas, o endereço IP de origem da chamada, quem fez a chamada e quando a chamada foi feita etc. Para obter mais informações, consulte [Registro em log das chamadas de API do Amazon EC2 usando o AWS CloudTrail](monitor-with-cloudtrail.md). + **Agente do CloudWatch**: colete logs e métricas no nível do sistema de hosts e convidados nas instâncias do EC2 e nos servidores on-premises. Para obter mais informações, consulte [Coletar métricas e logs de instâncias do Amazon EC2 e de servidores on-premises com o agente do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) no *Guia do usuário do Amazon CloudWatch*. # Monitorar o status das instâncias do Amazon EC2 É possível monitorar o status de suas instâncias visualizando as verificações de status e os eventos programados para elas. A verificação de status fornece as informações resultantes de verificações automáticas executadas pelo Amazon EC2. Essas verificações automáticas detectam se problemas específicos estão afetando as instâncias. As informações de verificação de status, em conjunto com os dados fornecidos pelo Amazon CloudWatch, oferecem visibilidade operacional detalhada sobre cada uma das instâncias. Também é possível ver o status de eventos específicos programados para suas instâncias. O status de eventos fornece informações sobre as próximas atividades que estão programadas para suas instâncias, como reinicialização ou desativação. Ele também fornece os horários de início e término programados para cada evento. **Topics** + [Verificações do status das instâncias do Amazon EC2](monitoring-system-instance-status-check.md) + [Eventos de alteração de estado para instâncias do Amazon EC2](monitoring-instance-state-changes.md) + [Eventos programados para instâncias do Amazon EC2](monitoring-instances-status-check_sched.md) # Verificações do status das instâncias do Amazon EC2 Com o monitoramento de status de instâncias, por exemplo, é possível determinar rapidamente se o Amazon EC2 detectou problemas que possam impedir que as instâncias executem aplicações. O Amazon EC2 executa verificações automáticas em cada instância do EC2 em execução para identificar problemas de hardware e software. É possível visualizar os resultados dessas verificações de status para identificar problemas específicos e detectáveis. O status do evento expande as informações que o Amazon EC2 já fornece sobre o estado de cada instância (como `pending`, `running`, `stopping`) e as métricas de utilização que o Amazon CloudWatch monitora (utilização de CPU, tráfego de rede e atividade de disco). As verificações de status são realizadas a cada minuto e elas retornam o status de aprovação e reprovação. Se todas as verificações forem aprovadas, o status geral da instância será **OK**. Se uma ou mais verificações falharem, o status geral será **impaired**. As verificações de status são integradas ao Amazon EC2, portanto elas não podem ser desabilitadas ou excluídas. Quando uma verificação de status falha, a métrica do CloudWatch correspondente para as verificações de status é incrementada. Para obter mais informações, consulte [Métricas de verificação de status](viewing_metrics_with_cloudwatch.md#status-check-metrics). É possível usar essas métricas para criar alarmes do CloudWatch que são acionados com base no resultado das verificações de status. Por exemplo, é possível criar um alarme para avisá-lo se as verificações de status falharem em uma instância específica. Para obter mais informações, consulte [Criar alarmes do CloudWatch para instâncias do Amazon EC2 que apresentam falha nas verificações de status](creating_status_check_alarms.md). Também é possível criar um alarme do Amazon CloudWatch que monitore uma instância do Amazon EC2 e recupere automaticamente a instância se ela for danificada devido a um problema subjacente. Para obter mais informações, consulte [Recuperação automática de instâncias](ec2-instance-recover.md). **Topics** + [Tipos de verificações de status](#types-of-instance-status-checks) + [Visualizar verificações do status para instâncias do Amazon EC2](viewing_status.md) + [Criar alarmes do CloudWatch para instâncias do Amazon EC2 que apresentam falha nas verificações de status](creating_status_check_alarms.md) ## Tipos de verificações de status Existem três tipos de verificação de status. + [Verificações de status de sistema](#system-status-checks) + [Verificações de status de instâncias](#instance-status-checks) + [Verificações de status do EBS anexado](#attached-ebs-status-checks) ### Verificações de status de sistema As verificações de status do sistema monitoram os sistemas da AWS nos quais a instância é executada. Essas verificações detectam problemas subjacentes na instância que exigem o envolvimento da AWS para a correção. Quando uma verificação de status do sistema falha, é possível esperar que a AWS corrija o problema ou pode corrigi-lo por conta própria. Para instâncias baseadas no Amazon EBS, é possível interrompê-las e iniciá-las por conta própria, o que, na maioria dos casos, faz com que a instância seja migrada para um novo host. Para instâncias baseadas em armazenamento de instância (com suporte apenas para instâncias Linux), é possível encerrar e substituir a instância. Observe que os volumes de armazenamento de instâncias são efêmeros e todos os dados são perdidos quando a instância é interrompida. A seguir, temos exemplos de problemas que podem causar falha nas verificações de status do sistema: + Perda de conectividade de rede + Perda de energia do sistema + Problemas de software no host físico + Problemas de hardware de host físico que afetam a acessibilidade de rede Se uma verificação de status do sistema falhar, incrementamos a métrica [StatusCheckFailed\$1System](viewing_metrics_with_cloudwatch.md#status-check-metrics). **Instâncias bare metal** Se você executar uma reinicialização do sistema operacional em uma instância bare metal, a verificação de status do sistema poderá retornar temporariamente um status de falha. Quando a instância ficar disponível, a verificação de status do sistema deve retornar um status de aprovação. ### Verificações de status de instâncias As verificações de status da instância monitoram o software e a conectividade de rede da sua instância individual. O Amazon EC2 verifica a integridade da instância enviando uma solicitação de protocolo de resolução de endereço (ARP) para a interface de rede (NIC). Essas verificações detectam problemas que exigem seu envolvimento para correção. Quando uma verificação de status de instância falha, geralmente você precisa lidar com o problema por conta própria (por exemplo, reinicializando a instância ou fazendo alterações de configuração da instância). **nota** As distribuições recentes do Linux que usam `systemd-networkd` para a configuração de rede podem relatar verificações de integridade de maneira diferente das distribuições anteriores. Durante o processo de inicialização, esse tipo de rede pode começar mais cedo e possivelmente terminar antes de outras tarefas de inicialização que também podem afetar a integridade da instância. As verificações de status que dependem da disponibilidade da rede podem relatar um status íntegro antes da conclusão de outras tarefas. A seguir, temos exemplos de problemas que podem causar falhas nas verificações de status da instância: + Verificações de status de sistema com falha + Configuração incorreta de redes ou startup + Memória exaurida + Sistema de arquivos corrompido + Kernel incompatível + Durante uma reinicialização, uma verificação de status da instância relatará uma falha até que a instância fique disponível novamente. Se uma verificação de status da instância falhar, incrementamos a métrica [StatusCheckFailed\$1Instance](viewing_metrics_with_cloudwatch.md#status-check-metrics). **Instâncias bare metal** Se você executar uma reinicialização do sistema operacional em uma instância bare metal, a verificação de status da instância poderá retornar temporariamente um status de falha. Quando a instância ficar disponível, a verificação de status dela deve retornar um status de aprovação. ### Verificações de status do EBS anexado As verificações de status do EBS anexado monitoram se os volumes do Amazon EBS anexados a uma instância estão acessíveis e são capazes de concluir operações de E/S. A métrica `StatusCheckFailed_AttachedEBS` é um valor binário que indica deficiência caso um ou mais dos volumes do EBS anexados à instância não sejam capazes de concluir operações de E/S. Essas verificações de status detectam problemas subjacentes com a computação ou a infraestrutura do Amazon EBS. Se ocorrer uma falha na métrica de verificação de status do EBS anexado, você pode esperar a AWS resolver o problema ou tomar medidas, como substituir os volumes afetados ou interromper e reiniciar a instância. Veja abaixo alguns exemplos de problemas que podem causar falha nas verificações de status do EBS anexado: + Problemas de hardware ou software nos subsistemas de armazenamento subjacentes aos volumes do EBS + Problemas de hardware no host físico que afetam a acessibilidade dos volumes do EBS + Problemas de conectividade entre a instância e os volumes do EBS É possível usar a métrica `StatusCheckFailed_AttachedEBS` para ajudar a melhorar a resiliência da sua workload. É possível usar essa métrica para criar alarmes do Amazon CloudWatch que são acionados com base no resultado das verificações de status. Por exemplo, você pode fazer o failover para uma instância secundária ou zona de disponibilidade ao detectar um impacto prolongado. Também é possível monitorar a performance de E/S de cada volume anexado usando as métricas do EBS CloudWatch para detectar e substituir o volume danificado. Se a sua workload não estiver conduzindo E/S para nenhum volume do EBS anexado à sua instância, e a verificação de status do EBS indicar uma deficiência, você poderá interromper e iniciar a instância para movê-la para um novo host. Isso pode solucionar problemas subjacentes do host que estejam afetando a acessibilidade dos volumes do EBS. Para obter mais informações, consulte [Métricas de uso do Amazon CloudWatch para o Amazon EBS](https://docs.aws.amazon.com/ebs/latest/userguide/using_cloudwatch_ebs.html). Você também pode configurar seus grupos do Amazon EC2 Auto Scaling para detectar falhas de verificação de status do EBS anexado e, em seguida, substituir a instância afetada por uma nova. Para obter mais informações, consulte [Monitor and replace Auto Scaling instances with impaired Amazon EBS volumes](https://docs.aws.amazon.com/autoscaling/ec2/userguide/monitor-and-replace-instances-with-impaired-ebs-volumes.html) no *Guia do usuário do Amazon EC2 Auto Scaling*. **nota** A métrica de verificação de status do EBS anexado está disponível somente para instâncias do Nitro. # Visualizar verificações do status para instâncias do Amazon EC2 Se a verificação de status da instância falhar, você normalmente precisará lidar com o problema por conta própria (por exemplo, reinicializando a instância ou fazendo alterações de configuração da instância). Para resolver falhas de verificação de status de instância ou sistema, consulte [Solucionar problemas de instâncias do Linux do Amazon EC2 com falhas nas verificações de status](TroubleshootingInstances.md). ------ #### [ Console ] **Para visualizar verificações de status** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Na página **Instances (Instâncias)**, a coluna **Status check (Verificações de status)** lista o status operacional de cada instância. 1. Para visualizar o status de uma instância específica, selecione a instância e escolha a guia **Status e alarmes**. 1. Para revisar as métricas do CloudWatch para verificações de status, na guia **Status e alarmes**, expanda **Métricas** e veja os gráficos das seguintes métricas: + **Falha na verificação de status do sistema** + **Falha na verificação de status da instância** + **Falha na verificação de status do EBS anexado** Para obter mais informações, consulte [Métricas de verificação de status](viewing_metrics_with_cloudwatch.md#status-check-metrics). ------ #### [ AWS CLI ] **Para visualizar verificações de status** Use o comando [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html). **Exemplo**: obter o status de todas as instâncias em execução ``` aws ec2 describe-instance-status ``` **Exemplo**: obter o status de todas as instâncias ``` aws ec2 describe-instance-status --include-all-instances ``` **Exemplo**: obter o status de uma única instância em execução ``` aws ec2 describe-instance-status --instance-ids i-1234567890abcdef0 ``` **Exemplo**: obter todas as instâncias com um status de `impaired` ``` aws ec2 describe-instance-status \ --filters Name=instance-status.status,Values=impaired ``` ------ #### [ PowerShell ] **Para visualizar verificações de status** Use o comando [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html). **Exemplo**: obter o status de todas as instâncias em execução ``` Get-EC2InstanceStatus ``` **Exemplo**: obter o status de todas as instâncias ``` Get-EC2InstanceStatus -IncludeAllInstance $true ``` **Exemplo**: obter o status de uma única instância em execução ``` Get-EC2InstanceStatus -InstanceId i-1234567890abcdef0 ``` **Exemplo**: obter todas as instâncias com um status de `impaired` ``` Get-EC2InstanceStatus \ -Filter @{Name="instance-status.status"; Values="impaired"} ``` ------ # Criar alarmes do CloudWatch para instâncias do Amazon EC2 que apresentam falha nas verificações de status É possível usar as [métricas de verificação de status](viewing_metrics_with_cloudwatch.md#status-check-metrics) para criar alarmes do CloudWatch a fim de notificar você quando uma instância apresentou falha na verificação de status. As verificações de status e os alarmes de verificação de status podem entrar temporariamente em um estado de *dados insuficiente* se faltarem pontos de dados métricos. Embora raro, isso pode acontecer quando há uma interrupção nos sistemas de relatórios de métricas, mesmo quando uma instância está íntegra. Recomendamos que esse estado seja tratado como dados ausentes em vez de uma falha na verificação de status ou violação de alarme. Isso é especialmente importante ao executar ações de interrupção, encerramento, reinicialização ou recuperação na instância como resposta. ------ #### [ Console ] Este exemplo configura um alarme que envia uma notificação quando uma instância falha em uma verificação de status. Opcionalmente, você pode parar, encerrar ou recuperar a instância. **Para criar um alarme de verificação de status (console)** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione a instância, escolha a guia **Status Checks (Verificações de status)** e selecione **Actions (Ações)**, **Create status check alarm (Criar alarme de verificação de status)**. 1. Na página **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**, em **Add or edit alarm (Adicionar ou editar alarme)**, selecione **Create an alarm (Criar um alarme)**. 1. Em **Alarm notification (Notificação de alarme)**, ative a opção para configurar notificações do Amazon Simple Notification Service (Amazon SNS). Selecione um tópico existente do Amazon SNS ou insira um nome para criar um tópico. Se você adicionar um endereço de e-mail à lista de destinatários ou criar um novo tópico, o Amazon SNS enviará um e-mail de confirmação para cada novo endereço. Cada destinatário deve escolher o link de confirmação no e-mail. Somente endereços confirmados recebem notificações de alerta. 1. Em **Alarm action (Ação de alarme)**, ative a opção para especificar uma ação a ser executada quando o alarme for acionado. Selecione a ação. 1. Em **Alarm thresholds (Limites de alarme)**, especifique a métrica e os critérios do alarme. Você pode optar por manter os valores padrão para **Agrupar exemplos por** (**Média**) e **Tipo de dados a serem amostrados** (**Falha na verificação de status: qualquer**), ou modificá-los conforme necessário. Para **Consecutive Period (Período consecutivo)**, defina o número de períodos que deseja avaliar e, em **Period (Período)**, insira a duração do período de avaliação antes de acionar o alarme e enviar um e-mail. 1. (Opcional) Em **Sample metric data (Dados de métrica de exemplo)**, escolha **Add to dashboard (Adicionar ao painel)**. 1. Escolha **Criar**. Se precisar alterar um alarme de status de instância, você poderá editá-lo. **Para editar um alarme de verificação de status** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione a instância e escolha **Actions (Ações)**, **Monitoring (Monitoramento)**, **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**. 1. Na página **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**, em **Add or edit alarm (Adicionar ou editar alarme)**, escolha **Edit an alarm (Editar um alarme)**. 1. Em **Search for alarm (Procurar alarme)**, escolha o alarme. 1. Quando terminar de fazer alterações, escolha **Update (Atualizar)**. ------ #### [ AWS CLI ] No exemplo a seguir, o alarme publica uma notificação para um tópico de SN, quando há falha da instância na verificação de instância ou na verificação de status de sistema por, pelo menos, dois períodos consecutivos. A métrica do CloudWatch usada é `StatusCheckFailed`. **Para criar um alarme de verificação de status (console)** 1. Selecione um tópico de SNS existente ou crie um novo. Para obter mais informações, consulte [Acesso ao Amazon SNS na AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-sns.html) no *Guia do usuário do AWS Command Line Interface*. 1. Use o seguinte comando [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) para visualizar as métricas do Amazon CloudWatch disponíveis para o Amazon EC2. ``` aws cloudwatch list-metrics --namespace AWS/EC2 ``` 1. Use o seguinte comando [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html) para criar o alarme. ``` aws cloudwatch put-metric-alarm \ --alarm-name StatusCheckFailed-Alarm-for-i-1234567890abcdef0 \ --metric-name StatusCheckFailed \ --namespace AWS/EC2 \ --statistic Maximum \ --dimensions Name=InstanceId,Value=i-1234567890abcdef0 \ --unit Count \ --period 300 \ --evaluation-periods 2 \ --threshold 1 \ --comparison-operator GreaterThanOrEqualToThreshold \ --alarm-actions arn:aws:sns:us-west-2:111122223333:my-sns-topic ``` O período é o intervalo de tempo, em segundos, no qual as métricas do Amazon CloudWatch são coletadas. Este exemplo usa 300, que são 60 segundos multiplicados por 5 minutos. O período de avaliação é o número de períodos consecutivos pelos quais o valor da métrica deve ser comparado ao limite. Este exemplo usa 2. As ações do alarme são as ações a serem executadas quando esse alarme é acionado. ------ #### [ PowerShell ] **Para criar um alarme de verificação de status (console)** Use o cmdlet [Write-CWMetricAlarm](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-CWMetricAlarm.html) conforme mostrado a seguir para publicar notificações em um tópico do SNS quando a instância falhar nas verificações de status por pelo menos dois períodos consecutivos. ``` Write-CWMetricAlarm ` -AlarmName "StatusCheckFailed-Alarm-for-i-1234567890abcdef0" ` -MetricName "StatusCheckFailed" ` -Namespace "AWS/EC2" ` -Statistic "Maximum" ` -Dimension @{Name="InstanceId"; Values="i-1234567890abcdef0"} ` -Unit "Count" ` -Period 300 ` -EvaluationPeriod 2 ` -Threshold 1 ` -ComparisonOperator "GreaterThanOrEqualToThreshold" ` -AlarmAction "arn:aws:sns:us-west-2:111122223333:my-sns-topic" ``` O período é o intervalo de tempo, em segundos, no qual as métricas do Amazon CloudWatch são coletadas. Este exemplo usa 300, que são 60 segundos multiplicados por 5 minutos. O período de avaliação é o número de períodos consecutivos pelos quais o valor da métrica deve ser comparado ao limite. Este exemplo usa 2. As ações do alarme são as ações a serem executadas quando esse alarme é acionado. ------ # Eventos de alteração de estado para instâncias do Amazon EC2 O Amazon EC2 envia um evento `EC2 Instance State-change Notification` ao Amazon EventBridge quando o estado de uma instância é alterado. A seguir estão dados de exemplo para esse evento. Neste exemplo, a instância inseriu o estado `pending`. ``` { "id":"7bf73129-1428-4cd3-a780-95db273d1602", "detail-type":"EC2 Instance State-change Notification", "source":"aws.ec2", "account":"123456789012", "time":"2021-11-11T21:29:54Z", "region":"us-east-1", "resources":[ "arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0" ], "detail":{ "instance-id":"i-1234567890abcdef0", "state":"pending" } } ``` Os possíveis valores para `state` são: + `pending` + `running` + `stopping` + `stopped` + `shutting-down` + `terminated` Quando você executa ou inicia uma instância, ela entra no estado `pending` e depois no estado `running`. Quando você interrompe uma instância, ela entra no estado `stopping` e depois no estado `stopped`. Quando você termina uma instância, ela entra no estado `shutting-down` e depois no estado `terminated`. Para obter mais informações, consulte [Alterações do estado de instâncias do Amazon EC2](ec2-instance-lifecycle.md). # Criar um alarme que envie um e-mail quando uma instância do Amazon EC2 muda de estado Para receber notificações por e-mail quando o estado de sua instância for alterado, crie um tópico do Amazon SNS e crie uma regra do EventBridge para o evento `EC2 Instance State-change Notification`. **Para criar um tópico do SNS** 1. Abra o console do Amazon SNS em [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home). 1. No painel de navegação, escolha **Tópicos**. 1. Escolha **Criar tópico**. 1. Em **Tipo**, escolha **Padrão**. 1. Em **Name** (Nome), digite um nome para o tópico. 1. Escolha **Criar tópico**. 1. Selecione **Criar assinatura**. 1. Em **Protocolo**, escolha **E-mail**. 1. Em **Endpoint**, insira o endereço de e-mail que receberá as notificações. 1. Selecione **Criar assinatura**. 1. Você receberá uma mensagem de e-mail com esta linha de assunto: AWS Notification - Subscription Confirmation. Siga as instruções para confirmar sua assinatura. **Para criar uma regra de EventBridge** 1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Selecione **Criar regra**. 1. Em **Name** (Nome), insira um nome para a regra. 1. Em **Rule type**, escolha **Rule with an event pattern**. 1. Escolha **Próximo**. 1. Em **Event pattern** (Padrão de evento), faça o seguinte: 1. Para **Origem do evento**, escolha **Serviços da AWS**. 1. Em **AWS service (Serviço da AWS)**, escolha **EC2**. 1. Para **Event Type (Tipo de evento)**, escolha **EC2 Instance State-change Notification (Notificação de alteração de estado da instância do EC2)**. 1. Por padrão, enviamos notificações para qualquer alteração de estado de qualquer instância. Se você preferir, é possível selecionar estados específicos ou instâncias específicas. 1. Escolha **Próximo**. 1. Especifique um destino desta forma: 1. Em **Target types** (Tipos de destino), escolha **AWS service (Serviço da AWS)**. 1. Em **Select a target** (Selecionar um destino), escolha **SNS topic** (Tópico do SNS). 1. Em **Topic** (Tópico), selecione o tópico do SNS que você criou no procedimento anterior. 1. Escolha **Próximo**. 1. (Opcional) Adicione etiquetas à regra. 1. Escolha **Próximo**. 1. Selecione **Criar regra**. 1. Para testar a regra, inicie uma alteração de estado. Por exemplo, inicie uma instância interrompida, interrompa uma instância em execução ou inicie uma instância. Você receberá mensagens de e-mail com esta linha de assunto: AWS Notification Message. O corpo do e-mail contém os dados do evento. # Eventos programados para instâncias do Amazon EC2 Para garantir a confiabilidade e o desempenho da infraestrutura, o AWS pode programar eventos para reinicializar, interromper e retirar suas instâncias. Esses eventos não ocorrem com frequência. Se uma de suas instâncias for afetada por um evento programado, o AWS notificará você com antecedência por e-mail usando o endereço de e-mail associado à sua conta AWS. O e-mail fornece detalhes sobre o evento, como as datas de início e término. Dependendo do tipo de evento, é possível tomar providências para controlar sua duração. A AWS também envia um evento do AWS Health, que é possível monitorar e gerenciar usando o Amazon EventBridge. Para obter mais informações, consulte [Monitoramento de eventos no AWS Health com o Amazon EventBridge](https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html). Eventos programados são gerenciados por AWS. Não é possível agendar eventos para suas instâncias. No entanto, você pode: + Visualizar eventos programados para suas instâncias. + Personalize as notificações de eventos programados para incluir ou remover etiquetas da notificação por e-mail. + Reagendar determinados eventos programados. + Criar janelas de eventos personalizadas para eventos programados. + Tomar medidas quando uma instância estiver programada para reinicializar, interromper ou ser retirada. Para garantir que você receba notificações de eventos programados, verifique suas informações de contato na página [Conta](https://console.aws.amazon.com/billing/home?#/account). **nota** Quando uma instância for afetada por um evento agendado e fizer parte de um grupo do Auto Scaling, o Amazon EC2 Auto Scaling futuramente a substituirá como parte de suas verificações de integridade, e você não precisará realizar nenhuma outra ação. Para obter mais informações sobre as verificações de integridade realizadas pelo Amazon EC2 Auto Scaling, consulte [Health checks for instances in an Auto Scaling group](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-health-checks.html) no *Guia do usuário do Amazon EC2 Auto Scaling*. ## Tipos de eventos programados O Amazon EC2 pode criar os seguintes tipos de eventos programados para suas instâncias, onde o evento ocorre em um horário programado: | Tipo de evento | Código do evento | Ação de evento | | --- | --- | --- | | Interrupção da instância | instance-stop | Na hora programada, a instância é interrompida. Quando você iniciá-la novamente, ela será migrada para um novo host. Aplicável somente a instâncias com um volume raiz do Amazon EBS. | | Desativação da instância | instance-retirement | Na hora programada, a instância é interrompida se tiver um volume raiz do Amazon EBS ou encerrada se tiver um volume raiz do armazenamento de instância. | | Reinicialização da instância | instance-reboot | Na hora programada, a instância é reinicializada. A instância permanece no host e, durante a reinicialização, o host passa por uma manutenção. Isso é conhecido como reinicialização no local. | | Reinicialização do sistema | system-reboot | Na hora programada, a instância é reinicializada e migrada para um novo host. Isso é conhecido como migração com reinicialização. | | Manutenção do sistema | system-maintenance | Na hora programada, a instância pode ser temporariamente afetada pela manutenção de rede ou pela manutenção de energia. | ## Determinar o tipo de evento É possível verificar que tipo de evento está programado para a sua instância. ------ #### [ Console ] **Para determinar o tipo de evento** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Na tabela, o código de evento aparece na coluna **Tipo de evento**. 1. Para filtrar a tabela de forma a mostrar somente os eventos de instâncias, no campo de pesquisa, escolha **Tipo de recurso: instância** na lista de filtros. ------ #### [ AWS CLI ] **Para determinar o tipo de evento para uma instância** Use o comando [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html). Se a instância tiver um evento programado associado, a saída fornecerá informações sobre ele. ``` aws ec2 describe-instance-status \ --instance-id i-1234567890abcdef0 \ --query InstanceStatuses[].Events ``` O seguinte é um exemplo de saída. O código do evento programado é `system-reboot`. ``` [ "Events": [ { "InstanceEventId": "instance-event-0d59937288b749b32", "Code": "system-reboot", "Description": "The instance is scheduled for a reboot", "NotAfter": "2020-03-14T22:00:00.000Z", "NotBefore": "2020-03-14T20:00:00.000Z", "NotBeforeDeadline": "2020-04-05T11:00:00.000Z" } ] ] ``` ------ #### [ PowerShell ] **Para determinar o tipo de evento para uma instância** Use o cmdlet [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html). Se a instância tiver um evento programado associado, a saída fornecerá informações sobre ele. ``` (Get-EC2InstanceStatus ` -InstanceId i-1234567890abcdef0).Events ``` O seguinte é um exemplo de saída. O código do evento programado é `system-reboot`. ``` Code : system-reboot Description : The instance is scheduled for a reboot InstanceEventId : instance-event-0d59937288b749b32 NotAfter : 2020-03-14T22:00:00.000Z NotBefore : 2020-03-14T20:00:00.000Z NotBeforeDeadline : 2020-04-05T11:00:00.000Z ``` ------ **Topics** + [Tipos de eventos programados](#types-of-scheduled-events) + [Determinar o tipo de evento](#scheduled-event-type) + [Gerenciamento das instâncias do Amazon EC2 agendadas para interrupção ou desativação](schedevents_actions_retire.md) + [Gerenciamento das instâncias do Amazon EC2 agendadas para reinicialização](schedevents_actions_reboot.md) + [Gerenciamento das instâncias do Amazon EC2 agendadas para manutenção](schedevents_actions_maintenance.md) + [Visualizar eventos programados que afetam as instâncias do Amazon EC2](viewing_scheduled_events.md) + [Personalizar notificações de eventos programados para suas instâncias do EC2](customizing_scheduled_event_notifications.md) + [Reagendar um evento programado para uma instância do EC2](reschedule-event.md) + [Criar janelas de eventos personalizadas para eventos programados que afetam as instâncias do Amazon EC2](event-windows.md) # Gerenciamento das instâncias do Amazon EC2 agendadas para interrupção ou desativação Quando a AWS detecta falha irreparável do host subjacente para sua instância, ela programa a instância para ser interrompida ou encerrada, dependendo do tipo de dispositivo raiz da instância. + Se a instância tiver um volume raiz do Amazon EBS, a instância será programada para parar. + Se a instância tiver um volume raiz de armazenamento de instância, ela será programada para ser encerrada. Para obter mais informações, consulte [Desativação da instância](instance-retirement.md). **Importante** Todos os dados armazenados nos volumes de armazenamento de instâncias serão perdidos quando a instância for interrompida, hibernada ou encerrada. Isso inclui volumes de armazenamento de instância que estão anexados a uma instância com volume raiz do EBS. Lembre-se de salvar os dados dos volumes do armazenamento de instâncias que poderão ser necessários mais tarde antes que a instância seja interrompida, hibernada ou encerrada. ## Ações que você pode realizar **Ações que podem ser realizadas em instâncias com um volume raiz do EBS** Ao receber uma notificação de evento `instance-stop` programada, você pode realizar uma destas seguintes: + **Aguardar a interrupção programada:** você pode esperar que a instância seja interrompida dentro da janela de manutenção programada. + **Executar a interrupção e inicialização manuais:** você pode interromper e iniciar a instância por conta própria no momento que mais lhe convier, o que a migrará para um novo host. Isso não equivale a reiniciar a instância. Para obter mais informações, consulte [Início e interrupção de instâncias do Amazon EC2](Stop_Start.md). + **Automatizar a interrupção e o início:** você pode automatizar uma interrupção e um início imediatos em resposta a um evento `instance-stop` programado. Para obter mais informações, consulte [Como executar automaticamente operações em instâncias do EC2 em resposta a eventos no AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) no *Guia do usuário do AWS Health*. **Ações que você pode realizar para instâncias com um volume raiz do armazenamento de instâncias** Quando você recebe uma notificação de evento `system-retirement` programado e deseja manter seus dados, pode executar as seguintes ações: 1. Lance uma instância de substituição a partir da sua AMI mais recente. 1. Migrar todos os dados necessários para a instância de substituição antes que a instância seja programada para encerramento. 1. Encerrar a instância original ou esperar que ela seja encerrada conforme programado. Para obter mais informações sobre as ações que você pode realizar, consulte [Desativação da instância](instance-retirement.md). # Gerenciamento das instâncias do Amazon EC2 agendadas para reinicialização Quando a AWS precisar executar tarefas, como a instalação de atualizações ou a manutenção do host subjacente, ela pode programar uma reinicialização da instância. Durante essa reinicialização programada, a instância permanece no mesmo host ou migra para um diferente, dependendo do evento, da seguinte maneira: + `instance-reboot`Evento + Durante a reinicialização, a instância permanece no host. Isso é conhecido como *reinicialização no local*. + O host atual está passando por manutenção. + Normalmente, isso é concluído em segundos. + `system-reboot`Evento + Durante a reinicialização, a instância é migrada para um novo host. Isso é conhecido como *migração com reinicialização*. + Normalmente, isso é concluído em minutos. Para verificar que tipo de evento está programado para a sua instância, consulte [Determinar o tipo de evento](monitoring-instances-status-check_sched.md#scheduled-event-type). ## Ações que você pode realizar Ao receber uma notificação de evento `instance-reboot` ou `system-reboot` programado, você pode realizar uma destas ações: + **Aguardar a reinicialização programada**: você pode esperar que a reinicialização da instância ocorra dentro da janela de manutenção programada. + **Reprogramar a reinicialização:** você pode [reprogramar](reschedule-event.md) a reinicialização da instância para uma data e um horário que forem mais convenientes para você. + **Executar uma reinicialização iniciada pelo usuário:** é possível [reinicializar](ec2-instance-reboot.md) manualmente a instância em um momento conveniente para você. No entanto, o resultado depende do evento: + Evento `instance-reboot`: sua instância permanece no hardware atual (reinicialização no local), nenhuma manutenção do host ocorre e o evento permanece aberto. + `system-reboot`Evento + Se a migração com reinicialização estiver habilitada em sua instância, uma reinicialização iniciada pelo usuário tentará migrar sua instância para um novo hardware. Em caso de êxito, o evento será removido. Caso contrário, uma reinicialização local ocorrerá e o evento permanecerá na programação. + Se a migração com reinicialização estiver desabilitada em sua instância, uma reinicialização iniciada pelo usuário manterá a instância no mesmo hardware (reinicialização local), nenhuma manutenção do host ocorrerá e o evento permanecerá na programação. Quando o evento programado finalmente ocorrer, a AWS moverá sua instância para um novo hardware (migração com reinicialização). **Depois que a AWS reinicializar sua instância** O seguinte é aplicável depois que a AWS reinicializa sua instância: + O evento programado é removido. + A descrição do evento é atualizada. + Para um evento `instance-reboot`: + A manutenção do host subjacente está concluída. + Para um evento `system-reboot`: + A instância é movida para um novo host. + A instância mantém seu endereço IP e nome DNS. + Todos os dados em volumes de armazenamento de instância local são preservados. + Você pode usar sua instância depois que ela é totalmente inicializada. **Opções alternativas** Se não conseguir reprogramar o evento de reinicialização ou habilitar a migração com reinicialização para uma reinicialização iniciada pelo usuário, mas quiser manter a operação normal durante a janela de manutenção programada, você poderá fazer o seguinte: + **Para uma instância com um volume raiz do EBS** + Você pode interromper e iniciar a instância, o que a migra para um novo host. Isso não é o mesmo que reinicializar manualmente a instância, caso em que ela permanece no mesmo host. + Opcionalmente, automatize a parada e o início imediatos da instância em resposta ao evento de reinicialização programado. Para obter mais informações, consulte [Como executar automaticamente operações em instâncias do EC2 em resposta a eventos no AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) no *Guia do usuário do AWS Health*. **Importante** Os dados nos volumes de armazenamento da instância são perdidos quando uma instância é interrompida. Para obter mais informações, consulte [Início e interrupção de instâncias do Amazon EC2](Stop_Start.md). + **Para uma instância com um volume raiz de armazenamento de instância** 1. Lance uma instância de substituição a partir da sua AMI mais recente. 1. Migre todos os dados necessários para a instância substituta antes da janela de manutenção programada. 1. Encerre a instância original. ## Habilitar ou desabilitar a migração com reinicialização Quando uma instância está programada para um evento `system-reboot`, é possível reiniciá-la antes do evento. O resultado de uma reinicialização iniciada pelo usuário depende da configuração da migração com reinicialização da instância: + Habilitada: uma reinicialização iniciada pelo usuário tenta migrar sua instância para um novo hardware (migração com reinicialização). Em caso de êxito, o evento será removido. Caso contrário, uma reinicialização local ocorrerá e o evento permanecerá na programação. Observe que, mesmo quando ativada, a migração com reinicialização só poderá ocorrer se sua instância atender aos requisitos de [migração com reinicialização](#requirements-for-reboot-migration). + Desabilitada: uma reinicialização iniciada pelo usuário mantém a instância no mesmo hardware (reinicialização local), nenhuma manutenção do host ocorre e o evento permanece na programação. Quando o evento programado finalmente ocorrer, a AWS moverá sua instância para um novo hardware (migração com reinicialização). A reinicialização com migração demora mais do que uma reinicialização local: + Reinicialização local: aproximadamente 30 segundos + Reinicialização com migração: vários minutos **nota** Por padrão, as instâncias que recebem uma notificação de evento `system-reboot` são habilitadas para migração com reinicialização iniciada pelo usuário. ### Requisitos para habilitar a migração com reinicialização A migração com reinicialização pode ser habilitada em instâncias que atendem aos seguintes critérios: **Tipos de instância** Nem todos os tipos de instância oferecem suporte à habilitação da migração com reinicialização. É possível visualizar os tipos de instância que oferecem suporte à habilitação da migração com reinicialização. **Para visualizar os tipos de instância que oferecem suporte à habilitação da migração com reinicialização** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação à esquerda, escolha **Instances** (Instâncias). 1. Na barra de filtros, insira **Suporte à migração com reinicialização: com suporte**. À medida que você insere os caracteres e o nome do filtro aparece, é possível selecioná-lo. A tabela **Tipos de instâncias** exibe todos os tipos de instância que oferecem suporte à habilitação da migração com reinicialização. **Para visualizar os tipos de instância que oferecem suporte à habilitação da migração com reinicialização** Use o comando [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) com o filtro `reboot-migration-support`. ``` aws ec2 describe-instance-types \ --filters Name=reboot-migration-support,Values=supported \ --query "InstanceTypes[*].[InstanceType]" \ --output text | sort ``` **Para visualizar os tipos de instância que oferecem suporte à habilitação da migração com reinicialização** Use o cmdlet [Get-EC2InstanceType](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceType.html) com o filtro `reboot-migration-support`. ``` Get-EC2InstanceType ` -Filter @{Name="reboot-migration-support";Values="true"} | ` Select InstanceType | Sort-Object InstanceType ``` **Locação** + Compartilhada + Instância Dedicada Para obter mais informações, consulte [Instâncias dedicadas do Amazon EC2](dedicated-instance.md). **Limitações** **Não** há suporte à migração com reinicialização em instâncias com as seguintes características: + Plataforma: instâncias em execução nativa no hipervisor Xen + Tamanho da instância: `metal` instâncias + Locação: host dedicado. Para hosts dedicados, use a [recuperação automática de host dedicado](dedicated-hosts-recovery.md) em vez disso. + Armazenamento: instâncias com volumes de armazenamento de instância + Rede: instâncias usando um adaptador de malha elástica + Ajuste de escala automático: instâncias que fazem parte de um grupo do Auto Scaling ### Etapas para habilitar ou desabilitar a migração com reinicialização Quando uma instância recebe um evento `system-reboot`, ela é habilitada para a migração com reinicialização por padrão. É possível desabilitar a migração com reinicialização para que, durante uma reinicialização iniciada pelo usuário, a instância permaneça no mesmo hardware (reinicialização no local). A configuração `default` não habilita a migração com reinicialização para uma instância sem suporte. Para obter mais informações, consulte [Requisitos para habilitar a migração com reinicialização](#requirements-for-reboot-migration). É possível desabilitar ou habilitar a migração com reinicialização em uma instância em execução ou parada. ------ #### [ AWS CLI ] **Para desabilitar a migração com reinicialização** Use o comando [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html) e defina o parâmetro `--reboot-migration` como `disabled`. ``` aws ec2 modify-instance-maintenance-options \
 --instance-id i-0abcdef1234567890 \
 --reboot-migration disabled ``` **Para habilitar a migração com reinicialização** Use o comando [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html) e defina o parâmetro `--reboot-migration` como `default`. ``` aws ec2 modify-instance-maintenance-options \
 --instance-id i-0abcdef1234567890 \
 --reboot-migration default ``` ------ #### [ PowerShell ] **Para desabilitar a migração com reinicialização** Use o cmdlet [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html). ``` Edit-EC2InstanceMaintenanceOption ` -InstanceId ` -RebootMigration Disabled ``` **Para habilitar a migração com reinicialização** Use o cmdlet [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html). ``` Edit-EC2InstanceMaintenanceOption ` -InstanceId i-1234567890abcdef0 ` -RebootMigration Enabled ``` ------ # Gerenciamento das instâncias do Amazon EC2 agendadas para manutenção Quando a AWS precisa manter o host subjacente de uma instância, ela programa a instância para manutenção. Há dois tipos de eventos de manutenção: manutenção de rede e manutenção de energia. + Durante a manutenção de rede, instâncias programadas perdem a conectividade de rede durante um breve período. A conectividade de rede normal com a instância é restaurada depois que a manutenção for concluída. + Durante a manutenção de energia, as instâncias programadas ficam offline durante um breve período e depois são reinicializadas. Quando uma reinicialização é realizada, todas as definições de configuração da instância são mantidas. Depois que sua instância tiver sido reinicializada (isso geralmente leva alguns minutos), verifique se a aplicação está funcionando conforme o esperado. Nesse ponto, a instância não deve mais ter um evento associado a ela ou, se tiver, a descrição do evento programado começará com **[Completed]**. Às vezes, leva até 1 hora para que a descrição do status da instância seja atualizada. Eventos de manutenção concluídos são exibidos no painel do console do Amazon EC2 por até uma semana. ## Ações que você pode realizar **Ações que podem ser realizadas em instâncias com um volume raiz do EBS** Ao receber uma notificação de evento `system-maintenance`, você pode realizar uma destas ações: + **Aguardar a manutenção programada:** você pode esperar que a manutenção ocorra conforme programado. + **Executar a interrupção e o início manuais:** você pode parar e iniciar a instância, o que a migra para um novo host. Isso não equivale a reiniciar a instância. Para obter mais informações, consulte [Início e interrupção de instâncias do Amazon EC2](Stop_Start.md). + **Automatizar a interrupção e o início**: você pode automatizar uma interrupção e um início imediatos em resposta a um evento de manutenção programado. Para obter mais informações, consulte [Como executar automaticamente operações em instâncias do EC2 em resposta a eventos no AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) no *Guia do usuário do AWS Health*. **Ações que você pode realizar para instâncias com um volume raiz do armazenamento de instâncias** Ao receber uma notificação de evento `system-maintenance`, você pode realizar uma destas ações: + **Aguardar a manutenção programada:** você pode esperar que a manutenção ocorra conforme programado. + **Lançar uma instância de substituição:** se quiser manter a operação normal durante a janela de manutenção programada: 1. Lance uma instância de substituição a partir da sua AMI mais recente. 1. Migre todos os dados necessários para a instância substituta antes da janela de manutenção programada. 1. Encerre a instância original. # Visualizar eventos programados que afetam as instâncias do Amazon EC2 Além de receber a notificação de eventos programados por e-mail, você pode verificar se há eventos programados. ------ #### [ Console ] **Para visualizar eventos programados para suas instâncias** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. O painel exibe quaisquer recursos com um evento associado em **Eventos agendados**. ![\[Visualização de eventos usando o painel.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/dashboard-scheduled-events.png) 1. Para obter mais detalhes, escolha **Eventos** no painel de navegação. Todos os recursos com um evento associado serão exibidos. É possível filtrar por características como tipo de evento, tipo de recurso e zona de disponibilidade. ![\[Visualização de eventos usando a página de eventos.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/events-instance-scheduled-stop.png) ------ #### [ AWS CLI ] **Para visualizar eventos programados para suas instâncias** Use o comando [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html). ``` aws ec2 describe-instance-status \ --instance-id i-1234567890abcdef0 \ --query "InstanceStatuses[].Events" ``` O exemplo de saída a seguir mostra um evento de reinicialização. ``` [ "Events": [ { "InstanceEventId": "instance-event-0d59937288b749b32", "Code": "system-reboot", "Description": "The instance is scheduled for a reboot", "NotAfter": "2019-03-15T22:00:00.000Z", "NotBefore": "2019-03-14T20:00:00.000Z", "NotBeforeDeadline": "2019-04-05T11:00:00.000Z" } ] ] ``` O exemplo de saída a seguir mostra um evento de desativação de instância: ``` [ "Events": [ { "InstanceEventId": "instance-event-0e439355b779n26", "Code": "instance-stop", "Description": "The instance is running on degraded hardware", "NotBefore": "2015-05-23T00:00:00.000Z" } ] ] ``` ------ #### [ PowerShell ] **Para visualizar eventos programados para suas instâncias** Use o seguinte comando [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html). ``` (Get-EC2InstanceStatus -InstanceId i-1234567890abcdef0).Events ``` O exemplo de saída a seguir mostra um evento de desativação de instância: ``` Code : instance-stop Description : The instance is running on degraded hardware NotBefore : 5/23/2015 12:00:00 AM ``` ------ #### [ Instance metadata ] **Para visualizar os eventos programados para suas instâncias usando metadados de instância** É possível recuperar informações sobre eventos de manutenção ativos para suas instâncias dos [metadados de instância](ec2-instance-metadata.md) usando o Serviço de metadados da instância versão 2 ou o Serviço de metadados da instância versão 1. **IMDSv2** ``` [ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \ && curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/events/maintenance/scheduled ``` **IMDSv1** ``` [ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/events/maintenance/scheduled ``` A seguir, temos um exemplo de saída com informações sobre um evento de reinicialização do sistema programado, no formato JSON. ``` [ { "NotBefore" : "21 Jan 2019 09:00:43 GMT", "Code" : "system-reboot", "Description" : "scheduled reboot", "EventId" : "instance-event-0d59937288b749b32", "NotAfter" : "21 Jan 2019 09:17:23 GMT", "State" : "active" } ] ``` **Para visualizar o histórico de eventos sobre eventos concluídos ou cancelados das suas instâncias usando metadados de instância** É possível recuperar informações sobre eventos concluídos ou cancelados para suas instâncias dos [metadados de instância](ec2-instance-metadata.md) usando o Serviço de metadados da instância versão 2 ou o Serviço de metadados da instância versão 1. **IMDSv2** ``` [ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \ && curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/events/maintenance/history ``` **IMDSv1** ``` [ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/events/maintenance/history ``` A seguir, temos um exemplo de saída com informações sobre um evento de reinicialização do sistema que foi cancelado e um que foi concluído, no formato JSON. ``` [ { "NotBefore" : "21 Jan 2019 09:00:43 GMT", "Code" : "system-reboot", "Description" : "[Canceled] scheduled reboot", "EventId" : "instance-event-0d59937288b749b32", "NotAfter" : "21 Jan 2019 09:17:23 GMT", "State" : "canceled" }, { "NotBefore" : "29 Jan 2019 09:00:43 GMT", "Code" : "system-reboot", "Description" : "[Completed] scheduled reboot", "EventId" : "instance-event-0d59937288b749b32", "NotAfter" : "29 Jan 2019 09:17:23 GMT", "State" : "completed" } ] ``` ------ #### [ AWS Health ] É possível usar o AWS Health Dashboard para saber mais sobre eventos que podem afetar a instância. O Health Dashboard organiza problemas em três grupos: ocorrências abertas, alterações programadas e outras notificações. O grupo de alterações programadas contém itens presentes e futuros. Para obter mais informações, consulte [Como iniciar o AWS Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/getting-started-health-dashboard.html) no *Guia do usuário do AWS Health*. ------ # Personalizar notificações de eventos programados para suas instâncias do EC2 É possível personalizar notificações de eventos programados para incluir tags na notificação por e-mail. Isso facilita a identificação do recurso afetado (instâncias ou Hosts dedicados) e priorizar ações para o próximo evento. Ao personalizar notificações de eventos para incluir tags, é possível optar por incluir: + Todas as tags associadas ao recurso afetado + Somente tags específicas que estão associadas ao recurso afetado Por exemplo, suponha que você atribua as tags `application`, `costcenter`, `project` e `owner` a todas as suas instâncias. É possível optar por incluir todas as tags nas notificações de eventos. Como alternativa, se você quiser ver apenas as tags `owner` e `project` nas notificações de eventos, poderá optar por incluir apenas essas tags. Depois de selecionar as tags a serem incluídas, as notificações de evento incluirão o ID do recurso (ID da instância ou ID do Host dedicado) e os pares de chave de tag e valor associados ao recurso afetado. **Topics** + [Incluir tags em notificações de eventos](#register-tags) + [Remover tags de notificações de eventos](#deregister-tags) + [Visualizar as tags a serem incluídas nas notificações de eventos](#view-tags) ## Incluir tags em notificações de eventos As tags que você escolher incluir se aplicarão a todos os recursos (instâncias e Hosts dedicados) na região selecionada. Para personalizar notificações de eventos em outras regiões, primeiro selecione a região necessária e execute as etapas a seguir. ------ #### [ Console ] **Como incluir tags em notificações de eventos** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Escolha **Actions (Ações)**, **Manage event notifications (Gerenciar notificações de eventos)**. 1. Ative a opção **Incluir tags em notificações de eventos**. 1. Siga um destes procedimentos, dependendo das tags que você deseja incluir nas notificações de eventos: + Para incluir todas as tags associadas à instância afetada ou ao Host dedicado, selecione **Incluir todas as tags**. + Para selecionar as tags a serem incluídas, selecione **Escolher as tags a serem incluídas** e, em seguida, selecione ou insira as chaves de tag. 1. Escolha **Salvar**. ------ #### [ AWS CLI ] **Como incluir todas as tags em notificações de eventos** Use o comando [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) e defina o parâmetro `IncludeAllTagsOfInstance` como `true`. ``` aws ec2 register-instance-event-notification-attributes \ --instance-tag-attribute "IncludeAllTagsOfInstance=true" ``` **Como incluir tags específicas em notificações de eventos** Use o comando [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) e especifique as tags a serem incluídas usando o parâmetro `InstanceTagKeys`. ``` aws ec2 register-instance-event-notification-attributes \ --instance-tag-attribute 'InstanceTagKeys=["tag_key_1", "tag_key_2", "tag_key_3"]' ``` ------ #### [ PowerShell ] **Como incluir todas as tags em notificações de eventos** Use o cmdlet [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html). ``` Register-EC2InstanceEventNotificationAttribute ` -InstanceTagAttribute_IncludeAllTagsOfInstance $true ``` **Como incluir tags específicas em notificações de eventos** Use o cmdlet [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html). ``` Register-EC2InstanceEventNotificationAttribute ` -InstanceTagAttribute_InstanceTagKey tag_key_1, tag_key_2, tag_key_3 ``` ------ ## Remover tags de notificações de eventos É possível remover tags das notificações de eventos. ------ #### [ Console ] **Como remover tags de notificações de eventos** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Escolha **Actions (Ações)**, **Manage event notifications (Gerenciar notificações de eventos)**. 1. Para remover todas as tags das notificações de eventos, desmarque **Incluir tags nas notificações de eventos**. 1. Para remover tags específicas das notificações de eventos, escolha o **X** para as chaves de tag correspondentes. 1. Escolha **Salvar**. ------ #### [ AWS CLI ] **Como remover todas as tags das notificações de eventos** Use o comando [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) e defina o parâmetro `IncludeAllTagsOfInstance` como `false`. ``` aws ec2 deregister-instance-event-notification-attributes \ --instance-tag-attribute "IncludeAllTagsOfInstance=false" ``` **Para remover uma tag de notificações de eventos** Use o comando [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) e especifique as tags a serem removidas usando o parâmetro `InstanceTagKeys`. ``` aws ec2 deregister-instance-event-notification-attributes \ --instance-tag-attribute 'InstanceTagKeys=["tag_key_3"]' ``` ------ #### [ PowerShell ] **Como remover todas as tags das notificações de eventos** Use o cmdlet [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html). ``` Unregister-EC2InstanceEventNotificationAttribute ` -InstanceTagAttribute_IncludeAllTagsOfInstance $false ``` **Para remover uma tag de notificações de eventos** Use o cmdlet [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html). ``` Unregister-EC2InstanceEventNotificationAttribute ` -InstanceTagAttribute_InstanceTagKey tag_key_3 ``` ------ ## Visualizar as tags a serem incluídas nas notificações de eventos É possível visualizar as tags que serão incluídas nas notificações de eventos. ------ #### [ Console ] **Como visualizar as tags a serem incluídas nas notificações de eventos** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Escolha **Actions (Ações)**, **Manage event notifications (Gerenciar notificações de eventos)**. ------ #### [ AWS CLI ] **Para visualizar as tags que serão incluídas nas notificações de eventos** Use o comando [describe-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-event-notification-attributes.html). ``` aws ec2 describe-instance-event-notification-attributes ``` ------ #### [ PowerShell ] **Para visualizar as tags que serão incluídas nas notificações de eventos** Use o cmdlet [Get-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceEventNotificationAttribute.html). ``` Get-EC2InstanceEventNotificationAttribute ``` ------ # Reagendar um evento programado para uma instância do EC2 É possível reagendar um evento para que ele ocorra em uma data e hora específicas que forem convenientes. Após um evento programado ser reagendado, até um ou dois minutos podem ser necessários para que a data atualizada seja exibida. **Limitações** + Somente eventos com uma data de prazo podem ser reprogramados. O evento pode ser reprogramado até a data de prazo do evento. A data limite do evento é indicada na coluna **Data limite** (console) e o campo `NotBeforeDeadline` (AWS CLI). + Somente eventos ainda não iniciados podem ser reprogramados. A hora de início é indicada na coluna **Hora de início** (console) e no campo `NotBefore` (AWS CLI). Eventos programados para início nos próximos cinco minutos não podem ser reprogramados. + A nova hora de início do evento deve ser pelo menos 60 minutos a partir da hora atual. + Se você reprogramar vários eventos usando o console, a data de prazo do evento será determinada pelo evento com a data de prazo do evento mais recente. ------ #### [ Console ] **Para reprogramar um evento** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Escolha **Resource type: instance (Tipo de recurso: instância)** na lista de filtros. 1. Escolha uma ou mais instâncias e selecione **Actions (Ações)**, **Schedule event (Programar evento)**. Somente eventos que têm uma data de prazo de evento, indicados por um valor para **Deadline (Prazo)**, podem ser reprogramados. Se um dos eventos selecionados não tiver uma data de prazo, a opção **Actions (Ações)**, **Schedule event (Programar evento)** será desativada. 1. Em **New start time (Nova hora de início)**, insira uma nova data e hora para o evento. A nova data e hora devem ocorrer antes de **Event deadline (Prazo do evento)**. 1. Escolha **Salvar**. Pode levar um ou dois minutos para a hora de início do evento atualizado ser refletida no console. ------ #### [ AWS CLI ] **Para reprogramar um evento** Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-start-time.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-start-time.html). ``` aws ec2 modify-instance-event-start-time \ --instance-id i-1234567890abcdef0 \ --instance-event-id instance-event-0d59937288b749b32 \ --not-before 2020-03-25T10:00:00.000 ``` ------ #### [ PowerShell ] **Para reprogramar um evento** Use o cmdlet [Edit-EC2InstanceEventStartTime](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventStartTime.html). ``` Edit-EC2InstanceEventStartTime ` -InstanceId i-1234567890abcdef0 ` -InstanceEventId instance-event-0d59937288b749b32 ` -NotBefore 2020-03-25T10:00:00.000 ``` ------ # Criar janelas de eventos personalizadas para eventos programados que afetam as instâncias do Amazon EC2 É possível definir janelas de eventos personalizadas recorrentes semanalmente para eventos agendados que reinicializam, interrompem ou terminam suas instâncias do Amazon EC2. É possível associar uma ou mais instâncias a uma janela de eventos. Se um evento agendado para essas instâncias estiver planejado, a AWS irá programar os eventos na janela de eventos associada. É possível usar janelas de eventos para maximizar a disponibilidade da workload especificando janelas de eventos que ocorrem durante períodos fora do pico para sua workload. Também é possível alinhar as janelas de eventos com suas programações de manutenção internas. Você define uma janela de evento especificando um conjunto de intervalos de tempo. O intervalo de tempo mínimo é de duas horas. Os intervalos de tempo combinados devem totalizar pelo menos 4 horas. É possível associar uma ou mais instâncias a uma janela de evento usando IDs de instância ou tags de instância. Também é possível associar hosts dedicados a uma janela de evento usando o ID do host. **Atenção** As janelas de eventos são aplicáveis apenas para eventos agendados que param, reinicializam ou encerram instâncias. Janelas de eventos sãonãoaplicável para: Eventos agendados e eventos de manutenção de rede acelerados. Manutenção não programada, como [recuperação automática de instâncias](ec2-instance-recover.md) e reinicializações não planejadas. **Topics** + [Considerações](#event-windows-considerations) + [Criar uma janela de eventos](#create-event-windows) + [Associar um alvo a uma janela de evento](#associate-target-event-window) + [Desassociar uma tag de uma janela de eventos](#disassociate-target-event-window) + [Modificar uma janela de eventos](#modify-event-windows) + [Excluir uma janela de eventos](#delete-event-windows) ## Considerações + Todos os horários da janela de eventos são mostrados em UTC. + Uma janela de eventos pode conter vários intervalos de tempo. Embora cada intervalo individual deva ter pelo menos duas horas, a duração total em todos os intervalos deve ser de pelo menos quatro horas. + Apenas um tipo de destino (ID de instância, ID de host dedicado ou tag de instância) pode ser associado a uma janela de evento. + Um destino (ID de instância, ID de host dedicado ou tag de instância) só pode ser associado a uma janela de evento. + Um máximo de 100 IDs de instância, ou 50 IDs de host dedicados ou 50 tags de instância podem ser associados a uma janela de evento. As tags de instância podem ser associadas a qualquer número de instâncias. + Um máximo de 200 janelas de eventos podem ser criadas por AWS região: + Várias instâncias associadas a janelas de eventos podem potencialmente ter eventos agendados ocorrem ao mesmo tempo. + Se a AWS já agendou um evento, modificar uma janela de evento não alterará a hora do evento agendado. Se o evento tiver uma data limite, é possível[reprogramar o evento](reschedule-event.md). + Você pode interromper e iniciar uma instância antes do evento programado. Isso migra essa instância para um novo host e limpa o evento. ## Criar uma janela de eventos É possível criar uma ou mais janelas de eventos. Para cada janela de evento, você especifica um ou mais blocos de tempo. Por exemplo, é possível criar uma janela de evento com blocos de tempo que ocorrem todos os dias às 4h por duas horas. Ou é possível criar uma janela de evento com blocos de tempo que ocorrem aos domingos, das 2h às 4h, e às quartas-feiras, das 3h às 5h. Janelas de eventos repetem semanalmente até que você as exclua. ------ #### [ Console ] **Para criar uma janela de eventos** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Selecione **Ações**, **Gerenciar janelas de eventos**. 1. Selecione **Janela Criar evento de instância**. 1. para o **Nome da janela de eventos**, insira um nome descritivo para a janela de eventos. 1. para o **Agendamento de janelas**, escolha especificar os blocos de tempo na janela de eventos usando o construtor de cron ou especificando intervalos de tempo. + Se escolher o **Construtor de cron**, especifique o seguinte: 1. para o **Dias (UTC)**, especifique os dias da semana em que a janela de eventos ocorre. 1. para o **Hora de início (UTC)**, especifique a hora em que a janela de evento começa. 1. para a **Duração**, especifique a duração dos blocos de tempo na janela do evento. A duração mínima por bloco de tempo é de 2 horas. A duração mínima da janela do evento deve ser igual ou superior a 4 horas no total. Todos os horários são em UTC. + Se escolher **Intervalos de tempo**, escolha **Adicione um novo intervalo de tempo** e especifique o dia e a hora de início e o dia e a hora de término. Repita para cada intervalo de tempo. A duração mínima por intervalo de tempo é de 2 horas. A duração mínima para todos os intervalos de tempo combinados deve ser igual ou superior a 4 horas no total. 1. (Opcional) Em **Detalhes do destino**, associe uma ou mais instâncias à janela de eventos. Use IDs de instância ou etiquetas de instância para associar instâncias. Use IDs de host para associar Hosts dedicados. Quando esses destinos estiverem programados para manutenção, o evento ocorrerá durante essa janela de eventos. É possível criar a janela de evento sem associar um destino à janela. Posteriormente, é possível modificar a janela para associar um ou mais alvos. 1. (Opcional) Para **Tags da janela de evento**, escolha **Adicionar tag** e insira a chave e o valor da tag. Repita esse procedimento para cada tag. 1. Selecione **Janela Criar eventos**. ------ #### [ AWS CLI ] **Para criar uma janela de eventos com um intervalo de tempo** Use o comando [create-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-instance-event-window.html). ``` aws ec2 create-instance-event-window \ --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 \ --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \ --name myEventWindowName ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "TimeRanges": [ { "StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8 } ], "Name": "myEventWindowName", "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` **Para criar uma janela de eventos com uma expressão cron** Use o comando [create-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-instance-event-window.html). ``` aws ec2 create-instance-event-window \ --cron-expression "* 21-23 * * 2,3" \ --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \ --name myEventWindowName ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` ------ #### [ PowerShell ] **Para criar uma janela de eventos com um intervalo de tempo** Use o cmdlet [New-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2InstanceEventWindow.html). ``` $timeRange = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest $timeRange.StartWeekDay = "monday" $timeRange.EndWeekDay = "wednesday" $timeRange.StartHour = 2 $timeRange.EndHour = 8 $tag = @{Key="key1"; Value="value1"} $tagspec = New-Object Amazon.EC2.Model.TagSpecification $tagspec.ResourceType = "instance-event-window" $tagspec.Tags.Add($tag) New-EC2InstanceEventWindow ` -Name my-event-window ` -TagSpecification $tagspec ` -TimeRange @($timeRange) ``` O seguinte é um exemplo de saída. ``` AssociationTarget : CronExpression : InstanceEventWindowId : iew-0abcdef1234567890 Name : my-event-window State : creating Tags : {key1} TimeRanges : {Amazon.EC2.Model.InstanceEventWindowTimeRange} ``` **Para criar uma janela de eventos com uma expressão cron** Use o cmdlet [New-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2InstanceEventWindow.html). ``` $tag = @{Key="key1"; Value="value1"} $tagspec = New-Object Amazon.EC2.Model.TagSpecification $tagspec.ResourceType = "instance-event-window" $tagspec.Tags.Add($tag) New-EC2InstanceEventWindow ` -Name my-event-window ` -TagSpecification $tagspec` -CronExpression "* 21-23 * * 2,3" ``` O seguinte é um exemplo de saída. ``` AssociationTarget : CronExpression : * 21-23 * * 2,3 InstanceEventWindowId : iew-0abcdef1234567890 Name : my-event-window State : creating Tags : {key1} TimeRanges : {} ``` ------ ## Associar um alvo a uma janela de evento Após criar uma janela de evento, você poderá associar destinos à janela de eventos. É possível associar apenas um tipo de destino a uma janela de eventos. É possível especificar IDs de instância, IDs de host dedicado ou tags de instância. ------ #### [ Console ] **Para associar destinos adicionais a uma janela de eventos** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Selecione a janela de eventos a ser modificada. 1. Escolha **Ações**, **Modificar janela de eventos da instância**. ------ #### [ AWS CLI ] **Para associar tags de instância a uma janela de eventos** Use o comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html). ``` aws ec2 associate-instance-event-window \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]" ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [ { "Key": "k2", "Value": "v2" }, { "Key": "k1", "Value": "v1" } ], "DedicatedHostIds": [] }, "State": "creating" } } ``` **Para associar IDs de instâncias a uma janela de eventos** Use o comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html). ``` aws ec2 associate-instance-event-window \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7" ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [ "i-1234567890abcdef0", "i-0598c7d356eba48d7" ], "Tags": [], "DedicatedHostIds": [] }, "State": "creating" } } ``` **Para associar um host dedicado a uma janela de eventos** Use o comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html). ``` aws ec2 associate-instance-event-window \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "DedicatedHostIds=h-029fa35a02b99801d" ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [ "h-029fa35a02b99801d" ] }, "State": "creating" } } ``` ------ #### [ PowerShell ] **Para associar tags de instância a uma janela de eventos** Use o cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html). ``` $tag1 = @{Key="key1"; Value="value1"} $tag2 = @{Key="key2"; Value="value2"} Register-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -AssociationTarget_InstanceTag @($tag1,$tag2) ``` **Para associar IDs de instâncias a uma janela de eventos** Use o cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html). ``` Register-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -AssociationTarget_InstanceId i-1234567890abcdef0, i-0598c7d356eba48d7 ``` **Para associar um host dedicado a uma janela de eventos** Use o cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html). ``` Register-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -AssociationTarget_DedicatedHostId h-029fa35a02b99801d ``` ------ ## Desassociar uma tag de uma janela de eventos ------ #### [ Console ] **Para desassociar destinos com uma janela de eventos** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Selecione a janela de eventos a ser modificada. 1. Escolha **Ações**, **Modificar janela de eventos da instância**. ------ #### [ AWS CLI ] **Para desassociar tags de instância de uma janela de eventos** Use o comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference//ec2/disassociate-instance-event-window.html). ``` aws ec2 disassociate-instance-event-window \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]" ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [] }, "State": "creating" } } ``` **Para desassociar IDs de instâncias de uma janela de eventos** Use o comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-instance-event-window.html). ``` aws ec2 disassociate-instance-event-window \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7" ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [] }, "State": "creating" } } ``` **Para desassociar um host dedicado de uma janela de eventos** Use o comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-instance-event-window.html). ``` aws ec2 disassociate-instance-event-window \ --instance-event-window-id iew-0abcdef1234567890 \ --association-target DedicatedHostIds=h-029fa35a02b99801d ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [], "Tags": [], "DedicatedHostIds": [] }, "State": "creating" } } ``` ------ #### [ PowerShell ] **Para desassociar tags de instância de uma janela de eventos** Use o cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html). ``` $tag1 = @{Key="key1"; Value="value1"} $tag2 = @{Key="key2"; Value="value2"} Unregister-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -AssociationTarget_InstanceTag @($tag1, $tag2) ``` **Para desassociar IDs de instâncias de uma janela de eventos** Use o cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html). ``` Unregister-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -AssociationTarget_InstanceId i-1234567890abcdef0, i-0598c7d356eba48d7 ``` **Para desassociar um host dedicado de uma janela de eventos** Use o cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html). ``` Unregister-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -AssociationTarget_DedicatedHostId h-029fa35a02b99801d ``` ------ ## Modificar uma janela de eventos É possível modificar todos os campos de uma janela de evento, exceto seu ID. Por exemplo, quando o horário de verão começar, convém modificar o agendamento da janela de eventos. Para janelas de eventos existentes, talvez você queira adicionar ou remover destinos. É possível modificar um intervalo de tempo ou uma expressão cron ao modificar a janela de evento, mas não ambos. ------ #### [ Console ] **Para modificar uma janela de eventos** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Selecione **Ações**, **Gerenciar janelas de eventos**. 1. Selecione a janela de eventos a ser modificada e escolha **Ações**, **Janela Modificar evento da instância**. 1. Modifique os campos na janela de eventos e escolha **Modificar janela de evento**. ------ #### [ AWS CLI ] **Para modificar o intervalo de tempo de uma janela de eventos** Use o comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html). ``` aws ec2 modify-instance-event-window --instance-event-window-id iew-0abcdef1234567890 \ --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "TimeRanges": [ { "StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8 } ], "Name": "myEventWindowName", "AssociationTarget": { "InstanceIds": [ "i-0abcdef1234567890", "i-0be35f9acb8ba01f0" ], "Tags": [], "DedicatedHostIds": [] }, "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` **Modificar um conjunto de intervalos de tempo para uma janela de eventos** Use o comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html). ``` aws ec2 modify-instance-event-window --instance-event-window-id iew-0abcdef1234567890 \ --time-range '[{"StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8}, {"StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8}]' ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "TimeRanges": [ { "StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8 }, { "StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8 } ], "Name": "myEventWindowName", "AssociationTarget": { "InstanceIds": [ "i-0abcdef1234567890", "i-0be35f9acb8ba01f0" ], "Tags": [], "DedicatedHostIds": [] }, "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` **Para modificar a expressão cron de uma janela de eventos** Use o comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html). ``` aws ec2 modify-instance-event-window --instance-event-window-id iew-0abcdef1234567890 \ --cron-expression "* 21-23 * * 2,3" ``` O seguinte é um exemplo de saída. ``` { "InstanceEventWindow": { "InstanceEventWindowId": "iew-0abcdef1234567890", "Name": "myEventWindowName", "CronExpression": "* 21-23 * * 2,3", "AssociationTarget": { "InstanceIds": [ "i-0abcdef1234567890", "i-0be35f9acb8ba01f0" ], "Tags": [], "DedicatedHostIds": [] }, "State": "creating", "Tags": [ { "Key": "K1", "Value": "V1" } ] } } ``` ------ #### [ PowerShell ] **Para modificar o intervalo de tempo de uma janela de eventos** Use o cmdlet [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html). ``` $timeRange1 = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest $timeRange1.StartWeekDay = "monday" $timeRange1.EndWeekDay = "wednesday" $timeRange1.StartHour = 2 $timeRange1.EndHour = 8 $timeRange2 = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest $timeRange2.StartWeekDay = "thursday" $timeRange2.EndWeekDay = "friday" $timeRange2.StartHour = 1 $timeRange2.EndHour = 6 Edit-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -TimeRange @($timeRange1, $timeRange2) ``` **Para modificar a expressão cron de uma janela de eventos** Use o cmdlet [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html). ``` Edit-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -CronExpression "* 21-23 * * 2,3" ``` ------ ## Excluir uma janela de eventos É possível excluir uma janela de eventos de cada vez. ------ #### [ Console ] **Para excluir uma janela de eventos** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Events**. 1. Selecione **Ações**, **Gerenciar janelas de eventos**. 1. Selecione a janela de eventos a ser excluída e escolha **Ações**, **Janela de evento Excluir instância**. 1. Quando solicitado, digite **delete** e escolha **Delete (Excluir)**. ------ #### [ AWS CLI ] **Para excluir uma janela de eventos** Usar a[delete-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-instance-event-window.html)e especifique a janela de evento a ser excluída. ``` aws ec2 delete-instance-event-window \ --instance-event-window-id iew-0abcdef1234567890 ``` **Para forçar a exclusão de uma janela de eventos** Usar a`--force-delete`se a janela de evento estiver atualmente associada a destinos. ``` aws ec2 delete-instance-event-window \ --instance-event-window-id iew-0abcdef1234567890 \ --force-delete ``` ------ #### [ PowerShell ] **Para excluir uma janela de eventos** Use o cmdlet [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html). ``` Remove-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ``` **Para forçar a exclusão de uma janela de eventos** Use o cmdlet [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html). ``` Remove-EC2InstanceEventWindow ` -InstanceEventWindowId iew-0abcdef1234567890 ` -ForceDelete $true ``` ------ # Monitorar instâncias usando o CloudWatch É possível monitorar suas instâncias usando o Amazon CloudWatch, que coleta e processa os dados brutos do Amazon EC2 em métricas legíveis, quase em tempo real. Essas estatísticas são registradas para um período de 15 meses, de forma que você possa acessar informações históricas e ganhar uma perspectiva melhor sobre como seu serviço ou aplicação Web está se saindo. Por padrão, o Amazon EC2 envia dados de métrica ao CloudWatch em períodos de 5 minutos. Para enviar dados de métrica para sua instância ao CloudWatch em períodos de 1 minuto, é possível habilitar o monitoramento detalhado na instância. Para obter mais informações, consulte [Gerenciar o monitoramento detalhado das instâncias do Amazon EC2](manage-detailed-monitoring.md). O console do Amazon EC2 exibe uma série de gráficos com base nos dados brutos do Amazon CloudWatch. Dependendo de suas necessidades, é possível preferir obter dados para suas instâncias do Amazon CloudWatch em vez de gráficos no console. Para saber mais sobre faturamento e custos do Amazon CloudWatch, consulte [Faturamento e custos do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_billing.html) no *Guia do usuário do Amazon CloudWatch*. **Topics** + [Gerenciar os alarmes do CloudWatch para as instâncias do EC2 no console do Amazon EC2](ec2-instance-alarms.md) + [Gerenciar o monitoramento detalhado das instâncias do Amazon EC2](manage-detailed-monitoring.md) + [As métricas do CloudWatch que estão disponíveis para as instâncias](viewing_metrics_with_cloudwatch.md) + [Instale e configure o agente do CloudWatch usando o console do Amazon EC2 para adicionar métricas adicionais](install-and-configure-cloudwatch-agent-using-ec2-console.md) + [Estatísticas para as métricas do CloudWatch para as instâncias](monitoring_get_statistics.md) + [Exibir os grafos de monitoramento para as instâncias](graphs-in-the-aws-management-console.md) + [Criar um alarme do CloudWatch para uma instância](using-cloudwatch-createalarm.md) + [Criar alarmes para interromper, encerrar, reinicializar ou recuperar uma instância](UsingAlarmActions.md) # Gerenciar os alarmes do CloudWatch para as instâncias do EC2 no console do Amazon EC2 Na tela **Instâncias** do console do Amazon EC2, você pode gerenciar os alarmes do Amazon CloudWatch para as suas instâncias. Na tabela **Instâncias**, a coluna **Status do alarme** fornece dois controles do console: um controle para visualizar os alarmes e outro para criá-los ou editá-los. A captura de tela a seguir indica esses controles do console, numerados como **1** (**Visualizar alarmes**) e **2** (um sinal de **\$1** para criar ou editar um alarme). ![\[Os controles na tabela Instâncias no console do EC2 para visualizar e criar alarmes. 1. Visualizar alarmes 2. Símbolo de adição.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/instance-alarms.png) ## Visualizar alarmes na tela Instâncias É possível visualizar os alarmes de cada instância na tela **Instâncias**. **Para visualizar o alarme de uma instância na tela Instâncias** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Na tabela **Instâncias**, para a instância escolhida, escolha **Visualizar alarmes** (numerados com **1** na captura de tela anterior). 1. Na janela **Detalhes do alarme para *i-1234567890abcdef0***, escolha o nome do alarme para visualizar no console do CloudWatch. ## Criar alarmes na tela Instâncias É possível criar um alarme para cada instância na tela **Instâncias**. **Para criar um alarme para uma instância na tela Instâncias** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Na tabela **Instâncias**, para a instância escolhida, escolha o sinal de adição (numerado com **2** na captura de tela anterior). 1. Na tela **Gerenciar alarmes do CloudWatch**, crie seu alarme. Para obter mais informações, consulte [Criar um alarme do CloudWatch para uma instância](using-cloudwatch-createalarm.md). ## Editar alarmes na tela Instâncias É possível editar um alarme para uma instância na tela **Instâncias**. **Para editar um alarme para uma instância na tela Instâncias** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Na tabela **Instâncias**, para a instância escolhida, escolha o sinal de adição (numerado com **2** na captura de tela anterior). 1. Na tela **Gerenciar alarmes do CloudWatch**, edite o alarme. Para obter mais informações, consulte [Editar ou excluir um alarme do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Manage-CloudWatch-Alarm.html#Edit-CloudWatch-Alarm) no *Guia do usuário do Amazon CloudWatch*. # Gerenciar o monitoramento detalhado das instâncias do Amazon EC2 O Amazon CloudWatch fornece duas categorias de monitoramento: *monitoramento básico* e *monitoramento detalhado*. Por padrão, a instância está configurada para monitoramento básico. Como opção, é possível habilitar o monitoramento detalhado para ajudar você a identificar e atuar mais rapidamente em problemas operacionais. É possível habilitar ou desativar o monitoramento detalhado em uma instância quando executá-la ou depois de a instância estar sendo executada ou ter sido interrompida. Habilitar o monitoramento detalhado em uma instância não afeta o monitoramento dos volumes do EBS anexados. Para obter mais informações, consulte [Métricas de uso do Amazon CloudWatch para o Amazon EBS](https://docs.aws.amazon.com/ebs/latest/userguide/using_cloudwatch_ebs.html). A tabela a seguir destaca as diferenças entre o monitoramento básico e o monitoramento detalhado de instâncias. | Tipo de monitoramento | Descrição | Cobranças | | --- | --- | --- | | Monitoramento básico | As métricas de verificação de status estão disponíveis em períodos de um minuto. Todas as outras métricas estão disponíveis em períodos de cinco minutos. | Sem cobrança. | | Monitoramento detalhado | É possível obter métricas em intervalos de 1 minuto, desde que você habilite o monitoramento detalhado para a instância. Depois de ativar o monitoramento detalhado, será possível agregar os dados em grupos de instâncias semelhantes. | A cobrança é feita pela métrica que o Amazon EC2 envia para o CloudWatch. Você não é cobrado pelo armazenamento de dados. Para obter mais informações, consulte Nível pago na [página de preços do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/#Paid_tier). | **Topics** + [Permissões obrigatórias](#iam-detailed-monitoring) + [Habilitar o monitoramento detalhado no momento da execução](#enable-detailed-monitoring) + [Gerenciar o monitoramento detalhado](#disable-detailed-monitoring) ## Permissões obrigatórias Para habilitar o monitoramento detalhado de uma instância, o usuário deve ter permissão para usar a ação de API [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_MonitorInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_MonitorInstances.html). Para desativar o monitoramento detalhado de uma instância, o usuário deve ter permissão para usar a ação de API [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_UnmonitorInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_UnmonitorInstances.html). ## Habilitar o monitoramento detalhado no momento da execução Use os procedimentos a seguir para habilitar o monitoramento detalhado no momento da execução. Por padrão, a instância usa o monitoramento básico. ------ #### [ Console ] **Para habilitar o monitoramento detalhado ao executar uma instância** Ao executar uma instância usando o console do Amazon EC2, em **Detalhes avançados**, marque a caixa de seleção **Monitoramento detalhado do CloudWatch**. ------ #### [ AWS CLI ] **Para habilitar o monitoramento detalhado ao executar uma instância** Use o comando [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) com a opção `--monitoring`. ``` --monitoring Enabled=true ``` ------ #### [ PowerShell ] **Para habilitar o monitoramento detalhado ao executar uma instância** Use o cmdlet [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) com o parâmetro `-Monitoring`. ``` -Monitoring $true ``` ------ ## Gerenciar o monitoramento detalhado Use os procedimentos a seguir para gerenciar o monitoramento detalhado para uma instância em execução ou interrompida. ------ #### [ Console ] **Para gerenciar o monitoramento detalhado** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione a instância. 1. Escolha **Ações**, **Monitorar e solucionar problemas**, **Gerenciar monitoramento detalhado**. 1. Na página **Monitoramento detalhado**, para **Monitoramento detalhado**, faça o seguinte: + Monitoramento detalhado: selecione **Habilitar**. + Monitoramento básico: desmarque **Habilitar**. 1. Escolha **Confirmar**. ------ #### [ AWS CLI ] **Para habilitar o monitoramento detalhado** Use o seguinte comando [monitor-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/monitor-instances.html). ``` aws ec2 monitor-instances --instance-ids i-1234567890abcdef0 ``` **Para desabilitar o monitoramento detalhado** Use o seguinte comando [unmonitor-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/unmonitor-instances.html). ``` aws ec2 unmonitor-instances --instance-ids i-1234567890abcdef0 ``` ------ #### [ PowerShell ] **Para habilitar o monitoramento detalhado** Use o cmdlet [Start-EC2InstanceMonitoring](https://docs.aws.amazon.com/powershell/latest/reference/items/Start-EC2InstanceMonitoring.html). ``` Start-EC2InstanceMonitoring -InstanceId i-1234567890abcdef0 ``` **Para desabilitar o monitoramento detalhado** Use o cmdlet [Stop-EC2InstanceMonitoring](https://docs.aws.amazon.com/powershell/latest/reference/items/Stop-EC2InstanceMonitoring.html). ``` Stop-EC2InstanceMonitoring -InstanceId i-1234567890abcdef0 ``` ------ # As métricas do CloudWatch que estão disponíveis para as instâncias O Amazon EC2 envia métricas para o Amazon CloudWatch. É possível usar o Console de gerenciamento da AWS, a AWS CLI ou uma API para listar as métricas que o Amazon EC2 envia para o CloudWatch. Por padrão, cada ponto de dados abrange os 5 minutos seguintes ao início da atividade para a instância. Se você tiver habilitado o monitoramento detalhado, cada ponto de dados abrangerá o minuto seguinte ao início da atividade. Observe que, para as estatísticas Mínimo, Máximo e Média, a granularidade mínima para as métricas que o EC2 fornece é de 1 minuto. Para obter informações sobre como visualizar as métricas disponíveis usando o Console de gerenciamento da AWS ou a AWS CLI, consulte [Visualizar métricas disponíveis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) no *Guia do usuário do Amazon CloudWatch*. Para obter informações sobre a obtenção de estatísticas para essas métricas, consulte [Estatísticas para as métricas do CloudWatch para as instâncias](monitoring_get_statistics.md). **Topics** + [Métricas de instância](#ec2-cloudwatch-metrics) + [Métricas do acelerador](#accelerator-metrics) + [Métricas de crédito de CPU](#cpu-credit-metrics) + [Métricas de host dedicado](#dh-metrics) + [Métricas do Amazon EBS para instâncias baseadas em Nitro](#ebs-metrics-nitro) + [Métricas de verificação de status](#status-check-metrics) + [Métricas de espelhamento de tráfego](#traffic-mirroring-metrics) + [Métricas do grupo do Auto Scaling](#autoscaling-metrics) + [Dimensões de métrica do Amazon EC2](#ec2-cloudwatch-dimensions) + [Métricas de uso do Amazon EC2](#service-quota-metrics) ## Métricas de instância O namespace `AWS/EC2` inclui as métricas de instância a seguir. | Métrica | Descrição | Unidade | Estatísticas significativas | | --- | --- | --- | --- | | CPUUtilization | A porcentagem de tempo físico de CPU que o Amazon EC2 usa para executar a instância do EC2, que inclui o tempo gasto para executar o código do usuário e o código do Amazon EC2. Em um nível muito alto, `CPUUtilization` é a soma da `CPUUtilization` do guest e da `CPUUtilization` do hypervisor. As ferramentas em seu sistema operacional podem mostrar uma porcentagem diferente da do CloudWatch devido a fatores como simulação de dispositivos legados, configuração de dispositivos não legados, workloads com interrupções pesadas, migração ao vivo e atualização ao vivo. | Percent | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | DiskReadOps | Operações de leitura concluídas de todos os volumes de armazenamento de instâncias disponíveis para a instância em um período de tempo especificado. Para calcular a média de operações de I/O por segundo (IOPS) para o período, divida o total das operações pelo número de segundos no período em questão. Se não houver nenhum volume de armazenamento de instâncias, o valor será 0 ou a métrica não será relatada. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | DiskWriteOps | Operações de gravação concluídas em todos os volumes de armazenamento de instâncias disponíveis para a instância em um período de tempo especificado. Para calcular a média de operações de I/O por segundo (IOPS) para o período, divida o total das operações pelo número de segundos no período em questão. Se não houver nenhum volume de armazenamento de instâncias, o valor será 0 ou a métrica não será relatada. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | DiskReadBytes | Bytes lidos de todos os volumes de armazenamento de instâncias disponíveis para a instância. Essa métrica é utilizada para determinar o volume de dados que a aplicação lê do disco rígido da instância. Isso pode ser usado para determinar a velocidade da aplicação. O número relatado é o número de bytes recebidos durante o período. Se você estiver usando o monitoramento básico (5 minutos), divida esse número por 300 para encontrar o número de bytes/segundo. Se você estiver usando o monitoramento detalhado (1 minuto), divida o número por 60. Você também pode usar a função métrica matemática `DIFF_TIME` do CloudWatch para encontrar os bytes por segundo. Por exemplo, se você tiver representado graficamente `DiskReadBytes` no CloudWatch como `m1`, a fórmula métrica matemática `m1/(DIFF_TIME(m1))` retornará a métrica em bytes/segundo. Para obter mais informações sobre `DIFF_TIME` e outras funções métricas matemáticas, consulte [Usar métrica matemática](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia do usuário do Amazon CloudWatch*. Se não houver nenhum volume de armazenamento de instâncias, o valor será 0 ou a métrica não será relatada. | Bytes | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | DiskWriteBytes | Bytes gravados em todos os volumes de armazenamento de instâncias disponíveis para a instância. Essa métrica é utilizada para determinar o volume de dados que a aplicação grava no disco rígido da instância. Isso pode ser usado para determinar a velocidade da aplicação. O número relatado é o número de bytes recebidos durante o período. Se você estiver usando o monitoramento básico (5 minutos), divida esse número por 300 para encontrar o número de bytes/segundo. Se você estiver usando o monitoramento detalhado (1 minuto), divida o número por 60. Você também pode usar a função métrica matemática `DIFF_TIME` do CloudWatch para encontrar os bytes por segundo. Por exemplo, se você tiver representado graficamente `DiskWriteBytes` no CloudWatch como `m1`, a fórmula métrica matemática `m1/(DIFF_TIME(m1))` retornará a métrica em bytes/segundo. Para obter mais informações sobre `DIFF_TIME` e outras funções métricas matemáticas, consulte [Usar métrica matemática](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia do usuário do Amazon CloudWatch*. Se não houver nenhum volume de armazenamento de instâncias, o valor será 0 ou a métrica não será relatada. | Bytes | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | MetadataNoToken | O número de vezes que o serviço de metadados de instância (IMDS) foi acessado com êxito por meio de um método que não usa um token. Essa métrica é usada para determinar se existem processos que acessam metadados de instância que usam o serviço de metadados de instância versão 1 (IMDSv1), que não usa um token. Se todas as solicitações usarem sessões baseadas em tokens, por exemplo, o serviço de metadados de instância versão 2 (IMDSv2), o valor será 0. Para obter mais informações, consulte [Transição para usar o Serviço de metadados da instância versão 2](instance-metadata-transition-to-version-2.md). | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | MetadataNoTokenRejected | O número de vezes que uma chamada ao IMDSv1 foi tentada após a desabilitação do IMDSv1. Se essa métrica aparecer, ela indica que uma chamada ao IMDSv1 foi tentada e rejeitada. É possível reabilitar o IMDSv1 ou garantir que todas as suas chamadas usem o IMDSv2. Para obter mais informações, consulte [Transição para usar o Serviço de metadados da instância versão 2](instance-metadata-transition-to-version-2.md). | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | NetworkIn | A quantidade de bytes recebidos em todas as interfaces de rede pela instância. Essa métrica identifica o volume de tráfego de rede de entrada para uma única instância. O número relatado é o número de bytes recebidos durante o período. Se você estiver usando o monitoramento básico (5 minutos) e a estatística for Sum (Soma), divida esse número por 300 para encontrar o número de bytes/segundo. Se você tiver o monitoramento detalhado (1 minuto) e a estatística for Sum (soma), divida o número por 60. | Bytes | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | NetworkOut | A quantidade de bytes enviados em todas as interfaces de rede pela instância. Essa métrica identifica o volume de tráfego de rede de saída de uma única instância. O número relatado é o número de bytes enviados durante o período. Se você estiver usando o monitoramento básico (5 minutos) e a estatística for Sum (Soma), divida esse número por 300 para encontrar o número de bytes/segundo. Se você tiver o monitoramento detalhado (1 minuto) e a estatística for Sum (soma), divida o número por 60. | Bytes | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | NetworkPacketsIn | A quantidade de pacotes recebidos em todas as interfaces de rede pela instância. Essa métrica identifica o volume de tráfego de entrada em termos do número de pacotes em uma única instância. Essa métrica está disponível apenas para monitoramento básico (períodos de 5 minutos). Para calcular a quantidade de pacotes por segundo (PPS) que sua instância recebeu nos 5 minutos, divida o valor da estatística Sum por 300. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | NetworkPacketsOut | A quantidade de pacotes enviados em todas as interfaces de rede pela instância. Essa métrica identifica o volume de tráfego de saída em termos do número de pacotes em uma única instância. Essa métrica está disponível apenas para monitoramento básico (períodos de 5 minutos). Para calcular a quantidade de pacotes por segundo (PPS) que sua instância enviou nos cinco minutos, divida o valor da estatística Sum (soma) por 300. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | ## Métricas do acelerador O namespace `AWS/EC2` inclui a métrica aceleradora a seguir para suas [instâncias de computação acelerada](https://docs.aws.amazon.com/ec2/latest/instancetypes/ac.html). Com suporte somente em um subconjunto dos tipos de instância com computação acelerada. | Métrica | Descrição | Unidade | Estatísticas significativas | | --- | --- | --- | --- | | GPUPowerUtilization | Uso de energia ativa como percentual da potência ativa máxima. | Percentual | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | ## Métricas de crédito de CPU O namespace `AWS/EC2` inclui as seguintes métricas de crédito de CPU para suas [instâncias expansíveis](burstable-performance-instances.md). | Métrica | Descrição | Unidade | Estatísticas significativas | | --- | --- | --- | --- | | CPUCreditUsage | O número de créditos de CPU gastos pela instância por utilização de CPU. Um crédito de CPU equivale a um vCPU em execução em 100% de utilização por um minuto ou a uma combinação equivalente de vCPUs, utilização e tempo (por exemplo, um vCPU em execução a 50% de utilização por dois minutos ou dois vCPUs em execução a 25% de utilização por dois minutos). As métricas de crédito de CPU estão disponíveis apenas a uma frequência de 5 minutos. Se você especificar um período de mais cinco minutos, use a estatística `Sum` em vez da estatística `Average`. | Créditos (minutos de vCPU) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | CPUCreditBalance | O número de créditos ganhos de CPU que uma instância acumulou desde que foi executada ou iniciada. Para a T2 Padrão, o `CPUCreditBalance` também inclui o número de créditos de execução que foram acumulados. Os créditos são acumulados no saldo de créditos após terem sido ganhos e são removidos do saldo de créditos quando são gastos. O saldo de crédito tem um limite máximo, determinado pelo tamanho da instância. Depois que o limite for atingido, todos os novos créditos ganhos serão descartados. Para a T2 Padrão, os créditos de execução não são contabilizados para o limite. Os créditos do `CPUCreditBalance` são disponibilizados para que a instância gaste e apresente expansão com uma utilização de CPU acima da linha de base. Quando uma instância está em execução, os créditos do `CPUCreditBalance` não expiram. Quando uma instância T3 ou T3a é interrompida, o valor `CPUCreditBalance` persiste por sete dias. Consequentemente, todos os créditos acumulados são perdidos. Quando uma instância T2 é interrompida, o valor `CPUCreditBalance` não persiste, e todos os créditos acumulados são perdidos. As métricas de crédito de CPU estão disponíveis apenas a uma frequência de 5 minutos. | Créditos (minutos de vCPU) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | CPUSurplusCreditBalance | O número de créditos excedentes gastos por uma instância `unlimited` quando seu valor `CPUCreditBalance` é zero. O valor `CPUSurplusCreditBalance` é pago pelos créditos de CPU ganhos. Se o número de créditos excedentes ultrapassar o número máximo de créditos que a instância pode ganhar em um período de 24 horas, os créditos excedentes gastos acima do limite máximo incorrerão em uma taxa adicional. As métricas de crédito de CPU estão disponíveis apenas a uma frequência de 5 minutos. | Créditos (minutos de vCPU) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | CPUSurplusCreditsCharged | O número de créditos excedentes gastos que não são pagos pelos créditos de CPU ganhos e que, portanto, incorrem em uma cobrança adicional. Os créditos excedentes gastos são cobrados quando uma das seguintes situações ocorre: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) As métricas de crédito de CPU estão disponíveis apenas a uma frequência de 5 minutos. | Créditos (minutos de vCPU) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | ## Métricas de host dedicado O namespace `AWS/EC2` inclui as métricas a seguir para hosts dedicados T3. | Métrica | Descrição | Unidade | Estatísticas significativas | | --- | --- | --- | --- | | DedicatedHostCPUUtilization | A porcentagem de capacidade computacional alocada que está atualmente em uso pelas instâncias em execução no host dedicado. | Percent | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | ## Métricas do Amazon EBS para instâncias baseadas em Nitro O namespace `AWS/EC2` inclui métricas adicionais do Amazon EBS para os volumes anexados a instâncias baseadas no Nitro que não são instâncias bare metal. | Métrica | Descrição | Unidade | Estatísticas significativas | | --- | --- | --- | --- | | InstanceEBSIOPSExceededCheck | Indica se uma aplicação tentou realizar operações de IOPS que excederam os limites máximos de IOPS do EBS para a instância durante o último minuto. Essa métrica pode assumir o valor `0` (IOPS não excedido) ou `1` (IOPS excedido). | Nenhum | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | InstanceEBSThroughputExceededCheck | Indica se uma aplicação tentou realizar operações de throughput que excederam os limites máximos de throughput do EBS para a instância durante o último minuto. Essa métrica pode assumir o valor `0` (throughput não excedido) ou `1` (throughput excedido). | Nenhum | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | EBSReadOps | Operações de leitura concluídas de todos os volumes do Amazon EBS anexados à instância em um período especificado. Para calcular a média de operações de E/S de leitura por segundo (IOPS de leitura) para o período, divida o total das operações pelo número de segundos no período em questão. Se você estiver usando o monitoramento básico (5 minutos), divida esse número por 300 para calcular o IOPS de leitura. Se você estiver usando o monitoramento detalhado (1 minuto), divida o número por 60. Você também pode usar a função métrica matemática `DIFF_TIME` do CloudWatch para encontrar as operações por segundo. Por exemplo, se você tiver representado graficamente `EBSReadOps` no CloudWatch como `m1`, a função métrica matemática `m1/(DIFF_TIME(m1))` retornará a métrica em operações/segundo. Para obter mais informações sobre `DIFF_TIME` e outras funções métricas matemáticas, consulte [Usar métrica matemática](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia do usuário do Amazon CloudWatch*. | Contagem | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | EBSWriteOps | Operações de gravação concluídas para todos os volumes do EBS anexados à instância em um período especificado. Para calcular a média de operações de E/S de gravação por segundo (IOPS de gravação) para o período, divida o total das operações pelo número de segundos no período em questão. Se você estiver usando o monitoramento básico (5 minutos), divida esse número por 300 para calcular o IOPS de gravação. Se você estiver usando o monitoramento detalhado (1 minuto), divida o número por 60. Você também pode usar a função métrica matemática `DIFF_TIME` do CloudWatch para encontrar as operações por segundo. Por exemplo, se você tiver representado graficamente `EBSWriteOps` no CloudWatch como `m1`, a função métrica matemática `m1/(DIFF_TIME(m1))` retornará a métrica em operações/segundo. Para obter mais informações sobre `DIFF_TIME` e outras funções métricas matemáticas, consulte [Usar métrica matemática](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia do usuário do Amazon CloudWatch*. | Contagem | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | EBSReadBytes | Bytes lidos de todos os volumes do EBS anexados à instância em um período especificado. O número relatado é o número de bytes lidos durante o período. Se você estiver usando o monitoramento básico (5 minutos), divida esse número por 300 para encontrar o número de bytes lidos/segundo. Se você estiver usando o monitoramento detalhado (1 minuto), divida o número por 60. Você também pode usar a função métrica matemática `DIFF_TIME` do CloudWatch para encontrar os bytes por segundo. Por exemplo, se você tiver representado graficamente `EBSReadBytes` no CloudWatch como `m1`, a fórmula métrica matemática `m1/(DIFF_TIME(m1))` retornará a métrica em bytes/segundo. Para obter mais informações sobre `DIFF_TIME` e outras funções métricas matemáticas, consulte [Usar métrica matemática](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia do usuário do Amazon CloudWatch*. | Bytes | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | EBSWriteBytes | Bytes gravados em todos os volumes do EBS anexados à instância em um período especificado. O número relatado é o número de bytes gravados durante o período. Se você estiver usando o monitoramento básico (5 minutos), divida esse número por 300 para encontrar o número de bytes gravados/segundo. Se você estiver usando o monitoramento detalhado (1 minuto), divida o número por 60. Você também pode usar a função métrica matemática `DIFF_TIME` do CloudWatch para encontrar os bytes por segundo. Por exemplo, se você tiver representado graficamente `EBSWriteBytes` no CloudWatch como `m1`, a fórmula métrica matemática `m1/(DIFF_TIME(m1))` retornará a métrica em bytes/segundo. Para obter mais informações sobre `DIFF_TIME` e outras funções métricas matemáticas, consulte [Usar métrica matemática](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia do usuário do Amazon CloudWatch*. | Bytes | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | EBSIOBalance% | Fornece informações sobre a porcentagem de créditos de E/S restantes no bucket de expansão. Essa métrica está disponível somente para monitoramento básico. Essa métrica está disponível apenas para alguns tamanhos de instância `*.4xlarge` e tamanhos menores que se expandam à performance máxima por apenas 30 minutos pelo menos uma vez a cada 24 horas. A estatística `Sum` não é aplicável a essa métrica. | Percentual | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | EBSByteBalance% | Fornece informações sobre a porcentagem de créditos de throughput restantes no bucket de expansão. Essa métrica está disponível somente para monitoramento básico. Essa métrica está disponível apenas para alguns tamanhos de instância `*.4xlarge` e tamanhos menores que se expandam à performance máxima por apenas 30 minutos pelo menos uma vez a cada 24 horas. A estatística `Sum` não é aplicável a essa métrica. | Percentual | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | Para obter informações sobre as métricas fornecidas para seus volumes do EBS, consulte [Métricas para volumes do Amazon EBS](https://docs.aws.amazon.com/ebs/latest/userguide/using_cloudwatch_ebs.html#ebs-volume-metrics) no *Guia do usuário do Amazon EBS*. Para obter informações sobre as métricas fornecidas para frotas do EC2 e para frotas spot, consulte [Monitorar a frota do EC2 ou frota spot usando o CloudWatch](ec2-fleet-cloudwatch-metrics.md). ## Métricas de verificação de status Por padrão, as métricas de verificação de status estão disponíveis a uma frequência de um minuto gratuitamente. Para uma instância recém-executada, os dados de métrica de verificação de status só estarão disponíveis depois que a instância concluir o estado de inicialização (alguns minutos após a instância entrar no estado de `running`). Para obter mais informações sobre verificações de status do EC2, consulte [Verificações do status das instâncias do Amazon EC2](monitoring-system-instance-status-check.md). O namespace `AWS/EC2` inclui as métricas de verificação de status a seguir. | Métrica | Descrição | Unidade | Estatísticas significativas | | --- | --- | --- | --- | | StatusCheckFailed | Informam se a instância foi aprovada nas verificação de status no último minuto. Essa métrica pode ser `0` (aprovada) ou `1` (reprovada). Por padrão, esta métrica está disponível a uma frequência de um minuto gratuitamente. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | StatusCheckFailed\$1Instance | Informa se a instância foi aprovada na verificação de status de instância no último minuto. Essa métrica pode ser `0` (aprovada) ou `1` (reprovada). Por padrão, esta métrica está disponível a uma frequência de um minuto gratuitamente. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | StatusCheckFailed\$1System | Informa se a instância foi aprovada na verificação de status de sistema do &; no último minuto. Essa métrica pode ser `0` (aprovada) ou `1` (reprovada). Por padrão, esta métrica está disponível a uma frequência de um minuto gratuitamente. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | | StatusCheckFailed\$1AttachedEBS | Informa se a instância foi aprovada na verificação de status do EBS anexado no último minuto. Essa métrica pode ser `0` (aprovada) ou `1` (reprovada). Por padrão, esta métrica está disponível a uma frequência de um minuto gratuitamente. | Count | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | O namespace `AWS/EBS` inclui a métrica de verificação de status apresentada a seguir. | Métrica | Descrição | Unidade | Estatísticas significativas | | --- | --- | --- | --- | | VolumeStalledIOCheck | **Observação: **somente para instâncias do Nitro. Não publicado para volumes anexados ao Amazon ECS e tarefas do AWS Fargate. Informa se um volume foi aprovado ou reprovado em uma *verificação de E/S paralisada* no último minuto. Essa métrica pode ser `0` (aprovada) ou `1` (reprovada). | Nenhum | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) | ## Métricas de espelhamento de tráfego O namespace `AWS/EC2` inclui métricas para tráfego espelhado. Para obter mais informações, consulte [Monitorar o tráfego espelhado usando o Amazon CloudWatch](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirror-cloudwatch.html) no *Guia do Amazon VPC Traffic Mirroring*. ## Métricas do grupo do Auto Scaling O namespace `AWS/AutoScaling` inclui métricas para grupos do Auto Scaling. Para obter mais informações, consulte [Monitorar métricas do CloudWatch para grupos do Auto Scaling e instâncias](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html) no *Guia do usuário do Amazon EC2 Auto Scaling*. ## Dimensões de métrica do Amazon EC2 É possível usar as seguintes dimensões para refinar as métricas listadas nas tabelas anteriores. | Dimensão | Descrição | | --- | --- | | AutoScalingGroupName | Essa dimensão filtra os dados solicitados para todas as instâncias em um grupo de capacidade especificado. Um *Grupo de Auto Scaling* é uma coleção de instâncias que você define se estiver usando o Auto Scaling. Essa dimensão está disponível somente para métricas do Amazon EC2 quando as instâncias estão em um grupo de Auto Scaling. Disponível para instâncias com monitoramento básico ou detalhado habilitado. | | ImageId | Essa dimensão filtra os dados que você solicita para todas as instâncias executando essa Imagem de máquina da Amazon (AMI) do Amazon EC2. Disponível para instâncias com monitoramento detalhado habilitado. | | InstanceId | Essa dimensão filtra os dados que você solicita somente para a instância identificada. Isso ajuda você a identificar uma instância exata para monitorar os dados. | | InstanceType | Essa dimensão filtra os dados que você solicita para todas as instâncias executando esse tipo de instância especificado. Isso ajuda você a categorizar seus dados pelo tipo de instância em execução. Por exemplo, é possível comparar dados de uma instância m1.small e uma instância m1.large para determinar qual delas tem o melhor valor comercial para sua aplicação. Disponível para instâncias com monitoramento detalhado habilitado. | ## Métricas de uso do Amazon EC2 É possível usar métricas de uso do CloudWatch para fornecer visibilidade sobre o uso de recursos de sua conta. Use essas métricas para visualizar o uso do serviço atual nos gráficos e painéis do CloudWatch. As métricas de uso do Amazon EC2 correspondem às Service Quotas da AWS. Também é possível configurar alarmes que alertem você quando o uso se aproximar de uma cota de serviço. Para obter mais informações sobre a integração do CloudWatch com o Service Quotas, consulte [Métricas de uso da AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html) no *Guia do usuário do Amazon CloudWatch*. O Amazon EC2 publica as seguintes métricas no namespace `AWS/Usage`. | Métrica | Descrição | | --- | --- | | `ResourceCount` | O número dos recursos especificados em execução em sua conta. Os recursos são definidos pelas dimensões associadas à métrica. A estatística mais útil para essa métrica é `MAXIMUM`, que representa o número máximo de recursos usados durante o período de um minuto. | As dimensões a seguir são usadas para refinar as métricas de uso publicadas pelo Amazon EC2. | Dimensão | Descrição | | --- | --- | | Service | O nome do serviço da AWS que contém o recurso. Para as métricas de uso do Amazon EC2, o valor dessa dimensão é `EC2`. | | Type | O tipo de entidade que está sendo relatado. Atualmente, o único valor válido para métricas de uso do Amazon EC2 é `Resource`. | | Resource | O tipo de recurso que está em execução. Atualmente, o único valor válido para métricas de uso do Amazon EC2 é `vCPU`, que retorna informações sobre as instâncias em execução. | | Class | A classe do recurso que está sendo acompanhado. Para as métricas de uso do Amazon EC2 com `vCPU` como o valor da dimensão `Resource`, os valores válidos são `Standard/OnDemand`, `F/OnDemand`, `G/OnDemand`, `Inf/OnDemand`, `P/OnDemand` e `X/OnDemand`. Os valores dessa dimensão definem a primeira letra dos tipos de instância relatados pela métrica. Por exemplo, `Standard/OnDemand` retorna informações sobre todas as instâncias em execução com tipos que começam com A, C, D, H, I, M, R, T e Z, e `G/OnDemand` retorna informações sobre todas as instâncias em execução com tipos que começam com G. | # Instale e configure o agente do CloudWatch usando o console do Amazon EC2 para adicionar métricas adicionais | | | --- | | A instalação e configuração do agente do CloudWatch usando o console do Amazon EC2 está em versão beta para o Amazon EC2 e está sujeita a alterações. | Por padrão, o Amazon CloudWatch fornece métricas básicas, como `CPUUtilization` e `NetworkIn`, para monitorar suas instâncias do Amazon EC2. Para coletar métricas adicionais, você pode instalar o agente do CloudWatch nas suas instâncias do EC2 e, em seguida, configurar o agente para emitir métricas selecionadas. Em vez de instalar e configurar manualmente o agente do CloudWatch em cada instância do EC2, você pode usar o console do Amazon EC2 para fazer isso por você. É possível usar o console do Amazon EC2 para instalar o agente do CloudWatch nas instâncias e configurar esse agente para emitir métricas selecionadas. Como alternativa, para concluir esse processo manualmente, consulte [Instalação do atendente do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html) no *Guia do usuário do Amazon CloudWatch*. Para obter mais informações sobre o agente do CloudWatch, consulte [Coleta de métricas, logs e rastreamentos usando o agente do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html). **Topics** + [Pré-requisitos](#install-and-configure-cw-agent-prerequisites) + [Como funciona](#install-and-configure-cw-agent-how-it-works) + [Custos](#install-and-configure-cw-agent-costs) + [Baixar e configurar o atendente do CloudWatch](#install-and-configure-cw-agent-procedure) ## Pré-requisitos Para usar o Amazon EC2 para instalar e configurar o agente do CloudWatch, é necessário atender aos pré-requisitos de usuário e instância descritos nesta seção. **dica** Este recurso ainda não está disponível em todos os Regiões da AWS. Se o item de menu descrito no procedimento de instalação desta página não existir no console do Amazon EC2 e você tiver flexibilidade em relação a onde suas instâncias são executadas, tente outra região. Do contrário, você pode usar as instruções manuais do *Guia do usuário do Amazon CloudWatch* para instalar e configurar o agente. **Pré-requisitos da conta** Para usar esse recurso, o usuário ou perfil do console do IAM deve ter as permissões necessárias para usar o Amazon EC2 e as seguintes permissões do IAM: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ssm:GetParameter", "ssm:PutParameter" ], "Resource": "arn:aws:ssm:*:*:parameter/EC2-Custom-Metrics-*" }, { "Effect": "Allow", "Action": [ "ssm:SendCommand", "ssm:ListCommandInvocations", "ssm:DescribeInstanceInformation" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "iam:GetInstanceProfile", "iam:SimulatePrincipalPolicy" ], "Resource": "*" } ] } ``` ------ **Pré-requisitos da instância** + Estado da instância: `running` + Sistema operacional com suporte: Linux + AWS Systems Manager Agent (SSM Agent): Instalado. Duas notas sobre o SSM Agent: + O SSM Agent está pré-instalado em algumas imagens de máquina da Amazon (AMIs) fornecidas por terceiros confiáveis AWS. Para obter informações sobre as AMIs com suporte e as instruções para instalar o SSM Agent, consulte [Imagens de máquina da Amazon (AMIs) com o SSM Agent pré-instalado](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html), no *Guia do usuário do AWS Systems Manager*. + Se tiver problemas com o SSM Agent, consulte [Solução de problemas com o SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-ssm-agent.html), no *Guia do usuário do AWS Systems Manager*. + Permissões do IAM para a instância: as seguintes políticas AWS gerenciadas devem ser adicionadas ao perfil do IAM anexado à instância: + [AmazonSSMManagedInstanceCore](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonSSMManagedInstanceCore.html): permite que uma instância use o Systems Manager para instalar e configurar o agente do CloudWatch. + [CloudWatchAgentServerPolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchAgentServerPolicy.html): permite que uma instância use o agente do CloudWatch para gravar dados no CloudWatch. Para obter informações sobre como adicionar permissões do IAM à sua instância, consulte [Usar perfis de instância](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) no *Guia do usuário do IAM*. ## Como funciona Antes de usar o console do Amazon EC2 para instalar e configurar o agente do CloudWatch, você deve se certificar de que seu usuário ou perfil do IAM e as instâncias nas quais você deseja adicionar métricas atendam a determinados pré-requisitos. Em seguida, você pode usar o console do Amazon EC2 para instalar e configurar o agente do CloudWatch nas instâncias selecionadas. **Primeiro, atenda aos [pré-requisitos](#install-and-configure-cw-agent-prerequisites)** + **Você precisa das permissões do IAM necessárias**: antes de começar, certifique-se de que seu usuário ou perfil do console tenha as permissões do IAM necessárias para usar esse recurso. + **Instâncias**: para usar o recurso, suas instâncias do EC2 devem ser instâncias Linux, ter o SSM Agent instalado, ter as permissões do IAM necessárias e estar em execução. **Em seguida, será possível [usar o recurso](#install-and-configure-cw-agent-procedure)** 1. **Selecione suas instâncias**: no console do Amazon EC2, você seleciona as instâncias nas quais instalar e configurar o agente do CloudWatch. Em seguida, inicia o processo escolhendo **Configurar agente do CloudWatch**. 1. **Validar o SSM Agent**: o Amazon EC2 verifica se o SSM Agent está instalado e iniciado em cada instância. Todas as instâncias que falharem nessa verificação serão excluídas do processo. O SSM Agent é usado para realizar ações na instância durante esse processo. 1. **Valide as permissões do IAM**: o Amazon EC2 verifica se cada instância tem as permissões do IAM necessárias para esse processo. Todas as instâncias que falharem nessa verificação serão excluídas do processo. As permissões do IAM permitem que o agente do CloudWatch colete métricas da instância e se integre ao AWS Systems Manager para usar o SSM Agent. 1. **Validar o agente do CloudWatch**: o Amazon EC2 verifica se o agente do CloudWatch está instalado e em execução em cada instância. Se alguma instância falhar nessa verificação, o Amazon EC2 oferecerá a instalação e a inicialização do agente do CloudWatch para você. O agente do CloudWatch coletará as métricas selecionadas em cada instância quando esse processo for concluído. 1. **Selecionar a configuração de métricas**: você seleciona as métricas que o agente do CloudWatch emitirá de suas instâncias. Depois de selecionado, o Amazon EC2 armazena um arquivo de configuração no Parameter Store, onde permanece até que o processo seja concluído. O Amazon EC2 excluirá o arquivo de configuração do Parameter Store, a menos que o processo seja interrompido. Observe que, se você não selecionar uma métrica, mas a tiver adicionado anteriormente à sua instância, ela será removida da sua instância quando esse processo for concluído. 1. **Atualizar a configuração do agente do CloudWatch**: o Amazon EC2 envia a configuração da métrica para o agente do CloudWatch. Essa é a última etapa do processo. Se for bem-sucedida, suas instâncias poderão emitir dados para as métricas selecionadas, e o Amazon EC2 excluirá o arquivo de configuração do Parameter Store. ## Custos As métricas adicionais acrescentadas durante esse processo são cobradas como métricas personalizadas. Para obter mais informações sobre o preço de métricas do CloudWatch, consulte [Preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). ## Baixar e configurar o atendente do CloudWatch É possível usar o console do Amazon EC2 para instalar e configurar o agente do CloudWatch para adicionar métricas adicionais. **nota** Todas as vezes que você executa esse procedimento, você substitui a configuração existente do agente do CloudWatch. Se você não selecionar uma métrica que tenha sido selecionada anteriormente, ela será removida da instância. **Para instalar e configurar o agente do CloudWatch usando o console do Amazon EC2** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione as instâncias nas quais instalar e configurar o agente do CloudWatch. 1. Escolha **Ações**, **Monitorar e solucionar problemas**, **Configurar agente do CloudWatch**. 1. Para cada etapa do processo, leia o texto do console e escolha **Avançar**. 1. Para concluir o processo, na etapa final, escolha **Concluir**. **Para atualizar a configuração do agente criada pelo console do Amazon EC2** É possível personalizar manualmente a configuração criada pelo console do EC2. Para obter mais informações, consulte [Criar ou editar manualmente o arquivo de configuração do atendente do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html) no *Guia do usuário do Amazon CloudWatch*. # Estatísticas para as métricas do CloudWatch para as instâncias É possível obter estatísticas para as métricas do CloudWatch para suas instâncias. *Estatísticas* são agregações de dados de métrica ao longo de períodos especificados. O CloudWatch fornece estatísticas com base nos pontos de dados de métrica fornecidos por seus dados personalizados ou por outros serviços na AWS para o CloudWatch. As agregações são feitas usando o namespace, o nome da métrica, as dimensões e a unidade de medida do ponto de dados no período especificado. A tabela a seguir descreve as estatísticas disponíveis. | Estatística | Descrição | | --- | --- | | Minimum | O valor mais baixo observado durante o período especificado. É possível usar esse valor para determinar baixos volumes de atividade para a sua aplicação | | Maximum | O valor mais alto observado durante o período especificado. É possível usar esse valor para determinar altos volumes de atividade para a sua aplicação. | | Sum | Todos os valores enviados para a métrica correspondente, somados. Essa estatística pode ser útil para determinar o volume total de uma métrica. | | Average | O valor de `Sum` / `SampleCount` durante o período especificado. Ao comparar essa estatística com o `Minimum` e o `Maximum`, é possível determinar o escopo completo de uma métrica e a proximidade da média de uso com o `Minimum` e o `Maximum`. Essa comparação ajuda você a saber quando aumentar ou diminuir seus recursos conforme necessário. | | SampleCount | A contagem (número) de pontos de dados usados para o cálculo estatístico. | | pNN.NN | O valor do percentil especificado. É possível especificar qualquer percentil usando até duas casas decimais (por exemplo, p95.45). | **Topics** + [Obter estatísticas para uma instância específica](US_SingleMetricPerInstance.md) + [Agregar estatísticas entre instâncias](GetSingleMetricAllDimensions.md) + [Agregar estatísticas por grupo de Auto Scaling](GetMetricAutoScalingGroup.md) + [Agregar estatísticas por AMI](US_SingleMetricPerAMI.md) # Obter estatísticas para uma instância específica É possível usar o Console de gerenciamento da AWS ou a AWS CLI para obter estatísticas para uma instância específica. Os exemplos a seguir mostram como usar o Console de gerenciamento da AWS ou a AWS CLI para determinar a utilização horária de CPU de uma instância do EC2 específica. **Requisitos** + É necessário ter o ID da instância. É possível obter o ID da instância usando o Console de gerenciamento da AWS ou o comando [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html). + Por padrão, o monitoramento básico é ativado, mas é possível habilitar o monitoramento detalhado. Para obter mais informações, consulte [Gerenciar o monitoramento detalhado das instâncias do Amazon EC2](manage-detailed-monitoring.md). **Para exibir a utilização de CPU para uma instância específica (console)** 1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. No painel de navegação, selecione **Metrics** (Métricas). 1. Escolha o namespace de métricas do **EC2**. 1. Escolha a dimensão **Per-Instance Metrics (Métricas por instância)**. 1. No campo de pesquisa, digite **CPUUtilization** e pressione Enter. Escolha a linha da instância específica, que exibe um gráfico da métrica **CPUUtilization** para a instância. Para dar nome a um gráfico, selecione o ícone do lápis. Para alterar o período, selecione um dos valores predefinidos ou escolha **custom (personalizado)**. ![\[Criar um gráfico de uma métrica\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/metric_statistics_ec2_instance.png) 1. Para alterar a estatística ou o período da métrica, selecione a guia **Graphed metrics (Métricas em gráfico)**. Escolha o cabeçalho de coluna ou um valor individual e, em seguida, escolha um valor diferente. ![\[Alterar a estatística ou o período para uma métrica\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/metric_statistics_ec2_instance_statistic_period.png) **Para obter a utilização de CPU para uma instância específica (AWS CLI)** Use o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) para obter a métrica **CPUUtilization** da instância específica usando o período e o intervalo de tempo especificados: ``` aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name CPUUtilization --period 3600 \ --statistics Maximum --dimensions Name=InstanceId,Value=i-1234567890abcdef0 \ --start-time 2022-10-18T23:18:00 --end-time 2022-10-19T23:18:00 ``` A seguir está um exemplo de saída. Cada valor representa a porcentagem máxima de utilização da CPU para uma única instância do EC2. ``` { "Datapoints": [ { "Timestamp": "2022-10-19T00:18:00Z", "Maximum": 0.33000000000000002, "Unit": "Percent" }, { "Timestamp": "2022-10-19T03:18:00Z", "Maximum": 99.670000000000002, "Unit": "Percent" }, { "Timestamp": "2022-10-19T07:18:00Z", "Maximum": 0.34000000000000002, "Unit": "Percent" }, { "Timestamp": "2022-10-19T12:18:00Z", "Maximum": 0.34000000000000002, "Unit": "Percent" } ], "Label": "CPUUtilization" } ``` # Agregar estatísticas entre instâncias Estatísticas agregadas estão disponíveis para as instâncias que têm o monitoramento detalhado habilitado. As instâncias que usam o monitoramento básico não estão incluídas nos agregados. Antes que seja possível obter estatísticas agregadas em todas as instâncias, é necessário [habilitar o monitoramento detalhado](manage-detailed-monitoring.md#enable-detailed-monitoring) (a uma cobrança adicional), que fornece dados em períodos de um minuto. O Amazon CloudWatch não pode agregar dados entre regiões da AWS. As métricas são completamente separadas entre regiões. Este exemplo mostra a você como usar o monitoramento detalhado para obter uso médio de CPU para suas instâncias do EC2. Como nenhuma dimensão é especificada, o CloudWatch retorna estatísticas para todas as dimensões no namespace `AWS/EC2`. **Importante** Essa técnica para recuperar todas as dimensões em um namespace da AWS não funciona para namespaces personalizados que você publicar no Amazon CloudWatch. Com namespaces personalizados, especifique o conjunto completo de dimensões associadas a um determinado ponto de dados para recuperar estatísticas que incluam o ponto de dados. **Para exibir a utilização média de CPU em suas instâncias (console)** 1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. No painel de navegação, selecione **Metrics** (Métricas). 1. Escolha o namespace **EC2** e escolha **Across All Instances (Em todas as instâncias)**. 1. Escolha a linha que contém **CPUUtilization**, que exibe um gráfico da métrica para todas as instâncias do EC2. Para dar nome a um gráfico, selecione o ícone do lápis. Para alterar o período, selecione um dos valores predefinidos ou escolha **custom (personalizado)**. ![\[Métricas agregadas entre suas instâncias do EC2\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/metric_aggregated_instances.png) 1. Para alterar a estatística ou o período da métrica, selecione a guia **Graphed metrics (Métricas em gráfico)**. Escolha o cabeçalho de coluna ou um valor individual e, em seguida, escolha um valor diferente. **Para obter a utilização média de CPU em suas instâncias (AWS CLI)** Use o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) da seguinte forma para obter a média da métrica **CPUUtilization** em todas as suas instâncias. ``` aws cloudwatch get-metric-statistics \ --namespace AWS/EC2 \ --metric-name CPUUtilization \ --period 3600 --statistics "Average" "SampleCount" \ --start-time 2022-10-11T23:18:00 \ --end-time 2022-10-12T23:18:00 ``` A seguir está um exemplo de saída: ``` { "Datapoints": [ { "SampleCount": 238.0, "Timestamp": "2022-10-12T07:18:00Z", "Average": 0.038235294117647062, "Unit": "Percent" }, { "SampleCount": 240.0, "Timestamp": "2022-10-12T09:18:00Z", "Average": 0.16670833333333332, "Unit": "Percent" }, { "SampleCount": 238.0, "Timestamp": "2022-10-11T23:18:00Z", "Average": 0.041596638655462197, "Unit": "Percent" } ], "Label": "CPUUtilization" } ``` # Agregar estatísticas por grupo de Auto Scaling É possível agregar estatísticas para as instâncias do EC2 em um grupo do Auto Scaling. O Amazon CloudWatch não pode agregar dados entre regiões da AWS. As métricas são completamente separadas entre regiões. Este exemplo mostra como recuperar o total de bytes gravados em disco para um grupo do Auto Scaling. O total é calculado para períodos de 1 minuto para um intervalo de 24 horas em todas as instâncias do EC2 no grupo do Auto Scaling especificado. **Para exibir DiskWriteBytes para as instâncias em um grupo do Auto Scaling (console)** 1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. No painel de navegação, selecione **Metrics** (Métricas). 1. Escolha o namespace **EC2** e escolha **By Auto Scaling Group (Por grupo de Auto Scaling)**. 1. Escolha a linha da métrica **DiskWriteBytes** e o grupo do Auto Scaling específico, que exibe um gráfico da métrica para as instâncias no grupo do Auto Scaling. Para dar nome a um gráfico, selecione o ícone do lápis. Para alterar o período, selecione um dos valores predefinidos ou escolha **custom (personalizado)**. 1. Para alterar a estatística ou o período da métrica, selecione a guia **Graphed metrics (Métricas em gráfico)**. Escolha o cabeçalho de coluna ou um valor individual e, em seguida, escolha um valor diferente. **Para exibir DiskWriteBytes para as instâncias em um grupo do Auto Scaling (AWS CLI)** Use o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) da seguinte forma. ``` aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name DiskWriteBytes --period 360 \ --statistics "Sum" "SampleCount" --dimensions Name=AutoScalingGroupName,Value=my-asg --start-time 2022-10-16T23:18:00 --end-time 2022-10-18T23:18:00 ``` A seguir está um exemplo de saída: ``` { "Datapoints": [ { "SampleCount": 18.0, "Timestamp": "2022-10-19T21:36:00Z", "Sum": 0.0, "Unit": "Bytes" }, { "SampleCount": 5.0, "Timestamp": "2022-10-19T21:42:00Z", "Sum": 0.0, "Unit": "Bytes" } ], "Label": "DiskWriteBytes" } ``` # Agregar estatísticas por AMI É possível agregar estatísticas pela AMI para as instâncias com monitoramento detalhado habilitado. As instâncias que usam o monitoramento básico não estão incluídas nos agregados. Antes que seja possível obter estatísticas agregadas em todas as instâncias, é necessário [habilitar o monitoramento detalhado](manage-detailed-monitoring.md#enable-detailed-monitoring) (a uma cobrança adicional), que fornece dados em períodos de um minuto. O Amazon CloudWatch não pode agregar dados entre regiões da AWS. As métricas são completamente separadas entre regiões. Este exemplo mostra como determinar a utilização média da CPU para todas as instâncias que usam uma imagem de máquina da Amazon (AMI) específica. A média é intervalos de mais de 60 segundos para um período de um dia. **Para exibir a utilização média de CPU por AMI (console)** 1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. No painel de navegação, selecione **Metrics** (Métricas). 1. Escolha o namespace **EC2** e escolha **By Image (AMI) Id (Por ID de imagem (AMI))**. 1. Escolha a linha da métrica **CPUUtilization** e a AMI específica, que exibe um gráfico da métrica para a AMI especificada. Para dar nome a um gráfico, selecione o ícone do lápis. Para alterar o período, selecione um dos valores predefinidos ou escolha **custom (personalizado)**. 1. Para alterar a estatística ou o período da métrica, selecione a guia **Graphed metrics (Métricas em gráfico)**. Escolha o cabeçalho de coluna ou um valor individual e, em seguida, escolha um valor diferente. **Para obter utilização média de CPU para um ID de imagem (AWS CLI)** Use o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) da seguinte forma. ``` aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name CPUUtilization --period 3600 \ --statistics Average --dimensions Name=ImageId,Value=ami-3c47a355 --start-time 2022-10-10T00:00:00 --end-time 2022-10-11T00:00:00 ``` A seguir está um exemplo de saída. Cada valor representa uma porcentagem de utilização média da CPU para as instâncias do EC2 que executam a AMI especificada. ``` { "Datapoints": [ { "Timestamp": "2022-10-10T07:00:00Z", "Average": 0.041000000000000009, "Unit": "Percent" }, { "Timestamp": "2022-10-10T14:00:00Z", "Average": 0.079579831932773085, "Unit": "Percent" }, { "Timestamp": "2022-10-10T06:00:00Z", "Average": 0.036000000000000011, "Unit": "Percent" } ], "Label": "CPUUtilization" } ``` # Exibir os grafos de monitoramento para as instâncias Depois que executar uma instância, é possível abrir o console do Amazon EC2 e ver os gráficos de monitoramento para a instância na guia **Monitoring** (Monitoramento). Cada gráfico se baseia em uma das métricas disponíveis do Amazon EC2. Os gráficos a seguir estão disponíveis: + Utilização média da CPU (porcentagem) + Leituras médias do disco (bytes) + Gravações médias em disco (bytes) + Rede máxima dentro (bytes) + Rede máxima fora (bytes) + Operações de leitura de disco de resumo (contagem) + Operações de gravação de disco de resumo (contagem) + Status de resumo (qualquer) + Instância do status de resumo (contagem) + Sistema de status de resumo (contagem) Para mais informações sobre as métricas e os dados que elas fornecem aos gráficos, consulte [As métricas do CloudWatch que estão disponíveis para as instâncias](viewing_metrics_with_cloudwatch.md). **Represente graficamente métricas usando o console CloudWatch** Também é possível usar o console do CloudWatch para representar graficamente os dados gerados pelo Amazon EC2 e outros serviços da AWS. Para obter mais informações, consulte [Representação gráfica de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) no *Guia do usuário do Amazon CloudWatch*. # Criar um alarme do CloudWatch para uma instância É possível criar um alarme do CloudWatch que monitore métricas do CloudWatch de uma de suas instâncias. O CloudWatch enviará automaticamente para você uma notificação quando a métrica atingir um limite especificado. É possível criar um alarme do CloudWatch usando o console do Amazon EC2 ou usar as opções mais avançadas fornecidas pelo console do CloudWatch. **Para criar um alarme usando o console do CloudWatch** Para ver exemplos, consulte [Criação de alarmes do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) no *Guia do usuário do Amazon CloudWatch*. **Para criar um alarme usando o console do Amazon EC2** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione a instância e escolha **Actions (Ações)**, **Monitor and troubleshoot (Monitorar e solucionar problemas)**, **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**. 1. Na página de detalhes **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**, em **Add or edit alarm (Adicionar ou editar alarme)**, selecione **Create an alarm (Criar alarme)**. 1. Em **Notificação de alarme**, escolha se deseja configurar as notificações do Amazon Simple Notification Service (Amazon SNS). Insira um tópico de Amazon SNS existente ou insira um nome para criar um tópico. 1. Em **Ação do alarme**, selecione se deseja especificar uma ação a ser feita quando o alarme for acionado. Escolha uma ação na lista. 1. Em **Alarm thresholds (Limites de alarme)**, selecione a métrica e os critérios do alarme. Por exemplo, para criar um alarme que é acionado quando a utilização da CPU atinge 80% por um período de 5 minutos, faça o seguinte: 1. Mantenha as configurações padrão para **Agrupar amostras por** (**Média**) e **Tipo de dados a amostrar** (**Utilização da CPU**). 1. Escolha **>=** para **Alarme quando** e insira **0.80** em **Por cento**. 1. Insira **1** em **Período consecutivo** e selecione **5 minutos** em **Período**. 1. (Opcional) Em **Sample metric data (Dados de métrica de exemplo)**, escolha **Add to dashboard (Adicionar ao painel)**. 1. Escolha **Criar**. É possível editar suas configurações de alarme do CloudWatch no console do Amazon EC2 ou no console do CloudWatch. Se você quiser excluir seu alarme, poderá fazê-lo a partir no console do CloudWatch. Para obter mais informações, consulte [Editar ou excluir um alarme do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Manage-CloudWatch-Alarm.html#Edit-CloudWatch-Alarm) no *Guia do usuário do Amazon CloudWatch*. # Criar alarmes para interromper, encerrar, reinicializar ou recuperar uma instância Usando as ações de alarme do Amazon CloudWatch, você cria alarmes que automaticamente param, encerram, reinicializam ou recuperam suas instâncias. É possível usar as ações de parada ou encerramento para ajudar a economizar dinheiro quando não precisar mais que uma instância seja executada. É possível usar as ações de reinicialização e recuperação para reinicializar automaticamente essas instâncias ou recuperá-las para um novo hardware caso ocorra um problema no sistema. **nota** Para saber mais sobre alarmes de faturamento e custos do Amazon CloudWatch, consulte [Faturamento e custos do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_billing.html) no *Guia do usuário do Amazon CloudWatch*. A função `AWSServiceRoleForCloudWatchEvents` ligado ao serviço permite que a AWS execute ações de alarme em seu nome. A primeira vez que você criar um alarme no Console de gerenciamento da AWS, na AWS CLI ou na API do IAM, o CloudWatch cria o perfil vinculado ao serviço para você. Há várias situações nas quais é possível querer interromper ou encerrar sua instância automaticamente. Por exemplo, é possível ter instâncias dedicadas a trabalhos de processamento de folha de pagamento em lote ou tarefas de computação científica que são executadas por um período e, em seguida, concluem seu trabalho. Em vez de permitir que essas instâncias fiquem ociosas (e acumulem cobranças), é possível interrompê-las ou encerrá-las, o que pode ajudá-lo a fazer uma economia. A principal diferença entre usar as ações de alarme de interrupção e encerramento é que é possível facilmente iniciar uma instância interrompida se precisar executá-la novamente mais tarde e manter o mesmo ID de instância e volume do dispositivo raiz. No entanto, não é possível iniciar uma instância encerrada. Em vez disso, é necessário executar uma nova instância. Quando uma instância é interrompida ou encerrada, os dados nos volumes de armazenamento da instância são perdidos. É possível adicionar as ações de interrupção, encerramento, reinicialização ou recuperação a qualquer alarme definido em uma métrica por instância do Amazon EC2, incluindo métricas de monitoramento básico e detalhado fornecidas pelo Amazon CloudWatch (no namespace `AWS/EC2`), bem como todas as métricas personalizadas que incluem a dimensão `InstanceId`, desde que seu valor se refira a uma instância do Amazon EC2 em execução. **Importante** Os alarmes de verificação de status podem entrar temporariamente no estado `INSUFFICIENT_DATA` se faltarem pontos de dados de métricas. Embora raro, isso pode acontecer quando há uma interrupção nos sistemas de relatórios de métricas, mesmo quando uma instância está íntegra. Recomendamos que você trate o estado `INSUFFICIENT_DATA` como dados ausentes em vez de uma violação de alarme, especialmente ao configurar o alarme para parar, encerrar, reinicializar ou recuperar uma instância. **Suporte a consoles** É possível criar alarmes usando o console do Amazon EC2 ou do CloudWatch. Os procedimentos nesta documentação usam o console do Amazon EC2. Para procedimentos que usam o console do CloudWatch, consulte [Criar alarmes que param, encerram, reinicializam ou recuperam uma instância](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/UsingAlarmActions.html) no *Guia do usuário do Amazon CloudWatch*. **Permissões** Você deve ter a permissão `iam:CreateServiceLinkedRole` para criar ou modificar um alarme que executa as ações de alarme do EC2. O perfil de serviço é um [perfil do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que um serviço assume para executar ações em seu nome. Um administrador do IAM pode criar, modificar e excluir um perfil de serviço do IAM. Para saber mais, consulte [Criar um perfil para delegar permissões a um AWS service (Serviço da AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) no *Guia do Usuário do IAM*. **Topics** + [Adicionar ações de interrupção a alarmes do Amazon CloudWatch](#AddingStopActions) + [Adicionar ações de encerramento a alarmes do Amazon CloudWatch](#AddingTerminateActions) + [Adicionar ações de reinicialização a alarmes do Amazon CloudWatch](#AddingRebootActions) + [Adicionar ações de recuperação a alarmes do Amazon CloudWatch](#AddingRecoverActions) + [Cenários de ação do alarme do Amazon CloudWatch](AlarmActionScenarios.md) ## Adicionar ações de interrupção a alarmes do Amazon CloudWatch É possível criar um alarme que pare uma instância do Amazon EC2 quando o limite for atingido. Por exemplo, é possível executar instâncias de desenvolvimento ou teste e ocasionalmente se esquecer de desativá-las. É possível criar um alarme que seja acionado quando o percentual médio de utilização da CPU for inferior a 10% em 24 horas, sinalizando que ela está ociosa e não mais em uso. É possível ajustar o limite, a duração e o período para atender às suas necessidades, além de poder adicionar uma notificação do Amazon Simple Notification Service (Amazon SNS) para receber um e-mail quando o alarme for acionado. As instâncias que usam um volume do Amazon EBS como volume raiz podem ser interrompidas ou encerradas, enquanto instâncias que usam o armazenamento de instância como volume raiz só podem ser encerradas. Os dados nos volumes de armazenamento de instância são perdidos quando a instância é interrompida ou encerrada. **Para criar um alarme para parar uma instância em repouso (console do Amazon EC2)** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione a instância e escolha **Actions (Ações)**, **Monitor and troubleshoot (Monitorar e solucionar problemas)**, **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**. Como alternativa, é possível escolher o sinal de mais ( ![\[Plus sign.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/add-plus.png) ) na coluna **Alarm status (Status do alarme)** . 1. Na página **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**, faça o seguinte: 1. Escolha **Create an alarm (Criar um alarme)**. 1. Para receber um e-mail quando o alarme for acionado, para **Alarm notification (Notificação de alarme)**, escolha um Amazon SNS tópico existente. Para fazer isso, você precisa criar um tópico do Amazon SNS usando o console do Amazon SNS. Para obter mais informações, consulte [Usar o Amazon SNS para mensagens de aplicação para pessoa (A2P)](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*. 1. Alterne em **Ação alarme** e escolha **Parar**. 1. Para **Group samples by (Agrupar amostras por)** e **Type of data to sample (Tipo de dados a serem amostrados)**, escolha uma estatística e uma métrica. Neste exemplo, escolha **Average (Média)** e **CPU utilization (Utilização da CPU)**. 1. Para **Alarm When (Alarme quando)** e **Percent (Percentual)**, especifique o limite da métrica. Neste exemplo, especifique **<=** e **10**%. 1. Para **Consecutive period (Período consecutivo)** e **Period (Período)**, especifique o período de avaliação do alarme. Neste exemplo, especifique **1** período consecutivo de **5 minutos**. 1. Amazon CloudWatch cria automaticamente um nome de alarme para você. Para alterar o nome, em **Alarm name (Nome do alarme)**, insira um novo nome. Os nomes de alarme devem conter somente caracteres ASCII. **nota** É possível ajustar a configuração do alarme com base em suas próprias necessidades antes de criá-lo, ou pode editá-las mais tarde. Aí incluem-se as configurações de métrica, limiar, duração, ação e notificação. No entanto, depois de criar um alarme, você não pode mais editar seu nome. 1. Escolha **Criar**. ## Adicionar ações de encerramento a alarmes do Amazon CloudWatch É possível criar um alarme que encerre uma instância do EC2 automaticamente quando um certo limite for atingido (desde que a proteção contra encerramento não esteja ativada para a instância). Por exemplo, é possível encerrar uma instância quando ela tiver concluído seu trabalho e não precisar mais dela. Se você quiser usar a instância posteriormente, pare-a em vez de encerrá-la. Os dados nos volumes de armazenamento de instância são perdidos quando a instância é encerrada. Para obter informações sobre a habilitação e a desabilitação da proteção contra encerramento de uma instância, consulte [Alterar proteção contra encerramento de instância](Using_ChangingDisableAPITermination.md). **Para criar um alarme para encerrar uma instância em repouso (console do Amazon EC2)** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione a instância e escolha **Actions (Ações)**, **Monitor and troubleshoot (Monitorar e solucionar problemas)**, **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**. Como alternativa, é possível escolher o sinal de mais ( ![\[Plus sign.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/add-plus.png) ) na coluna **Alarm status (Status do alarme)** . 1. Na página **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**, faça o seguinte: 1. Escolha **Create an alarm (Criar um alarme)**. 1. Para receber um e-mail quando o alarme for acionado, para **Alarm notification (Notificação de alarme)**, escolha um Amazon SNS tópico existente. Para fazer isso, você precisa criar um tópico do Amazon SNS usando o console do Amazon SNS. Para obter mais informações, consulte [Usar o Amazon SNS para mensagens de aplicação para pessoa (A2P)](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*. 1. Alterne em **Ação alarme** e escolha **Encerrar**. 1. Para **Group samples by (Agrupar amostras por)** e **Type of data to sample (Tipo de dados a serem amostrados)**, escolha uma estatística e uma métrica. Neste exemplo, escolha **Average (Média)** e **CPU utilization (Utilização da CPU)**. 1. Para **Alarm When (Alarme quando)** e **Percent (Percentual)**, especifique o limite da métrica. Neste exemplo, especifique **=>** e **10** por cento. 1. Para **Consecutive period (Período consecutivo)** e **Period (Período)**, especifique o período de avaliação do alarme. Neste exemplo, especifique **24** períodos consecutivos de **1 hora**. 1. Amazon CloudWatch cria automaticamente um nome de alarme para você. Para alterar o nome, em **Alarm name (Nome do alarme)**, insira um novo nome. Os nomes de alarme devem conter somente caracteres ASCII. **nota** É possível ajustar a configuração do alarme com base em suas próprias necessidades antes de criá-lo, ou pode editá-las mais tarde. Aí incluem-se as configurações de métrica, limiar, duração, ação e notificação. No entanto, depois de criar um alarme, você não pode mais editar seu nome. 1. Escolha **Criar**. ## Adicionar ações de reinicialização a alarmes do Amazon CloudWatch É possível criar um alarme do Amazon CloudWatch que monitore uma instância do Amazon EC2 e reinicialize automaticamente a instância. A ação de alarme de reinicialização é recomendada para falhas de verificação de integridade da instância (ao contrário da ação de alarme de recuperação, que é adequado para falhas de verificação de integridade do sistema). Reinicializar a instância equivale a reinicializar o sistema operacional. Na maioria dos casos, leva apenas alguns minutos para reinicializar sua instância. Quando você reinicializa uma instância, ela permanece no mesmo host físico, para que sua instância mantenha seu nome DNS público, o endereço IP privado e os dados em seus volumes de armazenamento de instância. A reinicialização de uma instância não inicia uma nova hora de faturamento de instância (com uma cobrança mínima de um minuto), diferente do que acontece na interrupção e na reinicialização da instância. Os dados nos volumes de armazenamento de instância são retidos quando a instância é reinicializada. Os volumes de armazenamento de instâncias devem ser remontados no sistema de arquivos após uma reinicialização. Para obter mais informações, consulte [Reinicializar uma instância do Amazon EC2](ec2-instance-reboot.md). **Importante** Para evitar um comportamento de disputa entre as ações de reinicialização e recuperação, evite configurar o mesmo número de períodos de avaliação para um alarme de reinicialização e um alarme de recuperação. Recomendamos que você defina alarmes de reinicialização para três períodos de avaliação de um minuto cada. Para obter mais informações, consulte [Avaliar um alarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarm-evaluation) no *Guia do usuário do Amazon CloudWatch*. **Para criar um alarme para reinicializar uma instância (console do Amazon EC2)** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione a instância e escolha **Actions (Ações)**, **Monitor and troubleshoot (Monitorar e solucionar problemas)**, **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**. Como alternativa, é possível escolher o sinal de mais ( ![\[Plus sign.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/add-plus.png) ) na coluna **Alarm status (Status do alarme)** . 1. Na página **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**, faça o seguinte: 1. Escolha **Create an alarm (Criar um alarme)**. 1. Para receber um e-mail quando o alarme for acionado, para **Alarm notification (Notificação de alarme)**, escolha um Amazon SNS tópico existente. Para fazer isso, você precisa criar um tópico do Amazon SNS usando o console do Amazon SNS. Para obter mais informações, consulte [Usar o Amazon SNS para mensagens de aplicação para pessoa (A2P)](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*. 1. Alterne em **Ação alarme** e escolha **Reinicializar**. 1. Para **Group samples by (Agrupar amostras por)** e **Type of data to sample (Tipo de dados a serem amostrados)**, escolha uma estatística e uma métrica. Neste exemplo, escolha **Average (Média)** e **Status check failed: instance (Falha na verificação de status: instância)**. 1. Para **Consecutive period (Período consecutivo)** e **Period (Período)**, especifique o período de avaliação do alarme. Nesse exemplo, digite **3** períodos consecutivos de **1 minuto**. Se **1 minuto estiver desabilitado**, você deverá [habilitar o monitoramento detalhado](manage-detailed-monitoring.md#enable-detailed-monitoring) ou escolher **5 minutos**. 1. Amazon CloudWatch cria automaticamente um nome de alarme para você. Para alterar o nome, em **Alarm name (Nome do alarme)**, insira um novo nome. Os nomes de alarme devem conter somente caracteres ASCII. 1. Escolha **Criar**. ## Adicionar ações de recuperação a alarmes do Amazon CloudWatch É possível criar um alarme do Amazon CloudWatch que monitore uma instância do Amazon EC2. Se a instância for invalidada devido a uma falha de hardware subjacente ou a um problema que exija o envolvimento da AWS para corrigi-lo, será possível recuperar a instância automaticamente. Instâncias encerradas não podem ser recuperadas. Uma instância recuperada é idêntica à instância original, incluindo o ID da instância, endereços IP privados, endereços IP elásticos e todos os metadados de instância. O CloudWatch impede que você adicione uma ação de recuperação a um alarme que esteja em uma instância que não oferece suporte a ações de recuperação. Quando o alarme `StatusCheckFailed_System` for acionado e a ação de recuperação for iniciada, você será notificado pelo tópico do Amazon SNS que escolheu ao criar o alarme e a ação de recuperação associada. Durante a recuperação da instância, a instância será migrada durante uma reinicialização da instância e todos os dados na memória serão perdidos. Quando o processo é concluído, as informações serão publicadas no tópico do SNS que você tiver configurado para o alarme. Qualquer pessoa que estiver inscrita neste tópico do SNS receberá uma notificação por e-mail com o status da tentativa de recuperação e instruções adicionais. Você perceberá uma reinicialização de instância na instância recuperada. **nota** A ação de recuperação pode ser usada somente com `StatusCheckFailed_System`, não com `StatusCheckFailed_Instance`. Os problemas a seguir podem causar falha nas verificações de status do sistema: + Perda de conectividade de rede + Perda de energia do sistema + Problemas de software no host físico + Problemas de hardware de host físico que afetam a acessibilidade de rede A ação de recuperação é compatível somente nas instâncias com as características a seguir. Para obter mais informações, consulte [Recuperação automática de instâncias](ec2-instance-recover.md). Se a sua instância tiver um endereço IP público, ela reterá o endereço IP público após a recuperação. **Importante** Para evitar um comportamento de disputa entre as ações de reinicialização e recuperação, evite configurar o mesmo número de períodos de avaliação para um alarme de reinicialização e um alarme de recuperação. É recomendável que você defina os alarmes de recuperação para dois períodos de avaliação de um minuto cada. Para obter mais informações, consulte [Avaliar um alarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarm-evaluation) no *Guia do usuário do Amazon CloudWatch*. **Para criar um alarme para recuperar uma instância (console do Amazon EC2)** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **Instances (Instâncias)**. 1. Selecione a instância e escolha **Actions (Ações)**, **Monitor and troubleshoot (Monitorar e solucionar problemas)**, **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**. Como alternativa, é possível escolher o sinal de mais ( ![\[Plus sign.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/add-plus.png) ) na coluna **Alarm status (Status do alarme)** . 1. Na página **Manage CloudWatch alarms (Gerenciar alarmes do CloudWatch)**, faça o seguinte: 1. Escolha **Create an alarm (Criar um alarme)**. 1. Para receber um e-mail quando o alarme for acionado, para **Alarm notification (Notificação de alarme)**, escolha um Amazon SNS tópico existente. Para fazer isso, você precisa criar um tópico do Amazon SNS usando o console do Amazon SNS. Para obter mais informações, consulte [Usar o Amazon SNS para mensagens de aplicação para pessoa (A2P)](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*. **nota** Os usuários devem se inscrever no tópico do SNS especificado para receber notificações por email quando o alarme for acionado. O Usuário raiz da conta da AWS sempre recebe notificações por e-mail quando ocorrem ações de recuperação automática de instância, mesmo que um tópico do SNS não esteja especificado ou o usuário raiz não esteja inscrito no tópico de SNS especificado. 1. Alterne em **Ação alarme** e escolha **Recuperar**. 1. Para **Group samples by (Agrupar amostras por)** e **Type of data to sample (Tipo de dados a serem amostrados)**, escolha uma estatística e uma métrica. Neste exemplo, escolha **Average (Média)** e **Status check failed: system (Falha na verificação de status: sistema)**. 1. Para **Consecutive period (Período consecutivo)** e **Period (Período)**, especifique o período de avaliação do alarme. Nesse exemplo, digite **2** períodos consecutivos de **1 minuto**. Se **1 minuto estiver desabilitado**, você deverá [habilitar o monitoramento detalhado](manage-detailed-monitoring.md#enable-detailed-monitoring) ou escolher **5 minutos**. 1. Amazon CloudWatch cria automaticamente um nome de alarme para você. Para alterar o nome, em **Alarm name (Nome do alarme)**, insira um novo nome. Os nomes de alarme devem conter somente caracteres ASCII. 1. Escolha **Criar**. # Cenários de ação do alarme do Amazon CloudWatch É possível usar o console do Amazon EC2 para criar as ações de alarme que interrompem ou encerram uma instância do Amazon EC2 quando determinadas circunstâncias são atendidas. Na captura de tela a seguir da página do console onde você define as ações de alarme, nós numeramos as configurações. Nós também numeramos as configurações nos cenários a seguir, para ajudá-lo a criar as ações apropriadas. ![\[Gerenciar página de alarmes do Cloudwatch.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/manage-cloudwatch-alarms.png) ## Cenário 1: interromper instâncias de teste e desenvolvimento ociosas Crie um alarme que interrompa uma instância usada para desenvolvimento ou teste de software quando estiver inativa pelo menos uma hora. | Configuração | Valor | | --- | --- | | 1 | Interromper | | 2 | Máximo | | 3 | Utilização da CPU | | 4 | <= | | 5 | 10% | | 6 | 1 | | 7 | 1 hora | ## Cenário 2: interromper instâncias ociosas Crie um alarme que interrompa uma instância e envie um e-mail quando a instância estiver inativa por 24 horas. | Configuração | Valor | | --- | --- | | 1 | Interromper e enviar e-mail | | 2 | Média | | 3 | Utilização da CPU | | 4 | <= | | 5 | 5% | | 6 | 24 | | 7 | 1 hora | ## Cenário 3: enviar e-mail em servidores Web com tráfego incomumente alto Crie um alarme que envie o e-mail quando uma instância ultrapassar 10 GB de tráfego de rede de saída por dia. | Configuração | Valor | | --- | --- | | 1 | E-mail | | 2 | Soma | | 3 | Saída de rede | | 4 | > | | 5 | 10 GB | | 6 | 24 | | 7 | 1 hora | ## Cenário 4: interromper servidores Web com tráfego incomumente alto Crie um alarme que pare uma instância e envie uma mensagem de texto (SMS) se o tráfego de saída exceder 1 GB por hora. | Configuração | Valor | | --- | --- | | 1 | Parar e enviar SMS | | 2 | Soma | | 3 | Saída de rede | | 4 | > | | 5 | 1 GB | | 6 | 1 | | 7 | 1 hora | ## Cenário 5: Interromper uma instância danificada Crie um alarme que interrompa uma instância em falhe três verificações de status consecutivas (executadas em intervalos de 5 minutos). | Configuração | Valor | | --- | --- | | 1 | Interromper | | 2 | Média | | 3 | Falha na verificação de status: sistema | | 4 | - | | 5 | - | | 6 | 1 | | 7 | 15 minutos | ## Cenário 6: Encerrar instâncias quando os trabalhos de processamento em lote estiverem concluídos Crie um alarme que encerre uma instância que execute trabalhos em lote quando não estiver mais enviando os dados dos resultados. | Configuração | Valor | | --- | --- | | 1 | Encerrar | | 2 | Máximo | | 3 | Saída de rede | | 4 | <= | | 5 | 100,000 bytes | | 6 | 1 | | 7 | 5 minutos | # Automatizar o Amazon EC2 usando o EventBridge Você pode usar o Amazon EventBridge para automatizar seus Serviços da AWS e responder automaticamente a eventos do sistema, como problemas de disponibilidade de aplicações ou alterações de recursos. Os eventos dos serviços da AWS são entregues ao EventBridge quase em tempo real. É possível criar regras para indicar os eventos de seu interesse e quais ações deverão ser executadas quando um evento corresponder a uma regra. Ações que podem ser automaticamente acionadas incluem: + Invocar uma função do AWS Lambda + Invocar o Run Command do Amazon EC2 + Retransmitir o evento para o Amazon Kinesis Data Streams + Ativar máquina de estado do AWS Step Functions + Notificar um tópico do Amazon SNS + Notificar uma fila do Amazon SQS Veja a seguir exemplos de como utilizar o EventBridge com o Amazon EC2: + Ative uma função Lambda sempre que uma instância entrar no estado de execução. + Notifique um tópico do Amazon SNS quando um volume do Amazon EBS for criado ou modificado. + Envie um comando para uma ou mais instâncias do Amazon EC2 usando o Run Command do Amazon EC2 sempre que um evento ocorrer em outro produto da AWS. Para obter mais informações, consulte o [Guia do Usuário do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/). ## Tipos de eventos do Amazon EC2 O Amazon EC2 oferece suporte aos seguintes tipos de evento: + [Alteração do estado da AMI do EC2](monitor-ami-events.md#ami-events) + [Notificação de alteração de estado do EC2 Fast Launch](win-fast-launch-monitor.md#win-monitor-fast-launch-events) + [Erro de frota do EC2](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-config-not-valid) + [Informações de frota do EC2](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-info) + [Alteração da instância da frota do EC2](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-instance-change) + [Alteração da solicitação de instância spot da frota do EC2](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-spot-instance-request-change) + [Alteração do estado da frota do EC2](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-state-change) + [Recomendação de redistribuição de instâncias do EC2](rebalance-recommendations.md#cp-eventbridge) + [Notificação de alteração do estado da instância do EC2](monitoring-instance-state-changes.md) + [Erro na frota spot do EC2](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-config-not-valid) + [Informações sobre a frota spot do EC2](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-info) + [Alteração da instância da frota spot do EC2](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-instance-change) + [Alteração da solicitação de instância spot da frota spot do EC2](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-spot-instance-request-change) + [Alteração do estado da frota spot do EC2](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-state-change) + [Alerta de interrupção da instância spot do EC2](spot-instance-termination-notices.md#ec2-spot-instance-interruption-warning-event) + [Atendimento de solicitação de instância spot do EC2](spot-request-status.md#spot-request-fulfillment-event) + [Notificação de subutilização de ODCR do EC2](cr-eventbridge.md) Para obter informações sobre os tipos de evento compatíveis com o Amazon EBS, consulte [Amazon EventBridge for Amazon EBS](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-cloud-watch-events.html). # Registro em log das chamadas de API do Amazon EC2 usando o AWS CloudTrail A API do Amazon EC2 está integrada ao [AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/), um serviço que fornece um registro das ações realizadas por um usuário, por um perfil ou por um AWS service (Serviço da AWS). O CloudTrail captura todas as chamadas de API do Amazon EC2 como eventos. As chamadas capturadas incluem as chamadas feitas pelo console. Ao usar as informações coletadas pelo CloudTrail, você pode determinar a solicitação que foi feita à API do Amazon EC2, o endereço IP do qual a solicitação foi feita e quando ela foi feita. Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar: + Se a solicitação foi feita com credenciais de usuário raiz ou credenciais de usuário. + Se a solicitação foi feita em nome de um usuário do Centro de Identidade do IAM. + Se a solicitação foi feita com credenciais de segurança temporárias de uma função ou de um usuário federado. + Se a solicitação foi feita por outro AWS service (Serviço da AWS). O CloudTrail está ativo em sua Conta da AWS e você tem acesso automático ao **Histórico de eventos** do CloudTrail. O **Histórico de eventos** do CloudTrail fornece um registro visualizável, pesquisável, baixável e imutável dos últimos 90 dias de eventos de gerenciamento gravados em uma Região da AWS. Para obter mais informações, consulte [Trabalhar com histórico de eventos do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) no *Guia do usuário do AWS CloudTrail*. Não há cobranças do CloudTrail pela visualização do **Histórico de eventos**. Para obter um registro contínuo de eventos em sua Conta da AWS nos últimos 90 dias, crie uma trilha ou um um armazenamento de dados de eventos do [CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html). **Trilhas do CloudTrail** Uma *trilha* permite que o CloudTrail entregue arquivos de log a um bucket do Amazon S3. As trilhas criadas usando o Console de gerenciamento da AWS são de várias regiões. Só é possível criar uma trilha de região única ou de várias regiões usando a AWS CLI. Criar uma trilha de várias regiões é uma prática recomendada, pois você captura atividades em todas as Regiões da AWS da conta. Se você criar uma trilha de região única, poderá visualizar somente os eventos registrados na Região da AWS da trilha. Para obter mais informações sobre trilhas, consulte [Criar uma trilha para a Conta da AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) e [Criar uma trilha para uma organização](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html) no *Guia do usuário do AWS CloudTrail*. Uma cópia dos seus eventos de gerenciamento em andamento pode ser entregue no bucket do Amazon S3 sem nenhum custo via CloudTrail com a criação de uma trilha. No entanto, há cobranças de armazenamento do Amazon S3. Para obter mais informações sobre os preços do CloudTrail, consulte [Preços do AWS CloudTrail](https://aws.amazon.com/cloudtrail/pricing/). Para receber informações sobre a definição de preço do Amazon S3, consulte [Definição de preço do Amazon S3](https://aws.amazon.com/s3/pricing/). **Armazenamentos de dados de eventos do CloudTrail Lake** O *CloudTrail Lake* permite executar consultas baseadas em SQL em seus eventos. O CloudTrail Lake converte eventos existentes em formato JSON baseado em linhas para o formato [Apache ORC](https://orc.apache.org/). O ORC é um formato colunar de armazenamento otimizado para recuperação rápida de dados. Os eventos são agregados em *armazenamentos de dados de eventos*, que são coleções imutáveis de eventos baseados nos critérios selecionados com a aplicação de [seletores de eventos avançados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors). Os seletores que você aplica a um armazenamento de dados de eventos controlam quais eventos persistem e estão disponíveis para você consultar. Para obter mais informações sobre o CloudTrail Lake, consulte [Trabalhar com o AWS CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html), no *Guia do usuário do AWS CloudTrail*. Os armazenamentos de dados de eventos e consultas do CloudTrail Lake incorrem em custos. Ao criar um armazenamento de dados de eventos, você escolhe a [opção de preço](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option) que deseja usar para ele. A opção de preço determina o custo para a ingestão e para o armazenamento de eventos, e o período de retenção padrão e máximo para o armazenamento de dados de eventos. Para obter mais informações sobre os preços do CloudTrail, consulte [Preços do AWS CloudTrail](https://aws.amazon.com/cloudtrail/pricing/). ## Eventos de gerenciamento da API do Amazon EC2 no CloudTrail Os [Eventos de gerenciamento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) fornecem informações sobre operações de gerenciamento executadas em recursos na sua Conta da AWS. Elas também são conhecidas como operações de plano de controle. Por padrão, o CloudTrail registra eventos de gerenciamento em logs. Todas as ações da API do Amazon EC2 são registradas como eventos de gerenciamento. Para ver a lista das ações da API que são registradas no CloudTrail, consulte a [referência de APIs do Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/). Por exemplo, chamadas para as ações [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html), [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html) e [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html) são registradas como eventos de gerenciamento. ## Exemplos de eventos da API do Amazon EC2 Um evento representa uma única solicitação de qualquer origem e inclui informações sobre a operação solicitada, a data e a hora da operação da API, os parâmetros de solicitação etc. Os arquivos de log do CloudTrail não são um rastreamento de pilha ordenada de chamadas de API pública, portanto não são exibidos em uma ordem específica. O arquivo de log a seguir mostra que um usuário encerrou uma instância. ``` { "Records":[ { "eventVersion":"1.03", "userIdentity":{ "type":"Root", "principalId":"123456789012", "arn":"arn:aws:iam::123456789012:root", "accountId":"123456789012", "accessKeyId":"AKIAIOSFODNN7EXAMPLE", "userName":"user" }, "eventTime":"2016-05-20T08:27:45Z", "eventSource":"ec2.amazonaws.com", "eventName":"TerminateInstances", "awsRegion":"us-west-2", "sourceIPAddress":"198.51.100.1", "userAgent":"aws-cli/1.10.10 Python/2.7.9 Windows/7botocore/1.4.1", "requestParameters":{ "instancesSet":{ "items":[{ "instanceId":"i-1a2b3c4d" }] } }, "responseElements":{ "instancesSet":{ "items":[{ "instanceId":"i-1a2b3c4d", "currentState":{ "code":32, "name":"shutting-down" }, "previousState":{ "code":16, "name":"running" } }] } }, "requestID":"be112233-1ba5-4ae0-8e2b-1c302EXAMPLE", "eventID":"6e12345-2a4e-417c-aa78-7594fEXAMPLE", "eventType":"AwsApiCall", "recipientAccountId":"123456789012" } ] } ``` Para obter informações sobre o conteúdo dos registros do CloudTrail, consulte [Conteúdo dos registros do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html) no *Guia do usuário do AWS CloudTrail*. ## Auditar conexões realizadas com o EC2 Instance Connect Você pode usar o AWS CloudTrail para auditar os usuários que se conectam às instâncias por meio do EC2 Instance Connect. **Para auditar a atividade do SSH por meio do EC2 Instance Connect usando o console do AWS CloudTrail** 1. Abra o console do CloudTrail em [https://console.aws.amazon.com/cloudtrail/](https://console.aws.amazon.com/cloudtrail/). 1. Verifique se você está na região correta. 1. No painel de navegação, selecione **Event history (Histórico de eventos)**. 1. Para **Filter (Filtro)**, selecione **Event source (Fonte do evento)**, **ec2-instance-connect.amazonaws.com**. 1. (Opcional) Para **Time range (Intervalo de tempo)**, selecione um intervalo de tempo. 1. Selecione o ícone **Refresh events (Atualizar eventos)**. 1. A página exibe os eventos que correspondem às chamadas de API de [https://docs.aws.amazon.com/ec2-instance-connect/latest/APIReference/API_SendSSHPublicKey.html](https://docs.aws.amazon.com/ec2-instance-connect/latest/APIReference/API_SendSSHPublicKey.html). Expanda um evento usando a seta para visualizar detalhes adicionais, como nome de usuário e chave de acesso da AWS usada para fazer a conexão SSH e o endereço IP de origem. 1. Para exibir todas as informações do evento no formato JSON, selecione **View event (Exibir evento)**. O campo **requestParameters** contém o ID da instância de destino, o nome do usuário do sistema operacional e a chave pública usada para fazer a conexão SSH. ``` { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "ABCDEFGONGNOMOOCB6XYTQEXAMPLE", "arn": "arn:aws:iam::1234567890120:user/IAM-friendly-name", "accountId": "123456789012", "accessKeyId": "ABCDEFGUKZHNAW4OSN2AEXAMPLE", "userName": "IAM-friendly-name", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-09-21T21:37:58Z"} } }, "eventTime": "2018-09-21T21:38:00Z", "eventSource": "ec2-instance-connect.amazonaws.com", "eventName": "SendSSHPublicKey ", "awsRegion": "us-west-2", "sourceIPAddress": "123.456.789.012", "userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60", "requestParameters": { "instanceId": "i-0123456789EXAMPLE", "osUser": "ec2-user", "SSHKey": { "publicKey": "ssh-rsa ABCDEFGHIJKLMNO01234567890EXAMPLE" } }, "responseElements": null, "requestID": "1a2s3d4f-bde6-11e8-a892-f7ec64543add", "eventID": "1a2w3d4r5-a88f-4e28-b3bf-30161f75be34", "eventType": "AwsApiCall", "recipientAccountId": "0987654321" } ``` Se você tiver configurado a conta da AWS para coletar eventos do CloudTrail em um bucket do S3, poderá fazer download e auditar as informações de forma programática. Para obter mais informações, consulte [Obter e visualizar arquivos de log do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/get-and-view-cloudtrail-log-files.html) no *Guia do usuário do AWS CloudTrail*. # Monitorar as aplicações .NET e SQL Server com o CloudWatch Application Insights O CloudWatch Application Insights for .NET e SQL Server ajuda você a monitorar as aplicações .NET e SQL Server que usam instâncias do Amazon EC2 juntamente com outros [recursos de aplicações da AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-what-is.html#appinsights-components). Ele identifica e configura os principais logs de métricas e alarmes na pilha de tecnologia e nos recursos da aplicação (por exemplo, banco de dados Microsoft SQL Server, servidores Web (IIS) e de aplicações, SO, balanceadores de carga e filas). Ele monitora continuamente os logs e as métricas para detectar e correlacionar anomalias e erros. Quando erros e anomalias são detectados, o Application Insights gera eventos que podem ser usados para configurar notificações ou executar ações. Para auxiliar na solução de problemas, ele cria painéis automatizados para os problemas detectados, que incluem anomalias de métricas correlacionadas e erros de log com informações adicionais para indicar a potencial causa do problema. Os painéis automatizados ajudam você a tomar medidas corretivas rápidas para manter suas aplicações íntegras e para evitar o impacto nos usuários finais do sua aplicação. **Informações fornecidas sobre os problemas detectados:** + Um breve resumo do problema + A data e a hora de início do problema + A gravidade do problema: High/Medium/Low (Alta/média/baixa) + O status do problema detectado: In‐progress/Resolved (Em andamento/resolvido) + Insights: insights gerados automaticamente sobre o problema detectado e a possível causa + Feedback sobre os insights: o feedback que você forneceu sobre a utilidade dos insights gerados pelo CloudWatch Application Insights para .NET e SQL Server + Observações relacionadas: uma visão detalhada das anomalias da métrica e dos trechos do erro de logs relevantes relacionados ao problema em vários componentes da aplicação **Feedback** É possível fornecer feedback em relação aos insights gerados automaticamente sobre problemas detectados designando-os como úteis ou não úteis. Seu feedback sobre os insights com o diagnóstico da aplicação (anomalias da métrica e exceções de log) são usados para melhorar a futura detecção de problemas semelhantes. Para obter mais informações, consulte a documentação [CloudWatch Application Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html) (Insights sobre aplicações do CloudWatch) no *Guia do usuário do Amazon CloudWatch*. # Acompanhamento do uso do nível gratuito para o Amazon EC2 Ao criar uma Conta da AWS, é possível começar a usar o Amazon EC2 gratuitamente usando o [nível gratuito da AWS](https://aws.amazon.com/free). Os benefícios do nível gratuito são diferentes para contas criadas antes ou depois de 15 de julho de 2025. Para obter mais informações, consulte [Explore AWS services with AWS Free Tier](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/free-tier.html) no *Guia do usuário do AWS Billing*. ## Benefícios do nível gratuito antes e depois de 15 de julho de 2025 A tabela abaixo compara os benefícios do nível gratuito com base na data de criação da Conta da AWS: | Benefício do nível gratuito | Conta criada antes de 15 de julho de 2025 | Conta criada a partir de 15 de julho de 2025 | | --- | --- | --- | | Tipos de instância marcados como elegíveis para o nível gratuito | `t2.micro`, `t3.micro` | `t3.micro`, `t3.small`, `t4g.micro`, `t4g.small`, `c7i-flex.large`, `m7i-flex.large` | | Tipos de volume do Amazon EBS marcados com Elegíveis ao nível gratuito | `standard`, `st1`, `sc1`, `gp2`, e `gp3` | `standard`, `st1`, `sc1`, `gp2`, e `gp3` | | AMIs marcadas como elegíveis para o nível gratuito | Verifique se há AMIs marcadas como elegíveis para o nível gratuito. | Verifique se há AMIs marcadas como elegíveis para o nível gratuito. | | Limite de uso | Restritos aos limites de uso, após os quais são cobradas tarifas de pagamento conforme o uso. | Receba um crédito de USD 100 pela inscrição e ganhe até USD 100 em créditos adicionais. | | Duração do nível gratuito | Seu nível gratuito dura 12 meses após a data de criação da conta. Durante esse período, se você exceder os limites de uso do nível gratuito, serão cobradas tarifas de pagamento conforme o uso. | O nível gratuito dura seis meses após a data de criação da conta ou quando os créditos acabarem, o que ocorrer primeiro. Você não pode exceder os limites do nível gratuito. | **Para listar os tipos de instância qualificados para o nível gratuito** Use o comando [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) com o filtro `free-tier-eligible`. ``` aws ec2 describe-instance-types \ --filters Name=free-tier-eligible,Values=true \ --query "InstanceTypes[*].[InstanceType]" \ --output text | sort ``` **Para listar as AMIs qualificadas para o nível gratuito** Use o comando [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) com o filtro `free-tier-eligible`. ``` aws ec2 describe-images \ --filters Name=free-tier-eligible,Values=true \ --query "Images[*].[ImageId]" \ --output text | sort ``` ## Rastrear o uso do nível gratuito para contas criadas antes de 15 de julho de 2025 **nota** ***Esta seção se aplica somente aos usuários do nível gratuito que criaram Contas da AWS antes de 15 de julho de 2025. Caso tenha criado sua conta em 15 de julho de 2025 ou após essa data, consulte [Tracking your AWS Free Tier usage](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/tracking-free-tier-usage.html) no Guia do usuário do AWS Billing.*** Caso tenha criado sua conta antes de 15 de julho de 2025, é possível usar o Amazon EC2 sem custos se for cliente da AWS há menos de 12 meses e permanecer dentro dos limites de uso do Nível gratuito da AWS. É importante acompanhar seu uso do nível gratuito para evitar surpresas na cobrança. Se você exceder os limites do nível gratuito, incorrerá nas tarifas padrão para pagamento de acordo com o uso. Para obter mais informações, consulte [Nível gratuito da AWS](https://aws.amazon.com/free/). **nota** Se você for cliente da AWS há mais de 12 meses, não estará mais qualificado para usar o nível gratuito e não verá a caixa **Nível gratuito do EC2**, descrita no procedimento a seguir. **Para acompanhar seu uso do nível gratuito** 1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, escolha **EC2 Dashboard (Painel do EC2)**. 1. Localize a caixa **Nível gratuito do EC2** (no canto superior direito). ![\[A caixa Nível gratuito do EC2 no painel do EC2.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/ec2-free-tier-widget.png) 1. Na caixa **Nível gratuito do EC2**, verifique seu uso do nível gratuito, da seguinte maneira: + Em **Ofertas do nível gratuito do EC2 em uso**, anote os avisos: + **Previsão de fim do mês**: esse é um aviso de que você incorrerá em custos este mês se continuar com seu padrão de uso atual. + **Excede o nível gratuito**: esse é um aviso de que você excedeu os limites do nível gratuito e já está incorrendo em custos. + Em **Uso da oferta (mensal)**, anote seu uso de instâncias do Linux, instâncias do Windows e armazenamento do EBS. A porcentagem indica quanto você usou este mês dos seus limites de nível gratuito. Se estiver em 100%, você incorrerá em custos para continuar a usar. **nota** Essas informações só aparecem depois que você criou uma instância. Porém, as informações de uso não são atualizadas em tempo real; elas são atualizadas três vezes ao dia. 1. Para evitar incorrer em custos adicionais, exclua todos os recursos que estão sendo cobrados agora ou que serão cobrados se você exceder o limite de uso do nível gratuito. + Para obter instruções para excluir a instância, consulte [Encerramento de instâncias do Amazon EC2](terminating-instances.md). + Para verificar se você tem recursos em outras regiões que possam estar gerando custos, na caixa **Nível gratuito do EC2**, escolha **Exibir recursos globais do EC2** para abrir a **Visão global do EC2**. Para obter mais informações, consulte [Visualizar recursos entre regiões usando a Visualização Global da AWS](global-view.md). 1. Para visualizar seu uso dos recursos de todos os Serviços da AWSNível gratuito da AWS, na parte inferior da caixa **Nível gratuito do EC2**, escolha **Exibir todas as ofertas do Nível gratuito da AWS**. Para obter mais informações, consulte [Trying services using Nível gratuito da AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-free-tier.html) no *Guia do usuário de faturamento da AWS*. # Entender os códigos do Amazon EC2 em relatórios de faturamento e uso Quando você utiliza o Amazon EC2, incluímos códigos relacionados nos relatórios de faturamento e uso da AWS. A análise desses códigos ajuda você a entender seus custos e padrões de uso do Amazon EC2. Acompanhar e gerenciar suas despesas é essencial para otimizar custos. As tabelas a seguir descrevem os códigos do Amazon EC2 que aparecem nos relatórios de faturamento e uso. Para obter uma lista dos códigos de região utilizados nos relatórios de uso e faturamento, consulte [AWS Region billing codes](https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-region-billing-codes.html). **Topics** + [Instâncias](#instances-billing-usage-reports) + [Instâncias bare metal](#bare-metal-instances-billing-usage-reports) + [Hosts dedicados](#dedicated-hosts-billing-usage-reports) + [Dedicated Instances](#dedicated-instances-billing-usage-reports) + [Otimização de EBS](#ebs-billing-usage-reports) + [Reservas de capacidade](#capacity-reservation-billing-usage-reports) **Recursos relacionados** + [Opções de faturamento e compra do Amazon EC2](instance-purchasing-options.md) + [Noções básicas sobre as informações de faturamento da AMI](ami-billing-info.md) + [Definição de preços do Amazon EC2](https://aws.amazon.com/ec2/pricing/) ## Instâncias | Código | Descrição | Unidades | | --- | --- | --- | | region-BoxUsage:instance-type | O tempo de execução das instâncias sob demanda. | Horas | | region-HostBoxUsage:instance-type | O tempo de execução das instâncias em hosts dedicados. | Horas | | region-SpotUsage:instance-type | O tempo de execução das instâncias spot. | Horas | ## Instâncias bare metal | Código | Descrição | Unidades | | --- | --- | --- | | region-BoxUsage:instance-family.metal | O tempo de execução das instâncias bare metal sob demanda. | Horas | | region-HostBoxUsage:instance-family.metal | O tempo de execução das instâncias bare metal em hosts dedicados. | Horas | | region-SpotUsage:instance-family.metal | O tempo de execução das instâncias spot bare metal. | Horas | ## Hosts dedicados | Código | Descrição | Unidades | | --- | --- | --- | | region-HostUsage:host-type | O tempo em que os hosts dedicados são provisionados. | Horas | | region-ReservedHostUsage:host-type | O tempo em que as reservas de host dedicado são aplicadas. | Horas | ## Dedicated Instances | Código | Descrição | Unidades | | --- | --- | --- | | region-DedicatedUsage:instance-type | O tempo de execução das instâncias dedicadas. | Horas \$1 taxa por região | ## Otimização de EBS | Código | Descrição | Unidades | | --- | --- | --- | | region-EBSOptimized:instance-type | O tempo em que a otimização do EBS é habilitada. | Horas | ## Reservas de capacidade | Código | Descrição | Unidades | | --- | --- | --- | | region-Reservation:instance-type | O tempo de instância reservado para reservas de capacidade. | Horas | | region-UnusedBox:instance-type | O tempo de instância reservado não utilizado para reservas de capacidade. | Horas | | region-DedicatedRes:instance-type | O tempo de instância reservado para reservas de capacidade dedicadas. | Horas | | region-UnusedDed:instance-type | O tempo de instância reservado não utilizado para reservas de capacidade dedicadas. | Horas | # Criar um inventário das instâncias do EC2 O Amazon EC2 fornece capacidade de computação escalável e sob demanda. Uma instância do EC2 é um servidor virtual executado na rede da AWS. A tabela a seguir descreve as principais características de uma instância do EC2. Um administrador do sistema pode usar as orientações fornecidas neste guia para obter informações sobre essas características e usá-las na configuração de servidores com funcionalidades equivalentes executados on-premises ou na rede de outro provedor de nuvem. | Característica | Descrição | | --- | --- | | [Localização geográfica](#ec2-data-geographic-location) | O Amazon EC2 está hospedado em todas as regiões da AWS ao redor do mundo. Selecione locais para suas instâncias que as coloquem perto de seus clientes. Você pode inicializar instâncias em vários locais. | | [Especificações de hardware](#ec2-data-specifications) | O Amazon EC2 fornece uma ampla seleção de tipos de instância otimizadas para diferentes casos de uso. Os tipos de instância que você seleciona para as suas determinam os recursos de computação, memória, rede e armazenamento delas. | | [Imagens](#ec2-data-images) | Uma imagem de máquina da Amazon (AMI) inclui o software a ser instalado na instância durante a inicialização. Isso inclui o sistema operacional, os pacotes de software e as configurações personalizadas. | | [Endereços IP e nomes do host DNS](#ec2-data-ip-dns) | As instâncias recebem endereços IP privados e um nome do host DNS privado. Se você configurar um endereço IP público para uma instância, ela também receberá um nome do host DNS público. | | [Regras de grupos de segurança](#ec2-data-rules) | As regras do grupo de segurança associadas às instâncias determinam qual tráfego de entrada e de saída é permitido. | | [Dados do usuário](#ec2-data-user-data) | Os dados do usuário são disponibilizados para as instâncias na inicialização. Eles consistem em scripts shell (Linux) ou scripts PowerShell (Windows). | ## Localização geográfica O Amazon EC2 está disponível em todas as regiões da AWS no mundo todo. Cada Região é uma área geográfica separada. Você pode diminuir a latência da rede ao selecionar regiões para servidores que estejam próximas à maioria dos usuários. Você pode usar o [Amazon EC2 Global View](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/global-view.html) para listar as instâncias do Amazon EC2 em todas as regiões. Com o Console de gerenciamento da AWS e a API, você deve listar as instâncias de cada região individualmente. **Por que isso é importante** Depois de determinar onde as instâncias estão localizadas, você decide se deseja implantar servidores com funcionalidades equivalentes nos mesmos locais ou em locais diferentes, dependendo de suas necessidades. **Para obter um resumo das instâncias do EC2 em todas as regiões** 1. Abra o console do Amazon EC2 Global View em [https://console.aws.amazon.com/ec2globalview/home](https://console.aws.amazon.com/ec2globalview/home). 1. Na guia **Explorador de regiões**, em **Resumo**, verifique a contagem de recursos das **Instâncias**, o que inclui o número de instâncias e o de regiões. Clique no texto sublinhado para ver como a contagem de instâncias está distribuída entre as regiões. 1. Na guia **Pesquisa global**, selecione o filtro de cliente **Tipo de recurso = Instância**. Você pode filtrar ainda mais os resultados especificando uma região ou uma tag. **Para obter o número de instâncias do EC2 em uma região usando a AWS CLI** Use o comando [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) a seguir para contar as instâncias na região especificada. Você precisa executar esse comando em cada região na qual tenha instâncias. ``` aws ec2 describe-instances \ --region us-east-2 \ --query "length(Reservations[*].Instances[])" ``` O seguinte é um exemplo de saída. ``` 27 ``` Para obter uma lista dos IDs de instância em vez da contagem de instâncias, use o parâmetro `--query` a seguir. ``` --query "Reservations[*].Instances[].InstanceId" ``` ## Especificações de hardware O tipo de instância especificado para uma instância do EC2 determina os recursos de computação, memória, armazenamento e rede que estão disponíveis para ela. Cada família de instâncias oferece um equilíbrio diferente entre recursos de computação, memória, rede e armazenamento. Para obter mais informações, consulte o [Guia de tipos de instância do Amazon EC2](https://docs.aws.amazon.com/ec2/latest/instancetypes/instance-types.html). **Por que isso é importante** Depois de determinar as especificações de hardware das instâncias, você pode decidir as especificações mínimas necessárias para servidores com funcionalidades equivalentes. **Para obter um resumo dos tipos de instância usados por suas instâncias** Use o seguinte comando [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html). O comando **sed** remove linhas com colchetes e linhas vazias. Você precisa executar esse comando em cada região na qual tenha instâncias. ``` aws ec2 describe-instances \ --query "Reservations[*].Instances[].InstanceType" | sed 's/[][]//g;/^$/d' | sort | uniq -c | sort -nr ``` O seguinte é um exemplo de saída. ``` 20 "c6i.4xlarge", 5 "t2.micro", 2 "g6e.2xlarge", ``` **Para obter informações sobre tipos de instância específicos** Use o comando [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) para descrever os tipos de instância. O parâmetro `--query` inclui somente os campos especificados na saída. Essas são as características básicas. É possível exibir os campos adicionais de que você precisa ou consultar [Especificações de tipos de instâncias do Amazon EC2](https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-instance-type-specifications.html) no *Guia de tipos de instância do Amazon EC2*. ``` aws ec2 describe-instance-types \ --instance-types c6i.4xlarge t2.micro g6e.2xlarge \ --query "InstanceTypes[*].[InstanceType,VCpuInfo.DefaultVCpus,MemoryInfo.SizeInMiB,NetworkInfo.NetworkPerformance]" \ --output table ``` O seguinte é um exemplo de saída. As colunas são tipo de instância, vCPUs, memória (GiB) e largura de banda da rede (Gbps). ``` ------------------------------------------------------ | DescribeInstanceTypes | +--------------+-----+--------+----------------------+ | t2.micro | 1 | 1024 | Low to Moderate | | c6i.4xlarge | 16 | 32768 | Up to 12.5 Gigabit | | g6e.2xlarge | 8 | 65536 | Up to 20 Gigabit | +--------------+-----+--------+----------------------+ ``` ## Imagens Uma imagem de máquina da Amazon (AMI) fornece o software que é instalado em sua instância na inicialização, como sistema operacional, serviços, ferramentas de desenvolvimento e aplicações. Você pode exportar uma AMI para outros formatos e usá-la com outros servidores. **Por que isso é importante** Depois de determinar as AMIs das instâncias, planeje as imagens necessárias para servidores com funcionalidades equivalentes. Talvez seja possível exportar suas AMIs para um formato que possa ser usado em outros lugares. Como alternativa, talvez você precise se conectar a uma instância inicializada em cada AMI, confirmar o que está instalado e como está configurado e garantir que tenha uma cópia de tudo o que precisa. **Para obter as AMIs das suas instâncias** Use o seguinte comando [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html). O comando **sed** remove linhas com colchetes e linhas vazias. Você precisa executar esse comando em cada região na qual tenha instâncias. ``` aws ec2 describe-instances \ --query "Reservations[*].Instances[].ImageId" | sed 's/[][]//g;/^$/d' | sort | uniq -c | sort -nr ``` O seguinte é um exemplo de saída. ``` 20 "ami-0a70b9d193ae8a79", 5 "ami-07d9cf938edb0739b", 2 "ami-09245d5773578a1d6", ``` **Para obter informações sobre AMIs específicas** Use o seguinte comando [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html). O parâmetro `--query` inclui somente os campos especificados na saída. É possível incluir quaisquer campos adicionais necessários. ``` aws ec2 describe-images \ --image-id ami-0a70b9d193ae8a79 ami-07d9cf938edb0739b ami-09245d5773578a1d6 \ --query "Images[*].{ID:ImageId,CreateDate:CreationDate,Name:Name,Description:Description}" ``` O seguinte é um exemplo de saída. ``` [ { "ID": "ami-0a70b9d193ae8a799", "CreateDate": "2025-03-01T02:22:41.000Z", "Name": "web-server-3.1", "Description": "Image for web servers" }, { "ID": "ami-07d9cf938edb0739b", "CreateDate": "2025-02-01T23:59:03.000Z", "Name": "awesome-application-11.5", "Description": "Image for Awesome Application" }, { "ID": "ami-09245d5773578a1d6", "CreateDate": "2025-01-31T02:22:41.000Z", "Name": "monitoring-4.2", "Description": "Monitoring software" } ] ``` **Para criar um arquivo de VM usando uma AMI** Use o comando [export-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/export-image.html). Os formatos de imagem compatíveis são VHD (compatível com Citrix Xen e Microsoft Hyper-V), VMDK (compatível com VMware ESX e VMware vSphere) e formato bruto (compatível com hipervisores KVM e Xen). Para obter informações sobre os requisitos e as limitações do VM Import/Export, consulte [VM Import/Export Requirements](https://docs.aws.amazon.com/vm-import/latest/userguide/vmie_prereqs.html). ## Endereços IP e nomes do host DNS Seus usuários se conectam às instâncias do EC2 pela internet usando nomes do host DNS públicos. O nome do host DNS público de uma instância do EC2 é resolvido no endereço IP público. As instâncias do EC2 podem se comunicar entre si usando os endereços IP privados. **Por que isso é importante** Os endereços IP permitem que dispositivos se comuniquem entre si por meio de uma rede local ou da internet. Ao observar os endereços IP e os nomes DNS das instâncias, você pode ajudar a garantir que servidores com funcionalidades equivalentes possam se comunicar com os mesmos clientes ou dispositivos que suas instâncias. Por exemplo, você pode atualizar a configuração do balanceador de carga ou os registros de DNS criados para o provedor de DNS. **Para obter os endereços IP e os nomes do host DNS das instâncias** Use o seguinte comando [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html). Você precisa executar esse comando em cada região na qual tenha instâncias. O parâmetro `--query` inclui somente os campos especificados na saída. É possível incluir quaisquer campos adicionais necessários. ``` aws ec2 describe-instances \ --query "Reservations[*].Instances[].[InstanceId,PrivateIpAddress,PublicDnsName]" \ --output table ``` O seguinte é um exemplo de saída. As colunas são ID da instância, endereço IPv4 privado e nome DNS IPv4 público. ``` ---------------------------------------------------------------------------------------- | DescribeInstances | +---------------------+------------+---------------------------------------------------+ | i-0bac57d7472c89bac | 10.0.2.139 | ec2-192-0-2-142.us-east-2.compute.amazonaws.com | | i-0fa8b7678975a3fff | 10.0.14.85 | ec2-198-51-100-56.us-east-2.compute.amazonaws.com | ... ... | i-08fd74f3f1595fdbd | 10.0.1.241 | ec2-203.0.113.13.us-east-2.compute.amazonaws.com | +---------------------+------------+---------------------------------------------------+ ``` ## Regras de grupos de segurança Um grupo de segurança funciona como um firewall virtual. Depois de associar um grupo de segurança a uma instância do EC2, as regras permitem tráfego de entrada e saída da instância do EC2 em portas e protocolos específicos. **Por que isso é importante** Depois de determinar o tráfego de entrada permitido para chegar ao servidor e o tráfego de saída permitido para sair dele, você pode planejar as regras de firewall necessárias para servidores com funcionalidades equivalentes. **Para obter os grupos de segurança das instâncias** Use o seguinte comando [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html). O comando **sed** remove linhas com colchetes e linhas vazias. Você precisa executar esse comando em cada região na qual tenha instâncias. ``` aws ec2 describe-instances \ --query "Reservations[*].Instances[].SecurityGroups[].GroupId" | sed 's/[][]//g;/^$/d' | sort | uniq -c | sort -nr ``` O seguinte é um exemplo de saída. ``` 27 "sg-01dd3383691d02f42", 10 "sg-08c77cc910c0b3b2c", 2 "sg-00f4e409629f1a42d", ``` **Para obter as regras de entrada de um grupo de segurança** Use o comando [describe-security-group-rules](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-security-group-rules.html) a seguir para exibir as regras do grupo de segurança especificado em que `IsEgress` é `false`. ``` aws ec2 describe-security-group-rules \ --filters Name=group-id,Values=sg-01dd3383691d02f42 \ --query 'SecurityGroupRules[?IsEgress==`false`]' ``` O seguinte é um exemplo de saída. A primeira regra é a de entrada padrão, que permite tráfego de entrada proveniente de todos os recursos atribuídos a esse grupo de segurança. A outra regra permite tráfego SSH proveniente dos endereços IP na lista de prefixos especificada. Para descrever os blocos CIDR em uma lista de prefixos, use o comando [describe-prefix-lists](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-prefix-lists.html). ``` [ { "SecurityGroupRuleId": "sgr-06c8b42574a91db1b", "GroupId": "sg-01dd3383691d02f42", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "-1", "FromPort": -1, "ToPort": -1, "ReferencedGroupInfo": { "GroupId": "sg-01dd3383691d02f42", "UserId": "123456789012" }, "Tags": [], "SecurityGroupRuleArn": "arn:aws:ec2:us-west-2:123456789012:security-group-rule/sgr-06c8b42574a91db1b" }, { "SecurityGroupRuleId": "sgr-0886a5d46afcd1758", "GroupId": "sg-01dd3383691d02f42", "GroupOwnerId": "123456789012", "IsEgress": false, "IpProtocol": "tcp", "FromPort": 22, "ToPort": 22, "PrefixListId": "pl-f8a6439125e7bf465", "Tags": [], "SecurityGroupRuleArn": "arn:aws:ec2:us-east-2:123456789012:security-group-rule/sgr-0886a5d46afcd1758" } ] ``` **Para obter as regras de saída de um grupo de segurança** Use o comando [describe-security-group-rules](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-security-group-rules.html) a seguir para exibir as regras do grupo de segurança especificado em que `IsEgress` é `true`. ``` aws ec2 describe-security-group-rules \ --filters Name=group-id,Values=sg-01dd3383691d02f42 \ --query 'SecurityGroupRules[?IsEgress==`true`]' ``` O seguinte é um exemplo de saída. Ele contém somente a regra de saída padrão, que permite todo o tráfego IPv4 de saída. ``` [ { "SecurityGroupRuleId": "sgr-048f09a719247dce7", "GroupId": "sg-01dd3383691d02f42", "GroupOwnerId": "123456789012", "IsEgress": true, "IpProtocol": "-1", "FromPort": -1, "ToPort": -1, "CidrIpv4": "0.0.0.0/0", "Tags": [], "SecurityGroupRuleArn": "arn:aws:ec2:us-east-2:123456789012:security-group-rule/sgr-048f09a719247dce7" } ] ``` ## Dados do usuário Ao inicializar uma instância do EC2, é possível transmitir um script shell para a instância usando dados do usuário. Observe que os dados do usuário são codificados em base64, portanto, é necessário decodificá-los para ler o script. **Por que isso é importante** Se você estiver executando comandos na inicialização como parte da configuração das instâncias, talvez seja necessário realizar as mesmas tarefas ao configurar servidores com funcionalidades equivalentes. **Para visualizar os dados decodificados do usuário de uma instância** Use o comando [describe-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-attribute.html) a seguir. O comando **base64** decodifica os dados do usuário. ``` aws ec2 describe-instance-attribute \ --instance-id i-1234567890abcdef0 \ --attribute userData \ --output text \ --query "UserData.Value" | base64 --decode ``` O seguinte é um exemplo de saída. ``` #!/bin/bash yum update -y service httpd start chkconfig httpd on ``` ## Recursos relacionados Estas são as características adicionais das instâncias do EC2: + [Pares de chaves](ec2-key-pairs.md) + [Armazenamento](Storage.md) + [Tags](Using_Tags.md) Você pode verificar se está usando os seguintes recursos para inicializar instâncias do EC2 ou distribuir o tráfego entre as instâncias do EC2: + [Grupos do Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) + [EC2 Fleet](Fleets.md) + [Elastic Load Balancing](https://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/)