Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Améliorez les performances opérationnelles en activant Amazon DevOps Guru dans plusieurs régions AWS, sur plusieurs comptes et OUs avec le kit AWS CDK
*M. Rahul Sharad Gaikwad, Amazon Web Services*
## Résumé
Ce modèle décrit les étapes à suivre pour activer le service Amazon DevOps Guru dans plusieurs régions, comptes et unités organisationnelles Amazon Web Services (AWSOUs) à l'aide du kit de développement AWS Cloud (AWS CDK) dans TypeScript. Vous pouvez utiliser les piles AWS CDK pour déployer AWS CloudFormation StackSets depuis le compte AWS de l'administrateur (principal) afin d'activer Amazon DevOps Guru sur plusieurs comptes, au lieu de vous connecter à chaque compte et d'activer DevOps Guru individuellement pour chaque compte.
Amazon DevOps Guru fournit des fonctionnalités d'intelligence artificielle (AIOps) pour vous aider à améliorer la disponibilité de vos applications et à résoudre les problèmes opérationnels plus rapidement. DevOps Guru réduit vos efforts manuels en appliquant des recommandations basées sur l'apprentissage automatique (ML), sans aucune expertise en ML. DevOps Guru analyse vos ressources et vos données opérationnelles. S'il détecte des anomalies, il fournit des mesures, des événements et des recommandations pour vous aider à résoudre le problème.
Ce modèle décrit trois options de déploiement pour activer Amazon DevOps Guru :
+ Pour toutes les ressources cumulées sur plusieurs comptes et régions
+ Pour toutes les ressources empilées OUs
+ Pour des ressources de stockage spécifiques sur plusieurs comptes et régions
## Conditions préalables et limitations
**Conditions préalables**
+ Un compte AWS actif.
+ Interface de ligne de commande AWS (AWS CLI), installée et configurée. (Voir [Installation, mise à jour et désinstallation de l'interface de ligne de commande AWS dans la](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) documentation de l'interface de ligne de commande AWS.)
+ AWS CDK Toolkit, installé et configuré. (Voir le [kit d'outils AWS CDK](https://docs.aws.amazon.com/cdk/latest/guide/cli.html) dans la documentation AWS CDK.)
+ Node Package Manager (npm), installé et configuré pour le AWS CDK dans. TypeScript (Voir [Téléchargement et installation de Node.js et de npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) dans la documentation de npm.)
+ Python3 installé et configuré, pour exécuter un script Python afin d'injecter du trafic dans l'exemple d'application sans serveur. (Voir [Configuration et utilisation de Python](https://docs.python.org/3/using/index.html) dans la documentation Python.)
+ Pip, installé et configuré pour installer la bibliothèque de requêtes Python. (Voir les [instructions d'installation de pip](https://pypi.org/project/pip/) sur le PyPl site Web.)
**Versions du produit**
+ AWS CDK Toolkit version 1.107.0 ou ultérieure
+ npm version 7.9.0 ou ultérieure
+ Node.js version 15.3.0 ou ultérieure
## Architecture
**Technologies**
L'architecture de ce modèle inclut les services suivants :
+ [Amazon DevOps Guru](https://aws.amazon.com/devops-guru/)
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
+ [Amazon API Gateway](https://aws.amazon.com/api-gateway/)
+ [AWS Lambda](https://aws.amazon.com/lambda/)
+ [Amazon DynamoDB](https://aws.amazon.com/dynamodb/)
+ [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/)
+ [AWS CloudTrail](https://aws.amazon.com/cloudtrail/)
**Piles de kits de développement AWS**
Le modèle utilise les piles AWS CDK suivantes :
+ `CdkStackSetAdminRole`— Crée un rôle d'administrateur AWS Identity and Access Management (IAM) afin d'établir une relation de confiance entre l'administrateur et les comptes cibles.
+ `CdkStackSetExecRole`— Crée un rôle IAM pour faire confiance au compte administrateur.
+ `CdkDevopsGuruStackMultiAccReg`— Active DevOps Guru dans plusieurs régions et comptes AWS pour toutes les piles, et configure les notifications Amazon Simple Notification Service (Amazon SNS).
+ `CdkDevopsGuruStackMultiAccRegSpecStacks`— Active DevOps Guru dans plusieurs régions AWS et compte pour des stacks spécifiques, et configure les notifications Amazon SNS.
+ `CdkDevopsguruStackOrgUnit`— Permet à DevOps Guru de OUs passer et de configurer les notifications Amazon SNS.
+ `CdkInfrastructureStack`— Déploie des exemples de composants d'application sans serveur tels que API Gateway, Lambda et DynamoDB dans le compte administrateur pour démontrer l'injection de défauts et la génération d'informations.
**Exemple d'architecture d'application**
Le schéma suivant illustre l'architecture d'un exemple d'application sans serveur qui a été déployée sur plusieurs comptes et régions. Le modèle utilise le compte administrateur pour déployer toutes les piles AWS CDK. Il utilise également le compte administrateur comme l'un des comptes cibles pour configurer DevOps Guru.
1. Lorsque DevOps Guru est activé, il définit d'abord le comportement de chaque ressource comme base de référence, puis ingère les données opérationnelles issues des métriques vendues CloudWatch .
1. S'il détecte une anomalie, il la met en corrélation avec les événements qui en découlent CloudTrail et génère un aperçu.
1. Les informations fournissent une séquence d'événements corrélée ainsi que des recommandations prescrites pour permettre à l'opérateur d'identifier la ressource responsable.
1. Amazon SNS envoie des messages de notification à l'opérateur.
![\[Exemple d'application sans serveur déployée sur plusieurs comptes et régions.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/images/pattern-img/6075ca48-862a-4aa0-93c6-10bad8195a5c/images/beeb0992-aaa8-4f08-b983-685b6b8b8d5e.png)
**Automatisation et mise à l'échelle**
Le [GitHub référentiel](https://github.com/aws-samples/amazon-devopsguru-cdk-samples.git) fourni avec ce modèle utilise le AWS CDK comme outil d'infrastructure en tant que code (IAc) pour créer la configuration de cette architecture. AWS CDK vous aide à orchestrer les ressources et à activer DevOps Guru sur plusieurs comptes AWS, régions et. OUs
## Outils
**Services AWS**
+ [AWS CDK](https://docs.aws.amazon.com/cdk/latest/guide/home.html) — AWS Cloud Development Kit (AWS CDK) vous aide à définir votre infrastructure cloud sous forme de code dans l'un des cinq langages de programmation pris en charge : JavaScript Python TypeScript, Java et C\$1.
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) — AWS Command Line Interface (AWS CLI) est un outil unifié qui fournit une interface de ligne de commande cohérente pour interagir avec les services et ressources AWS.
**Code**
Le code source de ce modèle est disponible sur GitHub, dans le référentiel [Amazon DevOps Guru CDK Samples](https://github.com/aws-samples/amazon-devopsguru-cdk-samples.git). Le code AWS CDK est écrit dedans. TypeScript Pour cloner et utiliser le référentiel, suivez les instructions de la section suivante.
**Important**
Certains des articles de ce modèle incluent des exemples de commandes AWS CDK et AWS CLI formatés pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation de la barre oblique inverse (\$1) à la fin de chaque ligne par un curseur (^).
## Épopées
### Préparer les ressources AWS pour le déploiement
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Configurez les profils nommés AWS. | Configurez vos profils nommés AWS comme suit pour déployer des stacks dans un environnement multi-comptes.Pour le compte administrateur :$aws configure --profile administrator
AWS Access Key ID [****]:
AWS Secret Access Key [****]:
Default region name [None]:
Default output format [None]: json
Pour le compte cible :$aws configure --profile target
AWS Access Key ID [****:
AWS Secret Access Key [****]:
Default region name [None]:
Default output format [None]: json
Pour plus d'informations, consultez la section [Utilisation de profils nommés](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-using-profiles) dans la documentation de l'AWS CLI. | DevOps ingénieur |
| Vérifiez les configurations des profils AWS. | (Facultatif) Vous pouvez vérifier les configurations de votre profil AWS dans les `config` fichiers `credentials` et en suivant les instructions de la section [Définir et afficher les paramètres de configuration](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-methods) dans la documentation de l'AWS CLI. | DevOps ingénieur |
| Vérifiez la version du kit AWS CDK. | Vérifiez la version du kit d'outils AWS CDK en exécutant la commande suivante :$cdk --version
Ce modèle nécessite la version 1.107.0 ou ultérieure. Si vous disposez d'une version antérieure du CDK AWS, suivez les instructions de la [documentation du CDK AWS](https://docs.aws.amazon.com/cdk/latest/guide/cli.html) pour la mettre à jour. | DevOps ingénieur |
| Clonez le code du projet. | Clonez le GitHub référentiel pour ce modèle à l'aide de la commande :$git clone https://github.com/aws-samples/amazon-devopsguru-cdk-samples.git
| DevOps ingénieur |
| Installez les dépendances du package et compilez les TypeScript fichiers. | Installez les dépendances du package et compilez les TypeScript fichiers en exécutant les commandes suivantes :$cd amazon-devopsguru-cdk-samples
$npm install
$npm fund
Ces commandes installent tous les packages du référentiel d'échantillons.Si des erreurs apparaissent concernant des packages manquants, utilisez l'une des commandes suivantes :$npm ci
—ou—$npm install -g @aws-cdk/
Vous trouverez la liste des noms et des versions des packages dans la `Dependencies` section du `/amazon-devopsguru-cdk-samples/package.json` fichier. Pour plus d'informations, consultez [npm ci](https://docs.npmjs.com/cli/v7/commands/npm-ci) et [npm install](https://docs.npmjs.com/cli/v7/commands/npm-install) dans la documentation de npm. | DevOps ingénieur |
### Créez (synthétisez) les piles AWS CDK
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Configurez une adresse e-mail pour les notifications Amazon SNS. | Suivez ces étapes pour fournir une adresse e-mail pour les notifications Amazon SNS :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/improve-operational-performance-by-enabling-amazon-devops-guru-across-multiple-aws-regions-accounts-and-ous-with-the-aws-cdk.html) | DevOps ingénieur |
| Créez le code du projet. | Créez le code du projet et synthétisez les piles en exécutant la commande suivante :npm run build && cdk synth
Vous devez voir des résultats similaires à ce qui suit : $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.
Pour plus d'informations et pour connaître les étapes à suivre, consultez [Votre première application AWS CDK](https://docs.aws.amazon.com/cdk/latest/guide/hello_world.html) dans la documentation AWS CDK. | DevOps ingénieur |
| Répertoriez les piles de CDK AWS. | Exécutez la commande suivante pour répertorier toutes les piles AWS CDK :$cdk list
La commande affiche la liste suivante :CdkDevopsGuruStackMultiAccReg
CdkDevopsGuruStackMultiAccRegSpecStacks
CdkDevopsguruStackOrgUnit
CdkInfrastructureStack
CdkStackSetAdminRole
CdkStackSetExecRole
| DevOps ingénieur |
### Option 1 - Activez DevOps Guru pour toutes les ressources de pile sur plusieurs comptes
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Déployez les piles AWS CDK pour créer des rôles IAM. | Ce modèle utilise [AWS CloudFormation StackSets](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html) pour effectuer des opérations de stack sur plusieurs comptes. Si vous créez votre premier stack set, vous devez créer les rôles IAM suivants pour obtenir les autorisations requises configurées dans vos comptes AWS :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/improve-operational-performance-by-enabling-amazon-devops-guru-across-multiple-aws-regions-accounts-and-ous-with-the-aws-cdk.html)Les rôles doivent porter ces noms exacts.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/improve-operational-performance-by-enabling-amazon-devops-guru-across-multiple-aws-regions-accounts-and-ous-with-the-aws-cdk.html)Pour plus d'informations, consultez la section [Accorder des autorisations autogérées](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html) dans la CloudFormation documentation AWS. | DevOps ingénieur |
| Déployez la pile AWS CDK pour activer DevOps Guru sur plusieurs comptes. | La `CdkDevopsGuruStackMultiAccReg` pile AWS CDK crée des ensembles de piles pour déployer des instances de pile sur plusieurs comptes et régions. Pour déployer la pile, exécutez la commande CLI suivante avec les paramètres spécifiés :$cdk deploy CdkDevopsGuruStackMultiAccReg \
--profile administrator \
--parameters AdministratorAccountId= \
--parameters TargetAccountId= \
--parameters RegionIds=","
Amazon DevOps Guru est actuellement disponible dans les régions AWS répertoriées dans la [FAQ DevOps Guru](https://aws.amazon.com/devops-guru/faqs/). | DevOps ingénieur |
### Option 2 - Activez DevOps Guru pour toutes les ressources de la pile OUs
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Extrayez l'OU IDs. | Sur la console [AWS Organizations](https://console.aws.amazon.com/organizations/v2/home/accounts), identifiez IDs les unités organisationnelles dans lesquelles vous souhaitez activer DevOps Guru. | DevOps ingénieur |
| Activez les autorisations gérées par le service pour. OUs | Si vous utilisez AWS Organizations pour la gestion de votre compte, vous devez accorder des autorisations gérées par le service pour activer DevOps Guru. Au lieu de créer les rôles IAM manuellement, utilisez un [accès sécurisé basé sur l'organisation et des rôles liés à un service](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-enable-trusted-access.html) (). SLRs | DevOps ingénieur |
| Déployez la pile AWS CDK pour permettre à DevOps Guru de passer à travers. OUs | La `CdkDevopsguruStackOrgUnit` pile AWS CDK permet d'étendre le service DevOps Guru. OUs Pour déployer la pile, exécutez la commande suivante avec les paramètres spécifiés :$cdk deploy CdkDevopsguruStackOrgUnit \
--profile administrator \
--parameters RegionIds="," \
--parameters OrganizationalUnitIds=","
| DevOps ingénieur |
### Option 3 - Activez DevOps Guru pour des ressources de pile spécifiques sur plusieurs comptes
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Déployez les piles AWS CDK pour créer des rôles IAM. | Si vous n'avez pas encore créé les rôles IAM requis indiqués dans la première option, faites-le d'abord :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/improve-operational-performance-by-enabling-amazon-devops-guru-across-multiple-aws-regions-accounts-and-ous-with-the-aws-cdk.html)Pour plus d'informations, consultez la section [Accorder des autorisations autogérées](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html) dans la CloudFormation documentation AWS. | DevOps ingénieur |
| Supprimez les piles existantes. | Si vous avez déjà utilisé la première option pour activer DevOps Guru pour toutes les ressources de la pile, vous pouvez supprimer l'ancienne pile en utilisant la commande suivante :$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator
Vous pouvez également modifier le ` RegionIds` paramètre lorsque vous redéployez la pile pour éviter une erreur *Stacks already exist.* | DevOps ingénieur |
| Mettez à jour la pile AWS CDK avec une liste de piles. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/improve-operational-performance-by-enabling-amazon-devops-guru-across-multiple-aws-regions-accounts-and-ous-with-the-aws-cdk.html) | Ingénieur de données |
| Déployez la pile AWS CDK pour permettre à DevOps Guru d'accéder à des ressources de pile spécifiques sur plusieurs comptes. | La `CdkDevopsGuruStackMultiAccRegSpecStacks` pile AWS CDK permet à DevOps Guru d'accéder à des ressources de pile spécifiques sur plusieurs comptes. Pour déployer la pile, exécutez la commande suivante :$cdk deploy CdkDevopsGuruStackMultiAccRegSpecStacks \
--profile administrator \
--parameters AdministratorAccountId= \
--parameters TargetAccountId= \
--parameters RegionIds=","
Si vous avez déjà déployé cette pile pour l'option 1, modifiez le `RegionIds` paramètre (en veillant à choisir parmi [les régions disponibles](https://aws.amazon.com/devops-guru/faqs/)) pour éviter une erreur *Stacks already exist*. | DevOps ingénieur |
### Déployez la pile d'infrastructure AWS CDK
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Déployez l'exemple de pile d'infrastructure sans serveur. | La `CdkInfrastructureStack` pile AWS CDK déploie des composants sans serveur tels qu'API Gateway, Lambda et une table DynamoDB pour illustrer les connaissances de Guru. DevOps Pour déployer la pile, exécutez la commande suivante : $cdk deploy CdkInfrastructureStack --profile administrator
| DevOps ingénieur |
| Insérez des exemples d'enregistrements dans DynamoDB. | Exécutez la commande suivante pour remplir la table DynamoDB avec des exemples d'enregistrements. Indiquez le chemin correct pour le `populate-shops-dynamodb-table.json` script.$aws dynamodb batch-write-item \
--request-items file://scripts/populate-shops-dynamodb-table.json \
--profile administrator
La commande affiche la sortie suivante :{
"UnprocessedItems": {}
} | DevOps ingénieur |
| Vérifiez les enregistrements insérés dans DynamoDB. | Pour vérifier que la table DynamoDB inclut les exemples d'enregistrements du fichier, accédez à `populate-shops-dynamodb-table.json` l'URL de `ListRestApiEndpointMonitorOperator` l'API, qui est publiée en tant que sortie de la pile AWS CDK. Vous pouvez également trouver cette URL dans l'onglet **Outputs** de la CloudFormation console AWS pour la `CdkInfrastructureStack` pile. La sortie du AWS CDK ressemblerait à ce qui suit :CdkInfrastructureStack.CreateRestApiMonitorOperatorEndpointD1D00045 = https://oure17c5vob.execute-api..amazonaws.com/prod/
CdkInfrastructureStack.ListRestApiMonitorOperatorEndpointABBDB8D8 = https://cdff8icfrn4.execute-api..amazonaws.com/prod/
| DevOps ingénieur |
| Attendez que les ressources aient terminé la définition de base. | Cette pile sans serveur dispose de quelques ressources. Nous vous recommandons d'attendre 2 heures avant de passer aux étapes suivantes. Si vous avez déployé cette pile dans un environnement de production, l'établissement de la base de référence peut prendre jusqu'à 24 heures, en fonction du nombre de ressources que vous avez sélectionné pour surveiller dans DevOps Guru. | DevOps ingénieur |
### Générez des informations sur DevOps Guru
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Mettez à jour la pile d'infrastructure AWS CDK. | Pour essayer DevOps Guru Insights, vous pouvez apporter des modifications de configuration afin de reproduire un problème de fonctionnement typique.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/improve-operational-performance-by-enabling-amazon-devops-guru-across-multiple-aws-regions-accounts-and-ous-with-the-aws-cdk.html) | DevOps ingénieur |
| Injectez des requêtes HTTP sur l'API. | Injectez du trafic entrant sous forme de requêtes HTTP sur l'`ListRestApiMonitorOperatorEndpointxxxx`API :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/improve-operational-performance-by-enabling-amazon-devops-guru-across-multiple-aws-regions-accounts-and-ous-with-the-aws-cdk.html) | DevOps ingénieur |
| Passez en revue DevOps Guru Insights. | Dans des conditions standard, le tableau de bord DevOps Guru affiche zéro dans le compteur d'informations continues. S'il détecte une anomalie, il déclenche une alerte sous forme d'aperçu. Dans le volet de navigation, choisissez **Insights** pour voir les détails de l'anomalie, notamment une vue d'ensemble, des mesures agrégées, des événements pertinents et des recommandations. Pour plus d'informations sur l'examen des informations, consultez le billet de blog [Obtenir des informations opérationnelles AIOps grâce à Amazon DevOps Guru](https://aws.amazon.com/blogs/devops/gaining-operational-insights-with-aiops-using-amazon-devops-guru/). | DevOps ingénieur |
### Nettoyage
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Nettoyez et supprimez les ressources. | Après avoir suivi ce schéma, vous devez supprimer les ressources que vous avez créées pour éviter d'encourir des frais supplémentaires. Exécutez les commandes suivantes :$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
| DevOps ingénieur |
## Ressources connexes
+ [Obtenir des informations opérationnelles AIOps grâce à Amazon DevOps Guru](https://aws.amazon.com/blogs/devops/gaining-operational-insights-with-aiops-using-amazon-devops-guru/)
+ [Configurez facilement Amazon DevOps Guru sur plusieurs comptes et régions à l'aide d'AWS CloudFormation StackSets](https://aws.amazon.com/blogs/devops/configure-devops-guru-multiple-accounts-regions-using-cfn-stacksets/)
+ [DevOps Atelier Guru](https://aiops-using-devops-guru.workshop.aws/)