Verbessern Sie die betriebliche Leistung, indem Sie Amazon DevOps Guru für mehrere AWS Regionen und Konten aktivieren und OUs mit AWS CDK

Konfigurieren Sie AWS benannte Profile.

Richten Sie Ihre AWS benannten 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 in der AWS CLI Dokumentation unter Verwenden benannter Profile.

Ü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 Toolkits, indem Sie den folgenden Befehl ausführen:

$cdk --version

Für dieses Pattern ist Version 1.107.0 oder höher erforderlich. Wenn Sie eine frühere Version von haben AWSCDK, folgen Sie den Anweisungen in der AWSCDKDokumentation, 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.

$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 SNS Amazon-Benachrichtigungen.

Gehen Sie wie folgt vor, um eine E-Mail-Adresse für SNS Amazon-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 in der Dokumentation unter Deine erste AWS CDK App. AWS CDK

Liste die AWS CDK Stapel auf.

Führen Sie den folgenden Befehl aus, um alle AWS CDK Stapel 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 wird 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:

Weitere Informationen finden Sie in der AWS CloudFormation Dokumentation unter Gewähren von selbstverwalteten Berechtigungen.

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

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

$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 im DevOps Guru aufgeführten AWS Regionen verfügbarFAQ.

Organisationseinheit extrahierenIDs.

Identifizieren Sie in der AWSOrganisationskonsole IDs die Organisationseinheiten, für die Sie DevOps Guru aktivieren möchten.

Aktivieren Sie vom Service verwaltete Berechtigungen fürOUs.

Wenn du AWS Organizations für die Kontoverwaltung verwendest, musst du dienstverwaltete Berechtigungen gewähren, um DevOps Guru zu aktivieren. Anstatt die IAM Rollen manuell zu erstellen, verwende organisationsbasierten vertrauenswürdigen Zugriff und serviceverknüpfte Rollen (). SLRs

Stellen Sie den AWS CDK Stack bereit, um DevOps Guru Across zu aktivierenOUs.

Der AWS CDK CdkDevopsguruStackOrgUnit Stack ermöglicht den gesamten DevOps Guru-ServiceOUs. 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 AWS CloudFormation Dokumentation unter Gewähren von selbstverwalteten 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 CDK CdkDevopsGuruStackMultiAccRegSpecStacks Stack ermöglicht DevOps Guru den Zugriff auf 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>"

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

Der AWS CDK CdkInfrastructureStack 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 for the zu ListRestApiEndpointMonitorOperatorAPI, die als Ausgabe des AWS CDK Stacks veröffentlicht wird. Sie finden dies auch auf URL der Registerkarte Ausgaben der AWS CloudFormation Konsole für den CdkInfrastructureStack Stack. Die AWS CDK Ausgabe würde etwa 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.

Injizieren Sie HTTP Anfragen auf demAPI.

Injizieren Sie eingehenden Datenverkehr in Form von HTTP Anfragen auf dem: ListRestApiMonitorOperatorEndpointxxxx API

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 AIOps mit 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