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.
# 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)**.