Mejore el rendimiento operativo habilitando Amazon DevOps Guru en varias regiones y cuentas de AWS y OUs con la CDK de AWS

Configure los perfiles con nombre de AWS.

Configure sus perfiles con nombre de AWS de la siguiente manera para implementar pilas en un entorno de varias cuentas.

Para la cuenta 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 la cuenta 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 obtener más información, consulte Uso de perfiles con nombre en la documentación de la CLI de AWS.

Compruebe las configuraciones de los perfiles de AWS.

(Opcional) Puede verificar las configuraciones de su perfil de AWS en los archivos credentials y config siguiendo las instrucciones en Cómo establecer y ver los ajustes de configuración en la la documentación de la CLI de AWS.

Verifique la versión de AWS CDK.

Compruebe la versión del kit de herramientas de AWS CDK mediante el siguiente comando:

$cdk --version

Este patrón requiere la versión 1.107.0 o posterior. Si tiene una versión anterior de AWS CDK siga las instrucciones de la documentación de AWS CDK para actualizarla.

Clonar el código del proyecto.

Clona el GitHub repositorio de este patrón mediante el comando:

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

Instale las dependencias de los paquetes y compile los TypeScript archivos.

Instale las dependencias del paquete y compile los TypeScript archivos ejecutando los siguientes comandos:

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

Estos comandos instalan todos los paquetes del repositorio de muestra.

$npm ci

—o—

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

Puede encontrar la lista de nombres y versiones de los paquetes en la sección Dependencies del archivo /amazon-devopsguru-cdk-samples/package.json. Para obtener más información, consulte npm ci y npm install en la documentación de npm.

Configure una dirección de correo electrónico para las notificaciones de Amazon SNS.

Siga estos pasos para proporcionar una dirección de correo electrónico para las notificaciones de Amazon SNS:

Construya el código del proyecto.

Cree el código del proyecto y sintetice las pilas ejecutando el comando:

npm run build && cdk synth 

Debería ver una salida similar a esta: 

$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 obtener más información y conocer los pasos, consulte Su primera aplicación de AWS CDK en la documentación de AWS CDK.

Enumere las pilas de CDK de AWS.

Ejecute el siguiente comando para enumerar todas las pilas de AWS CDK:

$cdk list

El comando muestra la lista siguiente:

CdkDevopsGuruStackMultiAccReg
CdkDevopsGuruStackMultiAccRegSpecStacks
CdkDevopsguruStackOrgUnit
CdkInfrastructureStack
CdkStackSetAdminRole
CdkStackSetExecRole

Implemente las pilas de CDK de AWS para crear roles de IAM.

Este patrón utiliza AWS CloudFormation StackSets para realizar operaciones de apilamiento en varias cuentas. Si va a crear su primer conjunto de pilas, debe crear las siguientes funciones de IAM para configurar los permisos necesarios en sus cuentas de AWS:

Para obtener más información, consulte Otorgar permisos autogestionados en la CloudFormation documentación de AWS.

Implemente la pila de CDK de AWS para habilitar DevOps Guru en varias cuentas.

La pila CdkDevopsGuruStackMultiAccReg de CDK de AWS crea conjuntos de pilas para implementar instancias de pila en varias cuentas y regiones. Para implementar la pila, ejecute el siguiente comando de la CLI con los parámetros especificados:

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

Actualmente, Amazon DevOps Guru está disponible en las regiones de AWS que figuran en las preguntas frecuentes de DevOps Guru.

Extrae OU IDs.

En la consola de AWS Organizations, identifique IDs las unidades organizativas en las que quiere habilitar DevOps Guru.

Habilite los permisos administrados por el servicio para. OUs

Si utiliza AWS Organizations para la administración de cuentas, debe conceder permisos gestionados por el servicio para activar DevOps Guru. En lugar de crear las funciones de IAM manualmente, utilice funciones de acceso confiable basadas en la organización y vinculadas a servicios (). SLRs

