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. # Connexion et surveillance AWS CodeBuild La journalisation et la surveillance jouent un rôle important dans le maintien de la fiabilité, de la disponibilité AWS CodeBuild et des performances de vos AWS solutions. Vous devez collecter des données de surveillance provenant de toutes les parties de votre AWS solution afin de pouvoir corriger plus facilement une défaillance multipoint, le cas échéant. AWS fournit les outils suivants pour surveiller vos CodeBuild ressources et vos builds et pour répondre aux incidents potentiels. **Topics** + [Enregistrez les appels AWS CodeBuild d'API avec AWS CloudTrail](cloudtrail.md) + [Surveillez CodeBuild les builds avec CloudWatch](monitoring-builds.md) # Enregistrez les appels AWS CodeBuild d'API avec AWS CloudTrail AWS CodeBuild est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un AWS service dans CodeBuild. CloudTrail capture tous les appels d'API CodeBuild sous forme d'événements, y compris les appels depuis la CodeBuild console et les appels de code vers le CodeBuild APIs. Si vous créez un suivi, vous pouvez activer la diffusion continue des CloudTrail événements vers un compartiment S3, y compris les événements pour CodeBuild. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans **Historique des événements**. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faite CodeBuild, l'adresse IP à partir de laquelle la demande a été faite, qui a fait la demande, quand elle a été faite et des détails supplémentaires. Pour en savoir plus CloudTrail, consultez le [guide de AWS CloudTrail l'utilisateur](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). **Topics** + [À propos AWS CodeBuild des informations contenues dans CloudTrail](service-name-info-in-cloudtrail.md) + [À propos des entrées du fichier AWS CodeBuild journal](understanding-service-name-entries.md) # À propos AWS CodeBuild des informations contenues dans CloudTrail CloudTrail est activé sur votre AWS compte lorsque vous le créez. Lorsqu'une activité se produit dans CodeBuild, cette activité est enregistrée dans un CloudTrail événement avec d'autres événements de AWS service dans **l'historique des événements**. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre AWS compte. Pour plus d'informations, consultez la section [Affichage des événements avec l'historique des CloudTrail événements](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) dans le *Guide de AWS CloudTrail l'utilisateur*. Pour un enregistrement continu des événements de votre AWS compte, y compris des événements pour CodeBuild, créez un parcours. Un journal permet CloudTrail de fournir des fichiers journaux à un compartiment S3. Par défaut, lorsque vous créez un journal de suivi dans la console, il s’applique à toutes les régions . Le journal enregistre les événements de toutes les régions de la AWS partition et transmet les fichiers journaux au compartiment S3 que vous spécifiez. Vous pouvez configurer d'autres AWS services pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour en savoir plus, consultez : + [Présentation de la création d’un journal d’activité](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail services et intégrations pris en charge](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configuration des notifications Amazon SNS pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Réception de fichiers CloudTrail journaux de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) et [réception de fichiers CloudTrail journaux de plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Toutes les CodeBuild actions sont enregistrées CloudTrail et documentées dans la [référence de l'CodeBuild API](https://docs.aws.amazon.com/codebuild/latest/APIReference/). Par exemple, les appels aux actions `CreateProject` (dans le AWS CLI,`create-project`), `StartBuild` (dans le AWS CLI,`start-project`) et `UpdateProject` (dans le AWS CLI,`update-project`) génèrent des entrées dans les fichiers CloudTrail journaux. Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants : + Si la demande a été effectuée avec les informations d’identification utilisateur racine ou . + Si la demande a été effectuée avec les informations d’identification de sécurité temporaires d’un rôle ou d’un utilisateur fédéré. + Si la demande a été faite par un autre AWS service. Pour plus d'informations, consultez l'[élément CloudTrail UserIdentity dans le Guide](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) de l'*AWS CloudTrail utilisateur*. # À propos des entrées du fichier AWS CodeBuild journal Un suivi est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique. **Note** Pour protéger les informations sensibles, les informations suivantes sont masquées dans CodeBuild les journaux : AWS clé d'accès IDs. Pour plus d'informations, consultez [la section Gestion des clés d'accès pour les utilisateurs IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) dans le *guide de l'Gestion des identités et des accès AWS utilisateur*. Chaînes spécifiées à l'aide du stockage de paramètres. Pour plus d'informations, consultez la [procédure pas à pas de la console Systems Manager Parameter [Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html) et Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-walk.html#sysman-paramstore-console) dans le guide de l'*utilisateur d'Amazon EC2 Systems Manager*. Chaînes spécifiées à l'aide de AWS Secrets Manager. Pour de plus amples informations, veuillez consulter [Gestion des clés](security-key-management.md). L'exemple suivant montre une entrée de CloudTrail journal illustrant la création d'un projet de construction dans CodeBuild. ``` { "eventVersion": "1.05", "userIdentity": { "type": "FederatedUser", "principalId": "account-ID:user-name", "arn": "arn:aws:sts::account-ID:federated-user/user-name", "accountId": "account-ID", "accessKeyId": "access-key-ID", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2016-09-06T17:59:10Z" }, "sessionIssuer": { "type": "IAMUser", "principalId": "access-key-ID", "arn": "arn:aws:iam::account-ID:user/user-name", "accountId": "account-ID", "userName": "user-name" } } }, "eventTime": "2016-09-06T17:59:11Z", "eventSource": "codebuild.amazonaws.com", "eventName": "CreateProject", "awsRegion": "region-ID", "sourceIPAddress": "127.0.0.1", "userAgent": "user-agent", "requestParameters": { "awsActId": "account-ID" }, "responseElements": { "project": { "environment": { "image": "image-ID", "computeType": "BUILD_GENERAL1_SMALL", "type": "LINUX_CONTAINER", "environmentVariables": [] }, "name": "codebuild-demo-project", "description": "This is my demo project", "arn": "arn:aws:codebuild:region-ID:account-ID:project/codebuild-demo-project:project-ID", "encryptionKey": "arn:aws:kms:region-ID:key-ID", "timeoutInMinutes": 10, "artifacts": { "location": "arn:aws:s3:::codebuild-region-ID-account-ID-output-bucket", "type": "S3", "packaging": "ZIP", "outputName": "MyOutputArtifact.zip" }, "serviceRole": "arn:aws:iam::account-ID:role/CodeBuildServiceRole", "lastModified": "Sep 6, 2016 10:59:11 AM", "source": { "type": "GITHUB", "location": "https://github.com/my-repo.git" }, "created": "Sep 6, 2016 10:59:11 AM" } }, "requestID": "9d32b228-745b-11e6-98bb-23b67EXAMPLE", "eventID": "581f7dd1-8d2e-40b0-aeee-0dbf7EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "account-ID" } ``` # Surveillez CodeBuild les builds avec CloudWatch Vous pouvez utiliser Amazon CloudWatch pour surveiller vos builds, signaler un problème et prendre des mesures automatiques le cas échéant. Vous pouvez surveiller vos générations à deux niveaux : Niveau du projet Ces mesures concernent toutes les versions du projet spécifié. Pour afficher les métriques d'un projet, spécifiez le `ProjectName` de la dimension dans CloudWatch. AWS niveau du compte Ces statistiques concernent toutes les versions d'un compte. Pour voir les métriques au niveau du compte AWS , n'indiquez pas de dimension dans CloudWatch. Les indicateurs d'utilisation des ressources de construction ne sont pas disponibles au niveau du AWS compte. CloudWatch les métriques montrent le comportement de vos builds au fil du temps. Par exemple, vous pouvez surveiller : + Combien de versions ont été tentées dans un projet de build ou un AWS compte au fil du temps. + Combien de versions ont été réussies dans un projet de construction ou un AWS compte au fil du temps. + Combien de versions ont échoué dans un projet de construction ou un AWS compte au fil du temps. + Combien de temps CodeBuild passé à exécuter des builds dans le cadre d'un projet de build ou d'un AWS compte au fil du temps. + Optimisez l'utilisation des ressources pour une construction ou un projet de construction complet. Les indicateurs d'utilisation des ressources du build incluent des indicateurs tels que l'utilisation du processeur, de la mémoire et du stockage. Pour de plus amples informations, veuillez consulter [Afficher les CodeBuild métriques](monitoring-metrics.md). # CodeBuild CloudWatch métriques Les indicateurs suivants peuvent être suivis par AWS compte ou par projet de création. Pour plus d'informations sur l'utilisation CloudWatch avec CodeBuild, consultez[Surveillez CodeBuild les builds avec CloudWatch](monitoring-builds.md). BuildDuration Mesure la durée de la phase `BUILD` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale Builds Mesure le nombre de générations déclenchées. Unités : nombre CloudWatch Statistiques valides : Sum DownloadSourceDuration Mesure la durée de la phase `DOWNLOAD_SOURCE` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale Duration Mesure la durée de toutes les générations au fil du temps. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale FailedBuilds Mesure le nombre de builds qui ont échoué en raison d'une erreur du client ou d'un délai d'attente. Unités : nombre CloudWatch Statistiques valides : Sum FinalizingDuration Mesure la durée de la phase `FINALIZING` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale InstallDuration Mesure la durée de la phase `INSTALL` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale PostBuildDuration Mesure la durée de la phase `POST_BUILD` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale PreBuildDuration Mesure la durée de la phase `PRE_BUILD` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale ProvisioningDuration Mesure la durée de la phase `PROVISIONING` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale QueuedDuration Mesure la durée de la phase `QUEUED` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale SubmittedDuration Mesure la durée de la phase `SUBMITTED` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale SucceededBuilds Mesure le nombre de générations réussies. Unités : nombre CloudWatch Statistiques valides : Sum UploadArtifactsDuration Mesure la durée de la phase `UPLOAD_ARTIFACTS` de la génération. Unités : secondes CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale # CodeBuild CloudWatch mesures d'utilisation des ressources **Note** CodeBuild les mesures d'utilisation des ressources ne sont disponibles que dans les régions suivantes : Région Asia Pacific (Tokyo) Région Asia Pacific (Seoul) Région Asie-Pacifique (Mumbai) Région Asia Pacific (Singapore) Région Asia Pacific (Sydney) Région Canada (Centre) Région Europe (Frankfurt) Région Europe (Irlande) Région Europe (Londres) Région Europe (Paris) Région Amérique du Sud (São Paulo) US East (N. Virginia) Region US East (Ohio) Region Région US West (N. California) Région US West (Oregon) Les mesures d'utilisation des ressources suivantes peuvent être suivies. Pour plus d'informations sur l'utilisation CloudWatch avec CodeBuild, consultez[Surveillez CodeBuild les builds avec CloudWatch](monitoring-builds.md). CPUUtilized Le nombre d'unités de processeur allouées au traitement utilisé par le conteneur de construction. Unités : unités CPU CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale CPUUtilizedPourcentage Pourcentage de traitement alloué utilisé par le conteneur de construction. Unités : pourcentage CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale MemoryUtilized Nombre de mégaoctets de mémoire utilisés par le conteneur de compilation. Unités : mégaoctets CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale MemoryUtilizedPercent Pourcentage de mémoire allouée utilisé par le conteneur de compilation. Unités : pourcentage CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale StorageReadBytes Vitesse de lecture du stockage utilisée par le conteneur de construction. Unités : octets/seconde CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale StorageWriteBytes Vitesse d'écriture de stockage utilisée par le conteneur de construction. Unités : octets/seconde CloudWatch Statistiques valides : moyenne (recommandée), maximale, minimale # CodeBuild CloudWatch dimensions CodeBuild fournit les dimensions CloudWatch métriques suivantes. Si aucune de ces valeurs n'est spécifiée, les mesures concernent le AWS compte courant. BuildId, BuildNumber, ProjectName Des métriques sont fournies pour un identifiant de build, un numéro de build et un nom de projet. ProjectName Des métriques sont fournies pour le nom d'un projet. # CodeBuild CloudWatch alarmes Vous pouvez utiliser la CloudWatch console pour créer des alarmes basées sur CodeBuild des métriques afin de pouvoir réagir en cas de problème avec vos builds. Les deux mesures les plus utiles avec les alarmes sont décrites dans les points suivants. Pour plus d'informations sur l'utilisation CloudWatch avec CodeBuild, consultez[Surveillez CodeBuild les builds avec CloudWatch](monitoring-builds.md). + `FailedBuild`. Vous pouvez créer une alarme qui se déclenche lorsqu'un certain nombre de builds échoués sont détectés dans un délai prédéterminé de secondes. Dans CloudWatch, vous spécifiez le nombre de secondes et le nombre de builds échoués qui déclenchent une alarme. + `Duration`. Vous pouvez créer une alarme qui se déclenche lorsqu'une construction prend plus de temps que prévu. Vous spécifiez le nombre de secondes qui doit s'écouler entre le démarrage et la fin d’une génération, avant le déclenchement de l'alarme. Pour plus d'informations sur la création d'alarmes pour CodeBuild les métriques, consultez[Surveillez les CodeBuild builds avec des CloudWatch alarmes](monitoring-alarms.md). Pour plus d'informations sur les alarmes, consultez la section [Création d' CloudWatch alarmes Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) dans le *guide de CloudWatch l'utilisateur Amazon*. # Afficher les CodeBuild métriques AWS CodeBuild surveille les fonctions en votre nom et publie des statistiques via Amazon CloudWatch. Ces métriques incluent le nombre total de générations, d'échecs et de réussites, ainsi que la durée des générations. Vous pouvez utiliser la CodeBuild console ou la CloudWatch console pour surveiller les métriques de CodeBuild. Les procédures suivantes vous montrent comment afficher les métriques. **Topics** + [Afficher les statistiques de construction (CodeBuild console)](#metrics-in-codebuild-console) + [Afficher les statistiques de construction ( CloudWatch console Amazon)](#metrics-in-cloudwatch-console) ## Afficher les statistiques de construction (CodeBuild console) **Note** Vous ne pouvez pas personnaliser les statistiques ou les graphiques utilisés pour les afficher dans la CodeBuild console. Si vous souhaitez personnaliser l'affichage, utilisez la CloudWatch console Amazon pour consulter les statistiques de votre build. ### Indicateurs au niveau du compte **Pour consulter les statistiques au AWS niveau du compte** 1. Connectez-vous à la AWS CodeBuild console AWS Management Console et ouvrez-la sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home). 1. Dans le volet de navigation, sélectionnez **Métriques de compte**. ### Métriques au niveau du projet **Pour afficher les métriques au niveau du projet** 1. Connectez-vous à la AWS CodeBuild console AWS Management Console et ouvrez-la sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home). 1. Dans le volet de navigation, choisissez **Projets de génération**. 1. Dans la liste des projets de génération, dans la colonne **Nom**, choisissez le projet dont vous souhaitez consulter les métriques. 1. Sélectionnez l’onglet **Métriques**. ## Afficher les statistiques de construction ( CloudWatch console Amazon) Vous pouvez personnaliser les métriques et les graphiques utilisés pour les afficher avec la CloudWatch console. ### Indicateurs au niveau du compte **Pour consulter les statistiques au niveau du compte** 1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le panneau de navigation, sélectionnez ‎**Métriques**. 1. Sous l'onglet **All metrics** (Toutes les métriques), choisissez **CodeBuild**. ![\[Comment consulter CodeBuild les métriques\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png) 1. Choisissez **Account metrics (Métriques globales)**. 1. Choisissez un ou plusieurs projets et métriques. Pour chaque projet, vous pouvez choisir les métriques **SucceededBuilds**FailedBuilds****, **Builds** et **Duration**. Toutes les combinaisons de métriques et de projets sélectionnées sont affichées dans le graphique sur la page. ### Métriques au niveau du projet **Pour afficher les métriques au niveau du projet** 1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le panneau de navigation, sélectionnez ‎**Métriques**. 1. Sous l'onglet **All metrics** (Toutes les métriques), choisissez **CodeBuild**. ![\[Comment consulter CodeBuild les métriques\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png) 1. Choisissez **Par projet**. 1. Choisissez une ou plusieurs combinaisons de projets et de métriques. Pour chaque projet, vous pouvez choisir les métriques **SucceededBuilds**FailedBuilds****, **Builds** et **Duration**. Toutes les combinaisons de métriques et de projets sélectionnées sont affichées dans le graphique sur la page. 1. (Facultatif) Vous pouvez personnaliser vos métriques et graphiques. Par exemple, dans la liste déroulante de la colonne **Statistiques**, vous pouvez choisir une autre statistique à afficher. Dans le menu déroulant de la colonne **Période**, vous pouvez choisir une autre période à utiliser pour surveiller les métriques. Pour plus d'informations, consultez [Graph metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) et [View available metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) dans le *Amazon CloudWatch User Guide*. # Afficher les indicateurs d'utilisation des CodeBuild ressources AWS CodeBuild surveille l'utilisation des ressources de construction en votre nom et publie des statistiques via Amazon CloudWatch. Il s'agit notamment de mesures telles que l'utilisation du processeur, de la mémoire et du stockage. **Note** CodeBuild les mesures d'utilisation des ressources ne sont enregistrées que pour les versions qui s'exécutent pendant plus d'une minute. Vous pouvez utiliser la CodeBuild console ou la CloudWatch console pour surveiller les mesures d'utilisation des ressources pour CodeBuild. **Note** CodeBuild les mesures d'utilisation des ressources ne sont disponibles que dans les régions suivantes : Région Asia Pacific (Tokyo) Région Asia Pacific (Seoul) Région Asie-Pacifique (Mumbai) Région Asia Pacific (Singapore) Région Asia Pacific (Sydney) Région Canada (Centre) Région Europe (Frankfurt) Région Europe (Irlande) Région Europe (Londres) Région Europe (Paris) Région Amérique du Sud (São Paulo) US East (N. Virginia) Region US East (Ohio) Region Région US West (N. California) Région US West (Oregon) Les procédures suivantes vous indiquent comment accéder à vos indicateurs d'utilisation des ressources. **Topics** + [Accédez aux métriques d'utilisation des ressources (CodeBuild console)](#utilization-metrics-codebuild-console) + [Accédez aux métriques d'utilisation des ressources ( CloudWatch console Amazon)](#utilization-metrics-cloudwatch-console) ## Accédez aux métriques d'utilisation des ressources (CodeBuild console) **Note** Vous ne pouvez pas personnaliser les statistiques ou les graphiques utilisés pour les afficher dans la CodeBuild console. Si vous souhaitez personnaliser l'affichage, utilisez la CloudWatch console Amazon pour consulter les statistiques de votre build. ### Mesures d'utilisation des ressources au niveau du projet **Pour accéder aux indicateurs d'utilisation des ressources au niveau du projet** 1. Connectez-vous à la AWS CodeBuild console AWS Management Console et ouvrez-la sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home). 1. Dans le volet de navigation, choisissez **Projets de génération**. 1. Dans la liste des projets de construction, dans la colonne **Nom**, choisissez le projet pour lequel vous souhaitez consulter les mesures d'utilisation. 1. Sélectionnez l’onglet **Métriques**. Les mesures d'utilisation des ressources sont affichées dans la section **Mesures d'utilisation des ressources**. 1. Pour afficher les mesures d'utilisation des ressources au niveau du projet dans la CloudWatch console, choisissez **Afficher CloudWatch dans** la section **Mesures d'utilisation des ressources**. ### Mesures d'utilisation des ressources au niveau du build **Pour accéder aux indicateurs d'utilisation des ressources au niveau du build** 1. Connectez-vous à la AWS CodeBuild console AWS Management Console et ouvrez-la sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home). 1. Dans le volet de navigation, choisissez **Historique de génération**. 1. Dans la liste des versions, dans la colonne **Build run**, choisissez la version pour laquelle vous souhaitez afficher les métriques d'utilisation. 1. Choisissez l'onglet **Utilisation des ressources**. 1. Pour afficher les mesures d'utilisation des ressources au niveau du build dans la CloudWatch console, choisissez **Afficher CloudWatch dans** la section **Mesures d'utilisation des ressources**. ## Accédez aux métriques d'utilisation des ressources ( CloudWatch console Amazon) La CloudWatch console Amazon peut être utilisée pour accéder aux métriques d'utilisation des CodeBuild ressources. ### Mesures d'utilisation des ressources au niveau du projet **Pour accéder aux indicateurs d'utilisation des ressources au niveau du projet** 1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le panneau de navigation, sélectionnez ‎**Métriques**. 1. Sous l'onglet **All metrics** (Toutes les métriques), choisissez **CodeBuild**. ![\[Capture d'écran de la console montrant l' CodeBuild option située dans l'onglet Toutes les mesures.\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png) 1. Choisissez **Par projet**. 1. Choisissez une ou plusieurs combinaisons de projets et de métriques à ajouter au graphique. Toutes les combinaisons de métriques et de projets sélectionnées sont affichées dans le graphique sur la page. 1. (Facultatif) Vous pouvez personnaliser vos statistiques et vos graphiques à partir de l'**onglet Mesures graphiques**. Par exemple, dans la liste déroulante de la colonne **Statistiques**, vous pouvez choisir une autre statistique à afficher. Dans le menu déroulant de la colonne **Période**, vous pouvez choisir une autre période à utiliser pour surveiller les métriques. Pour plus d'informations, consultez les sections [Représentation graphique des métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) et [Affichage des métriques disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) dans le *guide de CloudWatch l'utilisateur Amazon*. ### Mesures d'utilisation des ressources au niveau du build **Pour accéder aux indicateurs d'utilisation des ressources au niveau du build** 1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le panneau de navigation, sélectionnez ‎**Métriques**. 1. Sous l'onglet **All metrics** (Toutes les métriques), choisissez **CodeBuild**. ![\[Capture d'écran de la console montrant l' CodeBuild option située dans l'onglet Toutes les mesures.\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png) 1. Choisissez **BuildId BuildNumber, ProjectName**. 1. Choisissez une ou plusieurs combinaisons de constructions et de métriques à ajouter au graphique. Toutes les combinaisons de construction et de métriques sélectionnées sont affichées dans le graphique de la page. 1. (Facultatif) Vous pouvez personnaliser vos statistiques et vos graphiques à partir de l'**onglet Mesures graphiques**. Par exemple, dans la liste déroulante de la colonne **Statistiques**, vous pouvez choisir une autre statistique à afficher. Dans le menu déroulant de la colonne **Période**, vous pouvez choisir une autre période à utiliser pour surveiller les métriques. Pour plus d'informations, consultez les sections [Représentation graphique des métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) et [Affichage des métriques disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) dans le *guide de CloudWatch l'utilisateur Amazon*. # Surveillez les CodeBuild builds avec des CloudWatch alarmes Vous pouvez créer une CloudWatch alarme pour vos builds. Une alarme surveille une métrique individuelle pendant une période que vous définissez et exécute une ou plusieurs actions en fonction de la valeur de cette métrique, par rapport à un seuil spécifié sur un certain nombre de périodes. À l'aide de la fonctionnalité CloudWatch d'alarme native, vous pouvez spécifier toutes les actions prises en charge en CloudWatch cas de dépassement d'un seuil. Par exemple, vous pouvez spécifier qu'une notification Amazon SNS est envoyée lorsque plus de trois versions de votre compte échouent dans les quinze minutes. **Pour créer une CloudWatch alarme pour une CodeBuild métrique** 1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le panneau de navigation, cliquez sur **Alarms (Alarmes)**. 1. Sélectionnez **Create Alarm (Créer une alarme)**. 1. Sous **CloudWatch Métriques par catégorie**, sélectionnez **CodeBuildMétriques**. Si vous savez que vous utiliserez uniquement les métriques de niveau projet, choisissez **Par projet**. Si vous savez que vous utiliserez uniquement les métriques de niveau compte, choisissez **Métriques de compte**. 1. Sous **Créer une alarme**, si l'option n'est pas déjà sélectionnée, choisissez **Sélectionner une métrique**. 1. Choisissez la métrique pour laquelle vous voulez créer une alarme. Les options disponibles sont **Par projet** et **Métriques de compte**. 1. Choisissez **Suivant** ou **Définir une alarme**, puis créez votre alarme. Pour plus d'informations, consultez la section [Création d' CloudWatch alarmes Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) dans le *guide de CloudWatch l'utilisateur Amazon*. Pour plus d'informations sur la configuration des notifications Amazon SNS lorsqu'une alarme est déclenchée, consultez la section [Configurer les notifications Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) dans le manuel du développeur Amazon *SNS*. 1. Sélectionnez **Create Alarm (Créer une alerte)**.