Agente AWS Well-ArchitectedO é uma versão de teste e está sujeita à alteração.
# Conceitos básicos do Agente AWS Well-Architected
Para usar o Agente AWS Well-Architected, você cria um perfil de agente que define o escopo de sua análise de infraestrutura. Criar um perfil de agente é a etapa de integração. Você precisa de um perfil para exibir recomendações, conduzir análises de arquitetura ou usar qualquer outro recurso do Agente AWS WA.
**dica**
As recomendações básicas do AWS Trusted Advisor estão disponíveis sem a criação de um perfil. Para receber recomendações personalizadas e alinhadas às metas com análise de compensação entre pilares, conclua as etapas de configuração a seguir.
O processo de configuração usa dois serviços da AWS:
+ **AWS Well-Architected** (console do Well-Architected): crie seu perfil de agente, configure contas, pilares, metas e contexto da aplicação.
+ **IAM**: crie perfis de acesso em suas contas de workload e atualize as políticas de confiança para estabelecer acesso entre contas.
Esta página descreve a configuração baseada em console. Para configurar o Agente AWS WA usando a CLI da AWS, consulte [Início rápido da API](agent-api-quickstart.md).
Depois que um perfil é criado e configurado adequadamente, o Agente AWS WA começa a gerar recomendações agendadas em 24 horas. Para acessar mais informações sobre recomendações agendadas e tipos de recomendação, consulte [Recomendações](agent-rec-management.md).
## Pré-requisitos
+ Você tem um plano AWS Support ativo no nível Business\+ ou superior (Business\+, Enterprise On-Ramp, Enterprise Support ou Unified Operations). Clientes nos planos Developer e Business não têm acesso ao Agente AWS WA. Para ver direitos específicos de nível, consulte [Cotas e limites do Agente AWS Well-Architected](agent-quotas.md).
+ **(Opcional)** Você habilitou o AWS Cost Explorer em sua conta dados de custo precisos. Há dois recursos separados a serem conferidos para habilitar totalmente o Explorador de Custos para Agente AWS WA:
+ Habilite o serviço AWS Cost Explorer principal.
+ Em **Preferências de gerenciamento de custos**, na barra lateral do Explorador de Custos, em **Dados granulares**, marque a caixa de seleção **Dados em nível de atributo com granularidade por dia**.
**nota**
Sem o Explorador de Custos habilitado, o Agente AWS WA estima os custos com base nos preços públicos da AWS.
+ Você tem as permissões do IAM necessárias para criar um perfil do Agente AWS WA, incluindo permissões para criar perfis do IAM (`iam:CreateRole`, `iam:AttachRolePolicy`,`iam:PassRole`) e ações do Agente AWS WA (`wellarchitected:CreateAgentProfile`). Para acessar mais informações sobre o modelo de acesso do Agente AWS WA, consulte [Modelo de acesso do Agente AWS Well-Architected](security-iam-agent.md).
+ Você identificou os IDs da Conta da AWS que o Agente AWS WA deve analisar (máximo de cem contas).
+ Você definiu suas metas de negócios e selecionou os pilares de otimização nos quais deseja se concentrar.
## Etapa 1: criar um perfil de agente
Crie um perfil de agente no console do Agente AWS WA. Ao criar um perfil, você pode criar um perfil de execução ou selecionar um existente.
**Como criar um perfil de agente**
1. Abra o Console de gerenciamento da AWS e navegue até AWS Well-Architected.
1. Abra o Agente AWS WA Console.
1. Escolha **Perfis de agente** no painel de navegação esquerdo.
1. No canto superior direito, escolha **Adicionar perfil**.
1. Insira um nome de perfil entre 3 e 128 caracteres. Use somente letras, números, hifens (-) e sublinhados (\_). Por exemplo, `product-backend-team`.
1. Insira uma descrição para o perfil.
1. Em **Selecionar contas e regiões**, escolha Regiões da AWS para monitorar e analisar.
1. Em **Contas a serem monitoradas**, insira os IDs das contas separados por vírgulas (até cem contas).
1. Depois, em **Nome comum do perfil de acesso**, insira o nome do perfil de acesso a ser usado em todas as contas no perfil. O nome recomendado é `AccessRoleForWellArchitectedAgent`.
**nota**
Se você criar seu próprio nome de perfil de acesso ou usar o recomendado, você deve usar exatamente o mesmo nome de perfil de acesso em todas as contas no perfil. Isso se aplica somente à experiência de integração do console.
## Etapa 2: adicionar metas e pilares de otimização
Durante a criação do perfil, configure o seguinte nos **pilares de otimização**:
+ **Pilar de otimização:** selecione pelo menos um pilar para o Agente AWS WA analisar: otimização de custos, segurança, resiliência ou performance.
+ **Declaração de meta:** insira pelo menos uma declaração de meta em texto simples. Cada perfil exige no mínimo uma meta para o Agente AWS WA gerar recomendações priorizadas. As metas podem ser editadas a qualquer momento após a criação. Para receber orientação sobre como redigir metas efetivas, consulte [Metas e personalização no Agente AWS Well-Architected](agent-goals.md).
## Etapa 3: configurar permissões e integrações
Após configurar os pilares, em **Permissões e integrações**, você pode selecionar um perfil de execução existente ou criar outro.
O perfil de execução é um perfil do IAM em sua conta de perfil que o Agente AWS WA assume para orquestrar a descoberta de recursos. O perfil de execução está vinculado aos perfis de acesso em suas contas de workload. Quando você escolhe **Criar perfil**, o console cria automaticamente o perfil de execução do IAM para você, aplicando a política de confiança e a política de permissões necessárias. Você não precisa navegar até o console do IAM separadamente.
**Como criar um perfil de execução**
1. Escolha **Criar perfil**.
1. O console preenche previamente o campo **Nome do perfil** com `ExecutionRoleForWellArchitectedAgent`. Recomendamos usar esse nome por padrão.
1. (Opcional) Para analisar a política de confiança e a política de permissões que o console aplicará, escolha **Exibir política de confiança**.
1. Selecione **Criar perfil**.
1. Determine se deseja habilitar ou desabilitar a proteção contra encerramento. É recomendável habilitar esse recurso para evitar a exclusão acidental do perfil.
Se você não quiser habilitar AWS Cost Explorer, escolha **Começar** para concluir a criação do seu perfil. Depois que o perfil for criado, conclua a configuração restante. Para habilitar a descoberta entre contas, você deve criar perfis de acesso em suas contas de workload, conforme descrito em [Etapa 6: criar perfis de acesso em suas contas de workload](#agent-access-roles).
Se você quiser habilitar o Explorador de Custos, acesse [(Opcional) Etapa 4: habilitar o AWS Cost Explorer](#agent-cost-explorer) antes de concluir a criação do perfil.
## (Opcional) Etapa 4: habilitar o AWS Cost Explorer
**nota**
A habilitação do AWS Cost Explorer é uma etapa opcional para aprimorar a especificidade dos dados de custo. O Explorador de Custos é habilitado em nível de Conta da AWS, não por perfil do Agente AWS WA. Se você habilitar o Explorador de Custos na conta gerencial da sua organização, todas as contas de membro também receberão acesso.
Depois de habilitar o Explorador de Custos, ele não poderá ser desabilitado, embora as preferências de dados granulares opcionais (dados em nível de recurso) possam ser alteradas a qualquer momento.
Para usar dados de custo e recursos precisos e em tempo real de suas contas, você pode habilitar o AWS Cost Explorer.
Com o Explorador de Custos e os [Dados em nível de atributo com granularidade por dia](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-resource-daily.html), ambos habilitados, o Agente AWS WA pode fornecer recomendações e otimizações com seus dados de custo exatos.
Sem o Explorador de Custos habilitado, o Agente AWS WA estima os custos com base nos preços públicos da AWS.
Não há cobrança pelo uso do console do Explorador de Custos. As cobranças se aplicam às solicitações da API do Explorador de Custos e às preferências de dados granulares em nível de recurso. A atribuição de custos em nível de recurso nas recomendações do Agente AWS WA exige preferências granulares de dados. Para estimar essas cobranças, consulte os [Definição de preço do Explorador de Custos da AWS](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/pricing/).
Para começar a usar o Explorador de Custos em seu perfil do Agente AWS WA, escolha **Abrir Explorador de Custos** e configure o Abrir Explorador de Custos para sua Conta da AWS. Para acessar mais detalhes, consulte [Conceitos básicos do Explorador de Custos](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-getting-started.html).
Após habilitar o Explorador de Custos, pode levar até 24 horas para os dados estarem disponíveis no Agente AWS WA, e os dados em nível de recursos com granularidade diária podem levar até 48 horas para serem propagados.
## Etapa 5: adicionar contexto da aplicação
Depois que seu perfil for criado, adicione o contexto da aplicação para ajudar o Agente AWS WA a gerar recomendações mais relevantes. O contexto da aplicação fornece detalhes sobre suas workloads que o Agente AWS WA não consegue descobrir automaticamente.
**Importante**
Pelo menos um contexto de aplicação é necessário por perfil para o Agente AWS WA gerar recomendações programadas. Sem o contexto da aplicação, seu perfil é sinalizado como inválido, e a geração programada de recomendações não é executada.
**Como adicionar contexto da aplicação a um perfil**
1. No painel de navegação à esquerda, escolha **Perfis de agente**.
1. No perfil que você já criou, escolha **Detalhes do perfil**.
1. Selecione a guia **Contexto da aplicação**.
1. Escolha **Adicionar contexto da aplicação**.
1. Insira detalhes sobre o contexto da aplicação, incluindo nome da aplicação, visão geral, contas na aplicação, Regiões da AWS e marcações. Para ter uma visão geral completa sobre como adicionar ou atualizar o contexto da aplicação, consulte [Atualizar o contexto da aplicação](agent-update-app-context.md).
1. Depois de preencher o contexto da aplicação, escolha **Adicionar aplicação**.
## Etapa 6: criar perfis de acesso em suas contas de workload
Depois de criar seu perfil, crie um perfil de acesso do IAM em cada Conta da AWS que você selecionou para monitorar. Os perfis de acesso permitem que o Agente AWS WA descubram e analisem recursos nessas contas.
Quando a criação do perfil é concluída, a página de criação de perfil mostra um prompt **Ação necessária** indicando que as contas selecionadas ainda precisam de um perfil de acesso. A criação desses perfis é uma tarefa separada que você executa manualmente no console do IAM. O console não cria os perfis para você e não abre o console do IAM automaticamente. O Agente AWS WA não monitora nem analisa uma conta até que o perfil de acesso dessa conta exista.
O nome do perfil deve corresponder ao **nome do perfil de acesso comum** que você inseriu durante a criação do perfil. O nome recomendado é `AccessRoleForWellArchitectedAgent`.
A política de permissões do perfil de execução concede `sts:AssumeRole` nos perfis de acesso, e a política de confiança de cada perfil de acesso permite que o perfil de execução o assuma. Use o mesmo nome de perfil em todas as contas de workload.
Use o seguinte modelo de política de confiança para seus perfis de acesso. {{ProfileOwningAccountId}} é a conta na qual você criou o perfil de agente. {{ExecutionRoleName}} é o nome do perfil de execução no perfil de agente. Por padrão, isso geralmente é `ExecutionRoleForWellArchitectedAgent`.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::{{ProfileOwningAccountId}}:role/service-role/{{ExecutionRoleName}}"
},
"Action": "sts:AssumeRole"
}
]
}
```
**Importante**
O formato do ARN do perfil de execução depende de como o perfil foi criado:
Se você usou o botão **Criar perfil** em [Etapa 3: configurar permissões e integrações](#agent-permissions-integrations), o console colocará o perfil no caminho `service-role/`: `arn:aws:iam::{{111122223333}}:role/service-role/ExecutionRoleForWellArchitectedAgent`
Se você criou previamente o perfil de execução manualmente no IAM e o selecionou durante a criação do perfil, use o ARN sem o prefixo `service-role/`: `arn:aws:iam::{{111122223333}}:role/ExecutionRoleForWellArchitectedAgent`
**Como criar um perfil de acesso**
1. No console do IAM, abra a contada workload.
1. No painel de navegação à esquerda, escolha **Perfis** e **Criar perfil**.
1. Em **Trusted entity type** (Tipo de entidade confiável), escolha **Custom trust policy** (Política de confiança personalizada).
1. Cole a política de confiança mostrada no modelo anterior e substitua as informações necessárias.
1. Escolha **Próximo**. Na página **Adicionar permissões**, pesquise e anexe a [política gerenciada `WellArchitectedAgentResourceScanning`](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/WellArchitectedAgentResourceScanning.html). Isso concede acesso somente leitura aos metadados e à configuração do recurso.
1. Escolha **Próximo**. Insira o nome do perfil (ele deve corresponder ao **nome do perfil de acesso comum** da criação do perfil, recomendamos`AccessRoleForWellArchitectedAgent`) e escolha **Criar perfil**. Use o mesmo nome em todas as contas de workload.
**nota**
Se você já criou perfis de acesso com uma política de confiança mais ampla, edite a guia **Relações de confiança** de cada perfil para usar a política de confiança mostrada no modelo anterior.
Repita esse procedimento em cada conta de workload que o Agente AWS WA deve analisar. Para acessar mais informações sobre o modelo de acesso e a cadeia de perfis do Agente AWS WA, consulte [Modelo de acesso do Agente AWS Well-Architected](security-iam-agent.md).
## Próximas etapas
Após concluir a configuração do perfil, você pode:
+ Exiba suas recomendações personalizadas no painel do Agente AWS WA ([Recomendações](agent-rec-management.md)). As recomendações programadas geralmente ficam disponíveis em até 24 horas após a conclusão da configuração do perfil.
+ Faça uma análise da arquitetura fazendo upload de seus arquivos do IaC ([Realizar análises de arquitetura](agent-architecture-reviews.md)).
+ Gerencie suas configurações de perfil a qualquer momento ([Perfis de agente](agent-manage-profiles.md)).