# Instalar, configurar e gerenciar sua aplicação para monitoramento no console do CloudWatch
<a name="appinsights-setting-up-console"></a>

Esta seção fornece as etapas para instalar, configurar e gerenciar a aplicação para monitoramento no console do CloudWatch.

**Topics**
+ [Adicionar e configurar uma aplicação](#appinsights-add-configure)
+ [Habilitar o Application Insights para monitoramento de recursos do Amazon ECS e do Amazon EKS](#appinsights-container-insights)
+ [Desabilitar o monitoramento de um componente da aplicação](#appinsights-disable-monitoring)
+ [Excluir uma aplicação](#appinsights-delete-app)

## Adicionar e configurar uma aplicação
<a name="appinsights-add-configure"></a>

**Adicionar e configurar uma aplicação no console do CloudWatch**  
Para começar a usar o CloudWatch Application Insights no console do CloudWatch, siga estas etapas.

1. **Início.** Abra a [página inicial do console do CloudWatch](https://console.aws.amazon.com/cloudwatch). No painel de navegação esquerdo, em **Insights**, escolha **Application Insights**. Essa página exibe a lista de aplicações que são monitoradas pelo Application Insights do CloudWatch, além dos status de monitoramento. 

1. **Adicione uma aplicação.** Para configurar o monitoramento para sua aplicação, escolha **Add an application** (Adicionar uma aplicação). Ao escolher **Add an application** (Adicionar uma aplicação), você será direcionado para **Choose Application Type** (Escolher o tipo de aplicação). 
   + **Aplicação baseada em grupo de recursos**. Ao selecionar essa opção, você pode escolher quais grupos de recursos monitorar nessa conta. Para usar várias aplicações em um componente, você deve usar o monitoramento baseado em grupos de recursos. 
   + **Aplicação baseada em conta**. Ao selecionar essa opção, você poderá monitorar todos os recursos dessa conta. Se você quiser monitorar todos os recursos em uma conta, recomendamos usar esta opção em vez da a opção baseada em grupo de recursos, pois o processo de integração de aplicações é mais rápido.
**nota**  
Não é possível combinar o monitoramento baseado em grupo de recursos com o monitoramento baseado em conta usando o Application Insights. Para alterar o tipo de aplicação, você deve excluir todas aquelas que estão sendo monitoradas e **Choose Application Type** (Escolher o tipo de aplicação). 

   Quando você adiciona sua primeira aplicação para monitoramento, o CloudWatch Application Insights cria uma função vinculada ao serviço em sua conta, o que dá permissões ao Application Insights para chamar outros serviços da AWS em seu nome. Para obter mais informações sobre a função vinculada ao serviço criada em sua conta pelo Application Insights, consulte [Usar funções vinculadas ao serviço do CloudWatch Application Insights](CHAP_using-service-linked-roles-appinsights.md).

1. 

------
#### [ Resource-based application monitoring ]

   1. **Selecione uma aplicação ou grupo de recursos.**Na página **Specify application details** (Especificar os detalhes da aplicação), selecione na lista suspensa o grupo de recursos da AWS que contém os recursos da sua aplicação. Esses recursos incluem servidores front-end, load balancers, grupos de Auto Scaling e servidores de banco de dados. 

      Se você não criou um grupo de recursos para sua aplicação, pode fazer isso escolhendo **Create new resource group** (Criar grupo de recursos). Para obter mais informações sobre a criação de grupos de recursos, consulte [https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html). 

   1. **Notificações para insights de problemas.** Para visualizar e receber notificações quando problemas forem detectados em aplicações selecionadas, selecione notificações do Amazon SNS ou Opsitems do OpsCenter do Systems Manager.

      1. **Configure a notificação do Amazon SNS (recomendado).** Escolha **Selecionar tópico existente** ou **Criar tópico**. 

      1. **Integração ao Systems Manager OpsCenter da AWS.** Em **Configurações avançadas**, marque a caixa de seleção **Gerar Opsitems do OpsCenter do Systems Manager para ações corretivas**. Para rastrear as operações executadas para resolver itens de trabalho operacionais (OpsItems) relacionados aos recursos da AWS, forneça o ARN do tópico do Amazon SNS.

   1. **Monitorar CloudWatch Events**. Marque a caixa de seleção para integrar o monitoramento do Application Insights com o CloudWatch Events para obter insights do Amazon EBS, Amazon EC2,AWS CodeDeploy, Amazon ECS, APIs e notificações do AWS Health, Amazon RDS, Amazon S3 eAWS Step Functions.

   1. **Etiquetas (opcionais**. O CloudWatch Application Insights oferece suporte a grupos de recurso baseados em etiquetas e baseados no CloudFormation (com exceção dos grupos do Auto Scaling). Para obter mais informações, consulte [Trabalhar com o Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html).

   1. Escolha **Próximo**.

      Um [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) será gerado para a aplicação no formato a seguir.

      ```
      arn:partition:applicationinsights:region:account-id:application/resource-group/resource-group-name
      ```

      Exemplo

      ```
      arn:aws:applicationinsights:us-east-1:123456789012:application/resource-group/my-resource-group
      ```

   1. Na página **Revisar componentes detectados**, em **Revisar componentes para monitoramento**, a tabela lista os componentes detectados e suas workloads detectadas associadas.
**nota**  
Para componentes que ofereçam suporte a várias workloads personalizadas, é possível monitorar até cinco workloads para cada componente. Essas workloads serão monitoradas separadamente do componente.  
![\[A seção de componentes detectados do console do CloudWatch Application Insights: visão geral dos componentes detectados e das workloads associadas.\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/appinsights-multiapp-review-component.png)

      Em **Workloads associadas**, há várias mensagens possíveis que aparecem se uma workload não estiver listada.
      + **Não foi possível detectar workloads**: ocorreu um problema ao tentar detectar workloads. Certifique-se de ter concluído [Pré-requisitos para a configuração de uma aplicação para monitoramento](appinsights-prereqs.md). Se você precisar adicionar workloads, escolha **Editar componente**.
      + **Nenhuma workload trabalho detectada**: não detectamos nenhuma workload. Talvez seja necessário adicionar workloads. Para fazer isso, escolha **Editar componente**.
      + **Não aplicável**: o componente não oferece suporte a workloads personalizadas e será monitorado com métricas, alarmes e logs padrão. Você não pode adicionar workloads a esses componentes.

   1. Para editar um componente, selecione um componente e, em seguida, escolha **Editar componente**. Um painel lateral se abrirá com as workloads detectadas no componente. Nesse painel, é possível editar os detalhes do componente e adicionar novas workloads.  
![\[A análise detectou a seção de componentes do console do CloudWatch Application Insights: workloads associadas podem ser editadas.\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/appinsights-multiapp-edit-component.png)
      + Para editar o tipo ou nome da workload, use a lista suspensa.  
![\[A seção Editar componente do console do CloudWatch Application Insights: lista suspensa do tipo de workload.\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/appinsights-multiapp-edit-name-type.png)
      + Para adicionar uma workload ao componenyte, escolha **Adicionar nova workload**.  
![\[A seção de edição do componente do console do CloudWatch Application Insights: botão inferior esquerdo para adicionar uma nova workload.\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/appinsights-multiapp-add-workload.png)
        + Se **Adicionar nova workload** não aparecer, esse componente não oferece suporte a várias workloads.
        + Se o título **Workloads associadas** não aparecer, esse componente não oferece suporte a workloads personalizadas.
      + Para remover uma workload, escolha **Remover** ao lado da workload que você deseja remover do monitoramento.  
![\[A seção de edição do componente do console do CloudWatch Application Insights: remover uma workload.\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/appinsights-multiapp-remove-workload.png)
      + Para desativar o monitoramento de todo o componente, desmarque a caixa de seleção **Monitoramento**.  
![\[A seção de edição do componente da caixa de seleção do CloudWatch Application Insights para desabilitar o monitoramento.\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/appinsights-multiapp-disable-monitoring.png)
      + Quando terminar de editar o componente, escolha **Salvar alterações** no canto inferior direito. Todas as alterações nas workloads de um componente serão visíveis na tabela **Revisar componentes para monitoramento**, em **Workloads associadas**.

   1. Na página **Revisar componentes detectados**, escolha **Avançar**.

   1. A página **Especificar detalhes do componente** inclui todos os componentes com workloads associadas personalizáveis da etapa anterior.
**nota**  
Se um cabeçalho de um componente tiver uma tag *opcional*, detalhes adicionais das workloads nesse componente serão opcionais.

      Se um componente não aparecer nessa página, o componente não terá detalhes adicionais que possam ser especificados nesta etapa.

   1. Escolha **Próximo**.

   1. Na página **Revisar e enviar**, revise todos os detalhes do componente monitorado e da workload.

   1. Selecione **Enviar**.

------
#### [ Account-based application monitoring ]

   1. **Application name (Nome da aplicação**. Insira um nome para sua aplicação baseada em conta.

   1. **Monitoramento automatizado de novos recursos**. Por padrão, o Application Insights usa as configurações recomendadas para configurar o monitoramento de componentes de recursos que são adicionados à sua conta após a integração da aplicação. Você pode excluir o monitoramento de recursos adicionados após a integração da aplicação desmarcando a caixa de seleção.

   1. **Monitorar CloudWatch Events**. Marque a caixa de seleção para integrar o monitoramento do Application Insights com o CloudWatch Events para obter insights do Amazon EBS, Amazon EC2,AWS CodeDeploy, Amazon ECS, APIs e notificações do AWS Health, Amazon RDS, Amazon S3 eAWS Step Functions.

   1. **Integração ao Systems Manager OpsCenter da AWS.** Para visualizar e receber notificações quando problemas forem detectados em aplicações selecionadas, selecione a caixa de seleção **Generate Systems Manager OpsCenter OpsItems for remedial actions** (Gerar OpsItems do Systems Manager OpsCenter para ações corretivas). Para rastrear as operações executadas para resolver itens de trabalho operacionais (OpsItems) relacionados aos recursos da AWS, forneça o ARN do tópico do SNS. 

   1. **Etiquetas (opcionais**. O CloudWatch Application Insights oferece suporte a grupos de recurso baseados em etiquetas e baseados no CloudFormation (com exceção dos grupos do Auto Scaling). Para obter mais informações, consulte [Trabalhar com o Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html).

   1. **Recursos descobertos**. Todos os recursos descobertos em sua conta são adicionados a esta lista. Se o Application Insights não conseguir descobrir todos os recursos da conta, uma mensagem de erro será exibida na parte superior da página. Esta mensagem inclui um link para a [documentação sobre como adicionar as permissões necessárias](appinsights-account-based-onboarding-permissions.md).

   1. Escolha **Próximo**.

      Um [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) será gerado para a aplicação no formato a seguir.

      ```
      arn:partition:applicationinsights:region:account-id:application/TBD/application-name
      ```

      Exemplo

      ```
      arn:aws:applicationinsights:us-east-1:123456789012:application/TBD/my-application
      ```

------

1. Depois de enviar a configuração de monitoramento da aplicação, você acessará a página de detalhes da aplicação, onde é possível visualizar o **Resumo da aplicação** e a lista **Componentes monitorados** e **Componentes não monitorados**. Além disso, se selecionar as guias ao lado de **Componentes**, você verá o **Histórico de configuração**, os **Padrões de logs** e as **Tags** que aplicou.

   Para visualizar insights da aplicação, escolha **View Insights** (Visualizar Insights).

   É possível atualizar suas seleções para monitoramento e integração do CloudWatch Events ao AWS Systems Manager OpsCenter escolhendo **Edit** (Editar).

   Em **Components** (Componentes), é possível selecionar o menu **Actions** (Ações) para criar, modificar ou desagrupar um grupo de instâncias.

   É possível gerenciar o monitoramento de componentes, incluindo camada de aplicação, grupos de log, logs de eventos, métricas e alarmes personalizados. Para isso, selecione o marcador ao lado de um componente e escolha **Manage monitoring** (Gerenciar o monitoramento).

## Habilitar o Application Insights para monitoramento de recursos do Amazon ECS e do Amazon EKS
<a name="appinsights-container-insights"></a>

Você pode habilitar o Application Insights para monitorar aplicações e microsserviços em contêiner no console do Container Insights. O Application Insights oferece suporte ao monitoramento dos seguintes recursos:
+ Clusters do Amazon ECS
+ Serviços do Amazon ECS
+ Tarefas do Amazon ECS
+ Clusters do Amazon EKS

Quando o Application Insights está ativado, ele fornece métricas e registros recomendados, detecta possíveis problemas, gera CloudWatch Events e cria painéis automáticos para suas aplicações e microsserviços em contêiner.

Você pode habilitar o Application Insights para recursos em contêiner nos consoles Container Insights ou Application Insights.

**Habilitar insights de aplicações no console Container Insights**  
No console do Container Insights, no painel **Performance Monitoring** (Monitoramento da performance) do Container Insights, escolha **Auto-configure Application Insights** (Configurar automaticamente o Application Insights). Quando o Application Insights está habilitado, ele exibe detalhes sobre problemas detectados.

**Habilitar o Application Insights a partir do console**  
Quando clusters do ECS aparecem na lista de componentes, o Application Insights permite automaticamente o monitoramento adicional de contêiner com o Container Insights 

Em clusters do EKS, é possível habilitar o monitoramento adicional com o Container Insights para fornecer informações de diagnóstico, como falhas de reinicialização de contêiner, para ajudar você a isolar e resolver problemas. São necessárias etapas adicionais para configurar o Container Insights para o EKS. Consulte [Configurar o Container Insights no Amazon EKS e no Kubernetes](deploy-container-insights-EKS.md) para obter mais informações sobre as etapas do Container Insights no EKS. 

O monitoramento adicional para EKS com o Container Insights é compatível com instâncias Linux com EKS.

Para obter mais informações sobre a compatibilidade do Container Insights com clusters ECS e EKS, consulte [Container Insights](ContainerInsights.md).

## Desabilitar o monitoramento de um componente da aplicação
<a name="appinsights-disable-monitoring"></a>

Para desabilitar o monitoramento de um componente da aplicação, na página de detalhes da aplicação, selecione o componente para o qual deseja desabilitar o monitoramento. Escolha **Actions ** (Ações) e, em seguida, **Remove from monitoring** (Remover do monitoramento). 

## Excluir uma aplicação
<a name="appinsights-delete-app"></a>

Para excluir uma aplicação, mo painel do CloudWatch, no painel de navegação esquerdo, escolha **Application Insights** em **Insights**. Selecione a aplicação que você deseja excluir. Em **Actions** (Ações), escolha **Delete application** (Excluir aplicação). Isso exclui o monitoramento e exclui todos os monitores salvos para os componentes da aplicação. Os recursos da aplicação não são excluídos.