Verbessern Sie die Betriebsleistung, indem Sie Amazon DevOps Guru mit dem AWS CDK für mehrere AWS-Regionen, Konten und Organisationseinheiten aktivieren

Konfigurieren Sie benannte AWS-Profile.

Richten Sie Ihre benannten AWS-Profile wie folgt ein, um Stacks in einer Umgebung mit mehreren Konten bereitzustellen.

Für das Administratorkonto:

$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

Für das Zielkonto:

$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

Weitere Informationen finden Sie unter Verwenden von benannten Profilen in der AWS-CLI-Dokumentation.

Überprüfen Sie die AWS-Profilkonfigurationen.

(Optional) Sie können Ihre AWS-Profilkonfigurationen in den config Dateien credentials und überprüfen, indem Sie den Anweisungen unter Konfigurationseinstellungen einrichten und anzeigen in der AWS-CLI-Dokumentation folgen.

Überprüfen Sie die AWS-CDK-Version.

Überprüfen Sie die Version des AWS CDK Toolkit, indem Sie den folgenden Befehl ausführen:

$cdk --version

Für dieses Muster ist Version 1.107.0 oder höher erforderlich. Wenn Sie eine frühere Version von AWS CDK haben, folgen Sie den Anweisungen in der AWS CDK-Dokumentation, um sie zu aktualisieren.

Klonen Sie den Projektcode.

Klonen Sie das GitHub Repository für dieses Muster mit dem folgenden Befehl:

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

Installieren Sie die Paketabhängigkeiten und kompilieren Sie die TypeScript Dateien.

Installieren Sie die Paketabhängigkeiten und kompilieren Sie die TypeScript Dateien, indem Sie die folgenden Befehle ausführen:

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

Mit diesen Befehlen werden alle Pakete aus dem Beispiel-Repository installiert.

Wichtig: Wenn Sie eine Fehlermeldung über fehlende Pakete erhalten, verwenden Sie einen der folgenden Befehle:

$npm ci

–oder–

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

Die Liste der Paketnamen und Versionen finden Sie im Dependencies Abschnitt der /amazon-devopsguru-cdk-samples/package.json Datei. Weitere Informationen finden Sie unter npm ci und npm install in der npm-Dokumentation.

Konfigurieren Sie eine E-Mail-Adresse für Amazon SNS SNS-Benachrichtigungen.

Gehen Sie wie folgt vor, um eine E-Mail-Adresse für Amazon SNS SNS-Benachrichtigungen anzugeben:

Erstellen Sie den Projektcode.

Erstellen Sie den Projektcode und synthetisieren Sie die Stacks, indem Sie den folgenden Befehl ausführen:

npm run build && cdk synth 

Die Ausgabe sollte folgendermaßen oder ähnlich aussehen: 

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

Weitere Informationen und Schritte finden Sie unter Ihre erste AWS-CDK-App in der AWS-CDK-Dokumentation.

Listet die AWS CDK-Stacks auf.

Führen Sie den folgenden Befehl aus, um alle AWS-CDK-Stacks aufzulisten:

$cdk list

Der Befehl zeigt die folgende Liste an:

CdkDevopsGuruStackMultiAccReg
CdkDevopsGuruStackMultiAccRegSpecStacks
CdkDevopsguruStackOrgUnit
CdkInfrastructureStack
CdkStackSetAdminRole
CdkStackSetExecRole

Stellen Sie die AWS CDK-Stacks für die Erstellung von IAM-Rollen bereit.

Dieses Muster verwendet AWS CloudFormation StackSets, um Stack-Operationen über mehrere Konten hinweg durchzuführen. Wenn Sie Ihr erstes Stack-Set erstellen, müssen Sie die folgenden IAM-Rollen erstellen, um die erforderlichen Berechtigungen in Ihren AWS-Konten einzurichten:

Hinweis: Die Rollen müssen genau diese Namen haben.

Weitere Informationen finden Sie in der CloudFormation AWS-Dokumentation unter Gewähren selbstverwalteter Berechtigungen.

Stellen Sie den AWS CDK-Stack bereit, um DevOps Guru für mehrere Konten zu aktivieren.

Der AWS CdkDevopsGuruStackMultiAccReg CDK-Stack erstellt Stack-Sets zur Bereitstellung von Stack-Instances über mehrere Konten und Regionen hinweg. Führen Sie den folgenden CLI-Befehl mit den angegebenen Parametern aus, um den Stack bereitzustellen:

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

Derzeit ist Amazon DevOps Guru in den AWS-Regionen verfügbar, die in den häufig gestellten Fragen zu DevOps Guru aufgeführt sind.

Extrahieren Sie OU-IDs.

Identifizieren Sie in der AWS Organizations Organizations-Konsole die IDs der Organisationseinheiten, für die Sie DevOps Guru aktivieren möchten.

Aktivieren Sie vom Service verwaltete Berechtigungen für Organisationseinheiten.

Wenn Sie AWS Organizations für die Kontoverwaltung verwenden, müssen Sie service-verwaltete Berechtigungen gewähren, um DevOps Guru zu aktivieren. Anstatt die IAM-Rollen manuell zu erstellen, verwenden Sie organisationsbasierte vertrauenswürdige Zugriffs- und Service-Linked Roles (SLRs).

Stellen Sie den AWS CDK-Stack bereit, um DevOps Guru in allen Organisationseinheiten zu aktivieren.