Implemente la pila de CDK de AWS para permitir que DevOps Guru OUs atraviese.

La CdkDevopsguruStackOrgUnit pila de CDK de AWS permite el servicio DevOps Guru en todas OUs partes. Para implementar la pila, ejecute el siguiente comando con los parámetros especificados:

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

Implemente las pilas de CDK de AWS para crear roles de IAM.

Si aún no ha creado las funciones de IAM requeridas que se muestran en la primera opción, hágalo primero:

Para obtener más información, consulte Otorgar permisos autogestionados en la CloudFormation documentación de AWS.

Eliminar las pilas existentes.

Si ya utilizaste la primera opción para habilitar DevOps Guru para todos los recursos de la pila, puedes eliminar la pila anterior mediante el siguiente comando:

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator 

O bien, puede cambiar el parámetro  RegionIds al volver a implementar la pila para evitar el error Las pilas ya existen.

Actualizar la pila de CDK de AWS con una lista de pilas.

Implemente la pila de CDK de AWS para habilitar a DevOps Guru para disponer de recursos de pila específicos en varias cuentas.

La CdkDevopsGuruStackMultiAccRegSpecStacks pila de CDK de AWS permite a DevOps Guru disponer de recursos de pila específicos en varias cuentas. Para implementar la pila, ejecute el siguiente comando:

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

Implemente el ejemplo del paquete de infraestructura sin servidor.

La CdkInfrastructureStack pila de CDK de AWS implementa componentes sin servidor, como API Gateway, Lambda y una tabla de DynamoDB para mostrar las ideas de Guru. DevOps Para implementar la pila, ejecute el siguiente comando: 

$cdk deploy CdkInfrastructureStack --profile administrator

Introducir registros de ejemplo en DynamoDB.

Ejecute el siguiente comando para rellenar la tabla de DynamoDB con registros de ejemplo. Proporcione la ruta correcta para el script populate-shops-dynamodb-table.json.

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

El comando muestra el resultado siguiente:

{
    "UnprocessedItems": {}
}

Compruebe los registros introducidos en DynamoDB.

Para comprobar que la tabla de DynamoDB incluye los registros de muestra del archivo populate-shops-dynamodb-table.json, acceda a a URL de la API ListRestApiEndpointMonitorOperator, que se publica como salida de la pila de CDK de AWS. También puede encontrar esta URL en la pestaña Salidas de la CloudFormation consola de AWS de la CdkInfrastructureStack pila. La salida de AWS CDK sería similar a la siguiente:

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

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

Espere a que los recursos completen la línea de base.

Esta pila sin servidor tiene algunos recursos. Le recomendamos que espere 2 horas antes de realizar los siguientes pasos. Si implementó esta pila en un entorno de producción, es posible que se tarden hasta 24 horas en completar la línea base, según la cantidad de recursos que haya seleccionado para monitorear en DevOps Guru.

Actualizar la pila de infraestructuras CDK de AWS.

Para probar DevOps Guru Insights, puede realizar algunos cambios de configuración para reproducir un problema operativo típico.

Introduzca solicitudes HTTP en la API.

Inyecta tráfico de entrada en forma de solicitudes HTTP en la API ListRestApiMonitorOperatorEndpointxxxx:

Revise las ideas de DevOps Guru.

En condiciones estándar, el panel de control de DevOps Guru muestra cero en el contador de información continua. Si detecta una anomalía, emite una alerta en forma de información. En el panel de navegación, selecciona Insights para ver los detalles de la anomalía, incluidos un resumen, métricas agregadas, eventos relevantes y recomendaciones. Para obtener más información sobre la revisión de información, consulte la entrada del blog Cómo obtener información operativa AIOps con Amazon DevOps Guru.

Limpie y elimine recursos.

Después de seguir este patrón, debe eliminar los recursos que ha creado para evitar incurrir en cargos adicionales. Ejecute estos 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