Migliora le prestazioni operative abilitando Amazon DevOps Guru su più regioni AWS, account e unità organizzative con AWS CDK

Configura i profili denominati AWS.

Configura i tuoi profili denominati AWS come segue per distribuire gli stack in un ambiente con più account.

Per l'account amministratore:

$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

Per l'account di destinazione:

$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

Per ulteriori informazioni, consulta Using named profiles nella documentazione AWS CLI.

Verifica le configurazioni dei profili AWS.

(Facoltativo) Puoi verificare le configurazioni del tuo profilo AWS nei config file credentials and seguendo le istruzioni in Impostare e visualizzare le impostazioni di configurazione nella documentazione dell'interfaccia a riga di comando di AWS.

Verifica la versione di AWS CDK.

Verifica la versione di AWS CDK Toolkit eseguendo il seguente comando:

$cdk --version

Questo modello richiede la versione 1.107.0 o successiva. Se disponi di una versione precedente di AWS CDK, segui le istruzioni nella documentazione di AWS CDK per aggiornarla.

Clona il codice del progetto.

Clona il GitHub repository per questo pattern usando il comando:

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

Installa le dipendenze dei pacchetti e compila i TypeScript file.

Installa le dipendenze del pacchetto e compila TypeScript i file eseguendo i seguenti comandi:

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

Questi comandi installano tutti i pacchetti dal repository di esempio.

Importante: in caso di errori relativi ai pacchetti mancanti, usa uno dei seguenti comandi:

$npm ci

oppure

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

Puoi trovare l'elenco dei nomi e delle versioni dei pacchetti nella Dependencies sezione del /amazon-devopsguru-cdk-samples/package.json file. Per ulteriori informazioni, vedere npm ci e npm install nella documentazione di npm.

Configura un indirizzo e-mail per le notifiche di Amazon SNS.

Segui questi passaggi per fornire un indirizzo e-mail per le notifiche di Amazon SNS:

Costruisci il codice del progetto.

Crea il codice del progetto e sintetizza gli stack eseguendo il comando:

npm run build && cdk synth 

Verrà visualizzato un output simile al seguente: 

$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.

Per ulteriori informazioni e passaggi, consulta La tua prima app AWS CDK nella documentazione di AWS CDK.

Elenca gli stack CDK AWS.

Esegui il comando seguente per elencare tutti gli stack CDK AWS:

$cdk list

Il comando visualizza il seguente elenco:

CdkDevopsGuruStackMultiAccReg
CdkDevopsGuruStackMultiAccRegSpecStacks
CdkDevopsguruStackOrgUnit
CdkInfrastructureStack
CdkStackSetAdminRole
CdkStackSetExecRole

Implementa gli stack CDK AWS per creare ruoli IAM.

Questo modello utilizza AWS CloudFormation StackSets per eseguire operazioni di stack su più account. Se stai creando il tuo primo set di stack, devi creare i seguenti ruoli IAM per ottenere le autorizzazioni richieste nei tuoi account AWS:

Nota: i ruoli devono avere questi nomi esatti.

Per ulteriori informazioni, consulta Concedere autorizzazioni autogestite nella documentazione CloudFormation AWS.

Implementa lo stack AWS CDK per abilitare DevOps Guru su più account.

Lo CdkDevopsGuruStackMultiAccReg stack CDK di AWS crea set di stack per distribuire istanze di stack su più account e regioni. Per distribuire lo stack, esegui il seguente comando CLI con i parametri specificati:

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

Attualmente Amazon DevOps Guru è disponibile nelle regioni AWS elencate nelle domande frequenti su DevOps Guru.

Estrai gli ID OU.

Sulla console AWS Organizations, identifica gli ID delle unità organizzative in cui desideri abilitare DevOps Guru.

Abilita le autorizzazioni gestite dal servizio per le unità organizzative.

Se utilizzi AWS Organizations per la gestione degli account, devi concedere le autorizzazioni gestite dal servizio per abilitare Guru. DevOps Invece di creare i ruoli IAM manualmente, utilizza ruoli di accesso affidabile e ruoli collegati ai servizi (SLR) basati sull'organizzazione.