Der AWS CdkDevopsguruStackOrgUnit CDK-Stack ermöglicht den DevOps Guru-Service in allen Organisationseinheiten. Um den Stack bereitzustellen, führen Sie den folgenden Befehl mit den angegebenen Parametern aus:

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

Stellen Sie die AWS CDK-Stacks für die Erstellung von IAM-Rollen bereit.

Wenn Sie die in der ersten Option aufgeführten erforderlichen IAM-Rollen noch nicht erstellt haben, tun Sie dies zuerst:

Weitere Informationen finden Sie in der CloudFormation AWS-Dokumentation unter Gewähren selbstverwalteter Berechtigungen.

Löschen Sie vorhandene Stapel.

Wenn Sie bereits die erste Option verwendet haben, um DevOps Guru für alle Stack-Ressourcen zu aktivieren, können Sie den alten Stack mit dem folgenden Befehl löschen:

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator 

Sie können den  RegionIds Parameter auch ändern, wenn Sie den Stack erneut bereitstellen, um den Fehler Stacks already exist zu vermeiden.

Aktualisieren Sie den AWS CDK-Stack mit einer Stack-Liste.

Stellen Sie den AWS CDK-Stack bereit, um DevOps Guru für bestimmte Stack-Ressourcen über mehrere Konten hinweg zu aktivieren.

Der AWS CdkDevopsGuruStackMultiAccRegSpecStacks CDK-Stack ermöglicht DevOps Guru für bestimmte Stack-Ressourcen über mehrere Konten hinweg. Führen Sie den folgenden Befehl aus, um den Stack bereitzustellen:

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

Hinweis: Wenn Sie diesen Stack bereits für Option 1 bereitgestellt haben, ändern Sie den RegionIds Parameter (stellen Sie sicher, dass Sie aus verfügbaren Regionen wählen), um den Fehler Stacks already exist zu vermeiden.

Stellen Sie das Beispiel für einen serverlosen Infrastrukturstapel bereit.

Der CdkInfrastructureStack AWS-CDK-Stack stellt serverlose Komponenten wie API Gateway, Lambda und eine DynamoDB-Tabelle bereit, um die Erkenntnisse von Guru zu demonstrieren. DevOps Führen Sie den folgenden Befehl aus, um den Stack bereitzustellen: 

$cdk deploy CdkInfrastructureStack --profile administrator

Fügen Sie Beispieldatensätze in DynamoDB ein.

Führen Sie den folgenden Befehl aus, um die DynamoDB-Tabelle mit Beispieldatensätzen zu füllen. Geben Sie den richtigen Pfad für das Skript an. populate-shops-dynamodb-table.json

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

Die Ausgabe des Befehls sieht wie folgt aus:

{
    "UnprocessedItems": {}
}

Überprüfen Sie die eingefügten Datensätze in DynamoDB.

Um zu überprüfen, ob die DynamoDB-Tabelle die Beispieldatensätze aus der populate-shops-dynamodb-table.json Datei enthält, greifen Sie auf die URL für die ListRestApiEndpointMonitorOperator API zu, die als Ausgabe des AWS-CDK-Stacks veröffentlicht wird. Sie finden diese URL auch auf der Registerkarte Outputs der CloudFormation AWS-Konsole für den CdkInfrastructureStack Stack. Die AWS-CDK-Ausgabe würde wie folgt aussehen:

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

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

Warten Sie, bis die Ressourcen das Baselining abgeschlossen haben.

Dieser serverlose Stack hat einige Ressourcen. Wir empfehlen, dass Sie 2 Stunden warten, bevor Sie die nächsten Schritte ausführen. Wenn Sie diesen Stack in einer Produktionsumgebung bereitgestellt haben, kann es bis zu 24 Stunden dauern, bis das Baselining abgeschlossen ist. Dies hängt von der Anzahl der Ressourcen ab, die Sie in DevOps Guru für die Überwachung ausgewählt haben.

Aktualisieren Sie den AWS CDK-Infrastruktur-Stack.

Um DevOps Guru Insights auszuprobieren, können Sie einige Konfigurationsänderungen vornehmen, um ein typisches Betriebsproblem zu reproduzieren.

Fügen Sie HTTP-Anfragen in die API ein.

Fügen Sie eingehenden Datenverkehr in Form von HTTP-Anfragen in die API ein: ListRestApiMonitorOperatorEndpointxxxx

Sehen Sie sich DevOps Guru Insights an.

Unter Standardbedingungen zeigt das DevOps Guru-Dashboard im Zähler für laufende Einblicke Null an. Wenn es eine Anomalie erkennt, gibt es eine Warnung in Form eines Einblicks aus. Wählen Sie im Navigationsbereich Insights aus, um die Details der Anomalie anzuzeigen, einschließlich einer Übersicht, aggregierter Kennzahlen, relevanter Ereignisse und Empfehlungen. Weitere Informationen zur Überprüfung von Erkenntnissen finden Sie im Blogbeitrag Gewinnen betrieblicher Erkenntnisse mit AIOps mithilfe von Amazon DevOps Guru.

Ressourcen bereinigen und löschen.

Nachdem Sie dieses Muster durchgegangen sind, sollten Sie die von Ihnen erstellten Ressourcen entfernen, um weitere Kosten zu vermeiden. Führen Sie die folgenden Befehle aus:

$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