Migliora le prestazioni operative abilitando Amazon DevOps Guru su più regioni AWS, account e OUs 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.

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

Crea 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:

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.

Estrarre OU IDs.

Sulla console AWS Organizations, identifica IDs le unità organizzative in cui desideri abilitare DevOps Guru.

Abilita le autorizzazioni gestite dal servizio per. OUs

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 collegati ai servizi basati sull'organizzazione (). SLRs

Implementa lo stack AWS CDK per abilitare DevOps Guru Across. OUs

Lo CdkDevopsguruStackOrgUnit stack CDK AWS abilita il servizio DevOps Guru in tutto il mondo. OUs 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>"

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 i record di esempio populate-shops-dynamodb-table.json del file, accedi all'URL ListRestApiEndpointMonitorOperator dell'API, che viene pubblicato come output dello stack CDK 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 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 Gaining operating insights with AIOps 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