Implementa lo stack AWS CDK per abilitare DevOps Guru su tutte le unità organizzative.

Lo CdkDevopsguruStackOrgUnit stack CDK AWS abilita il servizio DevOps Guru su tutte le unità organizzative. Per distribuire lo stack, esegui il seguente comando con i parametri specificati:

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

Implementa gli stack CDK AWS per creare ruoli IAM.

Se non hai ancora creato i ruoli IAM richiesti mostrati nella prima opzione, fallo prima:

Per ulteriori informazioni, consulta Concedere autorizzazioni autogestite nella documentazione CloudFormation AWS.

Elimina le pile esistenti.

Se hai già utilizzato la prima opzione per abilitare DevOps Guru per tutte le risorse dello stack, puoi eliminare il vecchio stack usando il seguente comando:

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator 

In alternativa, puoi modificare il  RegionIds parametro quando ridistribuisci lo stack per evitare che si verifichi un errore Stacks already exist.

Aggiorna lo stack CDK AWS con un elenco di stack.

Implementa lo stack AWS CDK per abilitare DevOps Guru per risorse stack specifiche su più account.

Lo CdkDevopsGuruStackMultiAccRegSpecStacks stack AWS CDK consente a DevOps Guru di utilizzare risorse stack specifiche su più account. Per distribuire lo stack, esegui il seguente comando:

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

Nota: se in precedenza hai distribuito questo stack per l'opzione 1, modifica il RegionIds parametro (assicurandoti di scegliere tra le regioni disponibili) per evitare che gli stack esistano già.

Implementa lo stack di infrastruttura serverless di esempio.

Lo CdkInfrastructureStack stack CDK di AWS implementa componenti serverless come API Gateway, Lambda e una tabella DynamoDB per illustrare le intuizioni di Guru. DevOps Per distribuire lo stack, esegui il seguente comando: 

$cdk deploy CdkInfrastructureStack --profile administrator

Inserisci record di esempio in DynamoDB.

Esegui il comando seguente per popolare la tabella DynamoDB con record di esempio. Fornisci il percorso corretto per lo script. populate-shops-dynamodb-table.json

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

Il comando visualizza il seguente output:

{
    "UnprocessedItems": {}
}

Verifica i record inseriti in DynamoDB.

Per verificare che la tabella DynamoDB includa populate-shops-dynamodb-table.json i record di esempio del file, accedi all'URL dell'API, che viene pubblicato come output ListRestApiEndpointMonitorOperator dello stack CDK di AWS. Puoi trovare questo URL anche nella scheda Outputs della CloudFormation console AWS per lo CdkInfrastructureStack stack. L'output di AWS CDK sarebbe simile al seguente:

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

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

Attendi che le risorse completino la linea di base.

Questo stack serverless ha poche risorse. Ti consigliamo di attendere 2 ore prima di eseguire i passaggi successivi. Se hai distribuito questo stack in un ambiente di produzione, potrebbero essere necessarie fino a 24 ore per completare la baseline, a seconda del numero di risorse che hai selezionato per il monitoraggio in Guru. DevOps

Aggiorna lo stack di infrastruttura AWS CDK.

Per provare DevOps Guru Insights, puoi apportare alcune modifiche alla configurazione per riprodurre un tipico problema operativo.

Inietta le richieste HTTP sull'API.

Inietta il traffico in ingresso sotto forma di richieste HTTP sull'API: ListRestApiMonitorOperatorEndpointxxxx

Rivedi le informazioni su DevOps Guru.

In condizioni standard, la dashboard di DevOps Guru mostra zero nel contatore delle informazioni in corso. Se rileva un'anomalia, genera un avviso sotto forma di intuizione. Nel riquadro di navigazione, scegli Insights per visualizzare i dettagli dell'anomalia, tra cui una panoramica, metriche aggregate, eventi pertinenti e consigli. Per ulteriori informazioni sulla revisione degli approfondimenti, consulta il post del blog Gathering operating insights with AIOps using Amazon DevOps Guru.

Pulisci ed elimina le risorse.

Dopo aver seguito questo schema, dovresti rimuovere le risorse che hai creato per evitare di incorrere in ulteriori addebiti. Esegui questi comandi:

$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