Melhore o desempenho operacional habilitando o Amazon DevOps Guru em várias regiões, contas e OUs da AWS com o AWS CDK

Configure perfis nomeados da AWS.

Configure seus perfis nomeados da AWS da seguinte forma para implantar pilhas em um ambiente de várias contas.

Para a conta de administrador:

$aws configure --profile administrator
AWS Access Key ID [****]: <your-administrator-access-key-ID>
AWS Secret Access Key [****]: <your-administrator-secret-access-key>
Default region name [None]: <your-administrator-region>
Default output format [None]: json

Para a conta de destino:

$aws configure --profile target
AWS Access Key ID [****: <your-target-access-key-ID>
AWS Secret Access Key [****]: <your-target-secret-access-key>
Default region name [None]: <your-target-region>
Default output format [None]: json

Para obter mais informações, consulte Uso de perfis nomeados na documentação da AWS CLI.

Verifique as configurações do perfil da AWS.

(Opcional) Você pode verificar suas configurações de perfil da AWS nos arquivos credentials e config seguindo as instruções em Definir e visualizar configurações na documentação da AWS CLI.

Verifique a versão do AWS CDK.

Verifique a versão do AWS CDK Toolkit executando o seguinte comando:

$cdk --version

Este padrão requer a versão 1.107.0 ou superior. Se você tiver uma versão anterior do AWS CDK, siga as instruções na documentação do AWS CDK para atualizá-la.

Clone o código do projeto.

Clone o GitHub repositório desse padrão usando o comando:

$git clone https://github.com/aws-samples/amazon-devopsguru-cdk-samples.git

Instale as dependências do pacote e compile os TypeScript arquivos.

Instale as dependências do pacote e compile os TypeScript arquivos executando os seguintes comandos:

$cd amazon-devopsguru-cdk-samples
$npm install
$npm fund

Esses comandos instalam todos os pacotes do repositório de exemplo.

Importante: se você receber algum erro sobre pacotes ausentes, use um dos comandos a seguir:

$npm ci

—ou—

$npm install -g @aws-cdk/<package-name>

Você pode encontrar a lista de nomes e versões de pacotes na seção Dependencies do arquivo /amazon-devopsguru-cdk-samples/package.json. Para obter mais informações, consulte npm ci e npm install na documentação do npm.

Configure um endereço de e-mail para notificações do Amazon SNS.

Siga estas etapas para fornecer um endereço de e-mail para notificações do Amazon SNS:

Crie o código do projeto.

Crie o código do projeto e sintetize as pilhas executando o comando:

npm run build && cdk synth 

Você deve ver saída semelhante a: 

$npm run build && cdk synth
> cdk-devopsguru@0.1.0 build
> tsc
Successfully synthesized to ~/amazon-devopsguru-cdk-samples/cdk.out
Supply a stack id (CdkDevopsGuruStackMultiAccReg,CdkDevopsGuruStackMultiAccRegSpecStacks, CdkDevopsguruStackOrgUnit, CdkInfrastructureStack, CdkStackSetAdminRole, CdkStackSetExecRole) to display its template.

Para obter mais informações e etapas, consulte Seu primeiro aplicativo do AWS CDK na documentação do AWS CDK.

Liste as pilhas do AWS CDK.

Execute o comando a seguir para listar todas as pilhas do AWS CDK:

$cdk list

O comando exibe a seguinte lista:

CdkDevopsGuruStackMultiAccReg
CdkDevopsGuruStackMultiAccRegSpecStacks
CdkDevopsguruStackOrgUnit
CdkInfrastructureStack
CdkStackSetAdminRole
CdkStackSetExecRole

Implante as pilhas do AWS CDK para criar perfis do IAM.

Esse padrão usa CloudFormation StackSets a AWS para realizar operações de pilha em várias contas. Se você estiver criando seu primeiro conjunto de pilhas, deverá criar os seguintes perfis do IAM para obter as permissões necessárias configuradas em suas contas da AWS:

Observação: os perfis devem ter esses nomes exatos.

Para obter mais informações, consulte Conceder permissões autogerenciadas na CloudFormation documentação da AWS.

Implante a pilha de CDK da AWS para habilitar o DevOps Guru em várias contas.

A pilha CdkDevopsGuruStackMultiAccReg do AWS CDK cria conjuntos de pilhas para implantar instâncias de pilha em várias contas e regiões. Para implantar a pilha, execute o seguinte comando da CLI com os parâmetros especificados:

$cdk deploy CdkDevopsGuruStackMultiAccReg \
  --profile administrator \
  --parameters AdministratorAccountId=<administrator-account-ID> \
  --parameters TargetAccountId=<target-account-ID> \
  --parameters RegionIds="<region-1>,<region-2>"

Atualmente, o Amazon DevOps Guru está disponível nas regiões da AWS listadas nas perguntas frequentes do DevOps Guru.

Extraia IDs da UO.

No console do AWS Organizations, identifique as IDs das unidades organizacionais nas quais você deseja habilitar o DevOps Guru.

Ative permissões gerenciadas pelo serviço para UOs.

Se você estiver usando o AWS Organizations para gerenciamento de contas, deverá conceder permissões gerenciadas por serviços para habilitar o DevOps Guru. Em vez de criar os perfis do IAM manualmente, use acesso confiável baseado na organização e perfis vinculados a serviços (SLRs).

Implante a pilha de CDK da AWS para habilitar o DevOps Guru em todas as OUs.

A CdkDevopsguruStackOrgUnit pilha de CDK da AWS habilita o serviço DevOps Guru em todas as OUs. Para implantar a pilha, execute o seguinte comando com os parâmetros especificados:

$cdk deploy CdkDevopsguruStackOrgUnit \
  --profile administrator \ 
  --parameters RegionIds="<region-1>,<region-2>" \
  --parameters OrganizationalUnitIds="<OU-1>,<OU-2>"

Implante as pilhas do AWS CDK para criar perfis do IAM.

Se você ainda não criou os perfis do IAM necessários mostrados na primeira opção, faça isso primeiro:

Para obter mais informações, consulte Conceder permissões autogerenciadas na CloudFormation documentação da AWS.

Exclua as pilhas existentes.

Se você já usou a primeira opção para habilitar o DevOps Guru para todos os recursos da pilha, você pode excluir a pilha antiga usando o seguinte comando:

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator 

Ou você pode alterar o parâmetro  RegionIds ao reimplantar a pilha para evitar um erro de As pilhas já existem.

Atualize a pilha do AWS CDK com uma lista de pilhas.

Implante a pilha de CDK da AWS para habilitar o DevOps Guru a usar recursos de pilha específicos em várias contas.

A CdkDevopsGuruStackMultiAccRegSpecStacks pilha de CDK da AWS permite que o DevOps Guru use recursos de pilha específicos em várias contas. Para implantar a pilha, execute o seguinte comando:

$cdk deploy CdkDevopsGuruStackMultiAccRegSpecStacks \
  --profile administrator  \
  --parameters AdministratorAccountId=<administrator-account-ID> \
  --parameters TargetAccountId=<target-account-ID> \
  --parameters RegionIds="<region-1>,<region-2>"

Observação: se você implantou essa pilha anteriormente para a opção 1, altere o parâmetro RegionIds (certificando-se de escolher entre as regiões disponíveis) para evitar um erro de As pilhas já existem.

Implante a pilha de infraestrutura de amostra com tecnologia sem servidor.

O AWS CDK CdkInfrastructureStack stack implanta componentes sem servidor, como API Gateway, Lambda e uma tabela do DynamoDB, para demonstrar os insights do Guru. DevOps Para implantar a pilha, execute o seguinte comando: 

$cdk deploy CdkInfrastructureStack --profile administrator

Insira registros de amostra no DynamoDB.

Execute o comando a seguir para preencher a tabela do DynamoDB com registros de amostra. Forneça o caminho correto para o script populate-shops-dynamodb-table.json.

$aws dynamodb batch-write-item \
  --request-items file://scripts/populate-shops-dynamodb-table.json \
  --profile administrator

O comando exibe a seguinte saída:

{
    "UnprocessedItems": {}
}

Verifique os registros inseridos no DynamoDB.

Para verificar se a tabela do DynamoDB inclui os registros de amostra do arquivo populate-shops-dynamodb-table.json, acesse a URL da API ListRestApiEndpointMonitorOperator, que é publicada como uma saída da pilha do AWS CDK. Você também pode encontrar esse URL na guia Saídas do CloudFormation console da AWS para a CdkInfrastructureStack pilha. A saída do AWS CDK deverá ser semelhante ao seguinte:

CdkInfrastructureStack.CreateRestApiMonitorOperatorEndpointD1D00045 = https://oure17c5vob.execute-api.<your-region>.amazonaws.com/prod/

CdkInfrastructureStack.ListRestApiMonitorOperatorEndpointABBDB8D8 = https://cdff8icfrn4.execute-api.<your-region>.amazonaws.com/prod/

Aguarde até que os recursos concluam a linha de base.

Essa pilha com tecnologia sem servidor tem alguns recursos. Recomendamos que você espere 2 horas antes de realizar as próximas etapas. Se você implantou essa pilha em um ambiente de produção, pode levar até 24 horas para concluir a linha de base, dependendo do número de recursos selecionados para monitorar no Guru. DevOps

Atualize a pilha de infraestrutura do AWS CDK.

Para experimentar o DevOps Guru Insights, você pode fazer algumas alterações na configuração para reproduzir um problema operacional típico.

Injete solicitações de HTTP na API.

Injete tráfego de entrada na forma de solicitações de HTTP na API ListRestApiMonitorOperatorEndpointxxxx:

Analise os insights do DevOps Guru.

Sob condições padrão, o painel do DevOps Guru exibe zero no contador de insights em andamento. Ao detectar uma anomalia, ele emite um alerta na forma de um insight. No painel de navegação, escolha Insights para ver os detalhes da anomalia, incluindo uma visão geral, métricas agregadas, eventos relevantes e recomendações. Para obter mais informações sobre a análise de insights, consulte a postagem do blog Como obter informações operacionais com AIOps usando o Amazon DevOps Guru.

Limpe e exclua recursos.

Depois de percorrer esse padrão, você deve remover os recursos criados para evitar cobranças adicionais. Execute estes comandos:

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator
$cdk destroy CdkDevopsguruStackOrgUnit --profile administrator
$cdk destroy CdkDevopsGuruStackMultiAccRegSpecStacks --profile administrator
$cdk destroy CdkInfrastructureStack --profile administrator
$cdk destroy CdkStackSetAdminRole --profile administrator
$cdk destroy CdkStackSetExecRole --profile administrator
$cdk destroy CdkStackSetExecRole --profile target