Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# El monitor CodeBuild se construye con CloudWatch
Puedes usar Amazon CloudWatch para ver tus compilaciones, informar cuando algo está mal y tomar medidas automáticas cuando sea apropiado. Puede monitorizar las compilaciones en dos niveles:
Nivel del proyecto
Nivel del proyecto: estas métricas son para todas las compilaciones solo en el proyecto especificado. Para ver las métricas de un proyecto, especifique el `ProjectName` para la dimensión en CloudWatch.
AWS nivel de cuenta
Estas métricas son para todas las compilaciones de una cuenta. Para ver las métricas en el nivel de la cuenta de AWS , no especifique ninguna dimensión en CloudWatch. Las métricas de utilización de los recursos de compilación no están disponibles a nivel de AWS cuenta.
CloudWatch las métricas muestran el comportamiento de tus compilaciones a lo largo del tiempo. Por ejemplo, es posible monitorizar:
+ Cuántas compilaciones se intentaron realizar en un proyecto de compilación o en una AWS cuenta a lo largo del tiempo.
+ Cuántas compilaciones se han realizado correctamente en un proyecto de compilación o en una AWS cuenta a lo largo del tiempo.
+ Cuántas compilaciones fallaron en un proyecto de compilación o en una AWS cuenta a lo largo del tiempo.
+ Cuánto tiempo se CodeBuild ha dedicado a ejecutar compilaciones en un proyecto de compilación o en una AWS cuenta a lo largo del tiempo.
+ Utilización de los recursos de compilación para una compilación o un proyecto de compilación completo. Las métricas de utilización de los recursos de compilación incluyen métricas como la utilización de la CPU, la memoria y el almacenamiento.
Para obtener más información, consulte [Ver CodeBuild métricas](monitoring-metrics.md).
# CodeBuild CloudWatch métricas
Se puede realizar un seguimiento de las siguientes métricas por AWS cuenta o proyecto de compilación. Para obtener más información sobre el uso de CloudWatch with CodeBuild, consulte[El monitor CodeBuild se construye con CloudWatch](monitoring-builds.md).
BuildDuration
Mide la duración de la fase `BUILD` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
Compilaciones
Mide el número de compilaciones activadas.
Unidades: recuento
CloudWatch Estadísticas válidas: suma
DownloadSourceDuration
Mide la duración de la fase `DOWNLOAD_SOURCE` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
Duración
Mide la duración de todas las compilaciones con el paso del tiempo.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
FailedBuilds
Mide el número de compilaciones con errores debido al error del cliente o a un tiempo de espera agotado.
Unidades: recuento
CloudWatch Estadísticas válidas: suma
FinalizingDuration
Mide la duración de la fase `FINALIZING` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
InstallDuration
Mide la duración de la fase `INSTALL` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
PostBuildDuration
Mide la duración de la fase `POST_BUILD` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
PreBuildDuration
Mide la duración de la fase `PRE_BUILD` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
ProvisioningDuration
Mide la duración de la fase `PROVISIONING` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
QueuedDuration
Mide la duración de la fase `QUEUED` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
SubmittedDuration
Mide la duración de la fase `SUBMITTED` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
SucceededBuilds
Mide el número de compilaciones correctas.
Unidades: recuento
CloudWatch Estadísticas válidas: suma
UploadArtifactsDuration
Mide la duración de la fase `UPLOAD_ARTIFACTS` de la compilación.
Unidades: segundos
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
# CodeBuild CloudWatch métricas de utilización de recursos
**nota**
CodeBuild las métricas de utilización de recursos solo están disponibles en las siguientes regiones:
Asia Pacífico (Tokio)
Región de Asia-Pacífico (Seúl)
Región de Asia-Pacífico (Bombay)
Región de Asia-Pacífico (Singapur)
Región de Asia-Pacífico (Sídney)
Región de Canadá (centro)
Región de Europa (Fráncfort)
Región de Europa (Irlanda)
Región de Europa (Londres)
Región Europa (París)
Región de América del Sur (São Paulo)
Región del este de EE. UU. (Norte de Virginia)
Región del este de EE. UU. (Ohio)
Región del oeste de EE. UU. (Norte de California)
Región del oeste de EE. UU. (Oregón)
Es posible realizar un seguimiento de las métricas de utilización de recursos siguientes. Para obtener más información sobre el uso CloudWatch con CodeBuild, consulte[El monitor CodeBuild se construye con CloudWatch](monitoring-builds.md).
CPUUtilized
El número de unidades de CPU de procesamiento asignadas utilizadas por el contenedor de compilación.
Unidades: unidades de CPU
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
CPUUtilizedPorcentaje
Porcentaje procesamiento asignado utilizado por el contenedor de compilación.
Unidad: porcentaje
CloudWatch Estadísticas válidas: promedio (recomendado), máximo, mínimo
MemoryUtilized
Número de megabytes de memoria utilizados por el contenedor de compilación.
Unidades: megabytes
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
MemoryUtilizedPercent
Porcentaje memoria asignada utilizada por el contenedor de compilación.
Unidad: porcentaje
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
StorageReadBytes
Velocidad de lectura de almacenamiento utilizada por el contenedor de compilación.
Unidades: bytes/segundo
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
StorageWriteBytes
Velocidad de escritura de almacenamiento utilizada por el contenedor de compilación.
Unidades: bytes/segundo
CloudWatch Estadísticas válidas: media (recomendada), máxima y mínima
# CodeBuild CloudWatch dimensiones
CodeBuild proporciona las siguientes dimensiones CloudWatch métricas. Si no se especifica ninguna de estas, las métricas son para la AWS cuenta corriente.
BuildId, BuildNumber, ProjectName
Se proporcionan métricas para el identificador de compilación, el número de compilación y el nombre del proyecto.
ProjectName
Las métricas se proporcionan para un nombre de proyecto.
# CodeBuild CloudWatch alarmas
Puedes usar la CloudWatch consola para crear alarmas basadas en CodeBuild métricas para que puedas reaccionar en caso de que algo vaya mal en tus compilaciones. En las viñetas siguientes se describen las dos métricas de mayor utilidad con las alarmas. Para obtener más información sobre el uso de CloudWatch with CodeBuild, consulte[El monitor CodeBuild se construye con CloudWatch](monitoring-builds.md).
+ `FailedBuild`. Puede crear una alarma que se active cuando se detecte un determinado número de compilaciones con errores en un número de segundos predeterminado. En CloudWatch, especifique el número de segundos y el número de compilaciones fallidas que activarán una alarma.
+ `Duration`. Puede crear una alarma que se activa cuando una compilación tarda más de lo esperado. Especifique la cantidad de segundos que debe transcurrir después de que se inicie una compilación y antes de que se complete una compilación para activar una alarma.
Para obtener información sobre cómo crear alarmas para CodeBuild las métricas, consulte[El monitor CodeBuild se construye con CloudWatch alarmas](monitoring-alarms.md). Para obtener más información sobre las alarmas, consulta [Cómo crear CloudWatch alarmas de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) en la *Guía del CloudWatch usuario de Amazon*.
# Ver CodeBuild métricas
AWS CodeBuild supervisa las funciones en tu nombre e informa de las métricas a través de Amazon CloudWatch. Estas métricas incluyen el número de compilaciones totales, compilaciones con errores, compilaciones correctas y la duración de las compilaciones.
Puedes usar la CodeBuild consola o la CloudWatch consola para monitorear las métricas CodeBuild. Los procedimientos siguientes muestran cómo ver las métricas.
**Topics**
+ [Ver las métricas de compilación (CodeBuild consola)](#metrics-in-codebuild-console)
+ [Ver las métricas de compilación ( CloudWatch consola de Amazon)](#metrics-in-cloudwatch-console)
## Ver las métricas de compilación (CodeBuild consola)
**nota**
No puedes personalizar las métricas ni los gráficos que se utilizan para mostrarlos en la CodeBuild consola. Si quieres personalizar la visualización, usa la CloudWatch consola de Amazon para ver tus métricas de compilación.
### Métricas de nivel de cuenta
**Para ver las métricas a AWS nivel de cuenta**
1. [Inicia sesión Consola de administración de AWS y abre la AWS CodeBuild consola en codebuild/home. https://console.aws.amazon.com/codesuite/](https://console.aws.amazon.com/codesuite/codebuild/home)
1. En el panel de navegación, seleccione **Métricas de la cuenta**.
### Métricas de nivel de proyecto
**Para ver las métricas de nivel de proyecto**
1. [Inicia sesión en la AWS CodeBuild consola Consola de administración de AWS y ábrela en codebuild/home. https://console.aws.amazon.com/codesuite/](https://console.aws.amazon.com/codesuite/codebuild/home)
1. En el panel de navegación, elija **Proyectos de compilación**.
1. En la lista de proyectos de compilación, en la columna **Name (Nombre)**, elija el proyecto en el que desee ver las métricas.
1. Elija la pestaña **Metrics** (Métricas).
## Ver las métricas de compilación ( CloudWatch consola de Amazon)
Puede personalizar las métricas y los gráficos utilizados para mostrarlos con la CloudWatch consola.
### Métricas de nivel de cuenta
**Para ver las métricas de de cuenta**
1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, seleccione **Métricas**.
1. En la pestaña **All metrics** (Todas las métricas), elija **CodeBuild**.
![\[Cómo ver CodeBuild las métricas.\]](http://docs.aws.amazon.com/es_es/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. Elija **Account Metrics (Métricas de cuenta)**.
1. Elija uno o varios proyectos y métricas. Para cada proyecto, puedes elegir las métricas **SucceededBuilds**FailedBuilds****, las **compilaciones** y **la duración**. Todas las combinaciones de métricas y proyectos seleccionados se muestran en el gráfico de la página.
### Métricas de nivel de proyecto
**Para ver las métricas de nivel de proyecto**
1. Inicia sesión en Consola de administración de AWS y abre la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, seleccione **Métricas**.
1. En la pestaña **All metrics** (Todas las métricas), elija **CodeBuild**.
![\[Cómo ver CodeBuild las métricas.\]](http://docs.aws.amazon.com/es_es/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. Elija **Por proyecto**.
1. Elija uno o varios combinaciones de proyectos y métricas. Para cada proyecto, puedes elegir las métricas **SucceededBuilds**FailedBuilds****, las **compilaciones** y **la duración**. Todas las combinaciones de métricas y proyectos seleccionados se muestran en el gráfico de la página.
1. (Opcional) Puede personalizar las métricas y los gráficos. Por ejemplo, en la lista desplegable de la columna **Estadística**, puede elegir otra estadística para mostrar. O bien, en el menú desplegable de la columna **Período**, puede elegir un periodo de tiempo distinto para utilizarlo con el fin de monitorizar las métricas.
Para obtener más información, consulta [Graph Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) y [Ver métricas disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) en la *Guía del CloudWatch usuario de Amazon*.
# Ver las métricas CodeBuild de utilización de recursos
AWS CodeBuild supervisa la utilización de los recursos de construcción en tu nombre e informa de las métricas a través de Amazon CloudWatch. Estas incluyen métricas como utilización de CPU, memoria y almacenamiento.
**nota**
CodeBuild Las métricas de uso de recursos solo se registran para las compilaciones que se ejecutan durante más de un minuto.
Puede utilizar la CodeBuild consola o la CloudWatch consola para supervisar las métricas de utilización de los recursos CodeBuild.
**nota**
CodeBuild las métricas de utilización de recursos solo están disponibles en las siguientes regiones:
Asia Pacífico (Tokio)
Región de Asia-Pacífico (Seúl)
Región de Asia-Pacífico (Bombay)
Región de Asia-Pacífico (Singapur)
Región de Asia-Pacífico (Sídney)
Región de Canadá (centro)
Región de Europa (Fráncfort)
Región de Europa (Irlanda)
Región de Europa (Londres)
Región Europa (París)
Región de América del Sur (São Paulo)
Región del este de EE. UU. (Norte de Virginia)
Región del este de EE. UU. (Ohio)
Región del oeste de EE. UU. (Norte de California)
Región del oeste de EE. UU. (Oregón)
Los procedimientos siguientes muestran cómo acceder a las métricas de utilización de recursos.
**Topics**
+ [Acceda a las métricas de utilización de los recursos (CodeBuild consola)](#utilization-metrics-codebuild-console)
+ [Acceder a las métricas de utilización de los recursos ( CloudWatch consola de Amazon)](#utilization-metrics-cloudwatch-console)
## Acceda a las métricas de utilización de los recursos (CodeBuild consola)
**nota**
No puede personalizar las métricas ni los gráficos que se utilizan para mostrarlos en la CodeBuild consola. Si quieres personalizar la visualización, usa la CloudWatch consola de Amazon para ver tus métricas de compilación.
### Métricas de utilización de recursos en el nivel de proyecto
**Para acceder a las métricas de utilización de recursos en el nivel de proyecto**
1. Inicia sesión en la AWS CodeBuild consola Consola de administración de AWS y ábrela en [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. En el panel de navegación, elija **Proyectos de compilación**.
1. En la lista de proyectos de compilación, en la columna **Nombre**, elija el proyecto del que desee ver las métricas.
1. Elija la pestaña **Metrics** (Métricas). Las métricas de utilización de los recursos se muestran en la sección **Métricas de utilización de los recursos**.
1. **Para ver las métricas de utilización de recursos a nivel de proyecto en la CloudWatch consola, selecciona **Ver** en en la sección Métricas de utilización de recursos. CloudWatch**
### Métricas de utilización de recursos en el nivel de compilación
**Para acceder a las métricas de utilización de recursos en el nivel de compilación**
1. [Inicia sesión en la AWS CodeBuild consola Consola de administración de AWS y ábrela en https://console.aws.amazon.com/codesuite/ codebuild/home.](https://console.aws.amazon.com/codesuite/codebuild/home)
1. En el panel de navegación, elija **Historial de compilaciones**.
1. En la lista de compilaciones, en la columna **Ejecución de la compilación**, elija la compilación cuyas métricas desee ver.
1. Seleccione la pestaña **Utilización de recursos**.
1. **Para ver las métricas de uso de recursos a nivel de compilación en la CloudWatch consola, selecciona **Ver** en en la sección Métricas de uso de recursos. CloudWatch**
## Acceder a las métricas de utilización de los recursos ( CloudWatch consola de Amazon)
La CloudWatch consola de Amazon se puede utilizar para acceder a las métricas CodeBuild de utilización de los recursos.
### Métricas de utilización de recursos en el nivel de proyecto
**Para acceder a las métricas de utilización de recursos en el nivel de proyecto**
1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, seleccione **Métricas**.
1. En la pestaña **All metrics** (Todas las métricas), elija **CodeBuild**.
![\[Captura de pantalla de la consola que muestra la CodeBuild opción ubicada en la pestaña Todas las métricas.\]](http://docs.aws.amazon.com/es_es/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. Elija **Por proyecto**.
1. Elija una o más combinaciones de proyectos y métricas para añadirlas al gráfico. Todas las combinaciones de métricas y proyectos seleccionados se muestran en el gráfico de la página.
1. (Opcional) Es posible personalizar las métricas y los gráficos desde la pestaña **Métricas diagramadas**. Por ejemplo, en la lista desplegable de la columna **Estadística**, puede elegir otra estadística para mostrar. O bien, en el menú desplegable de la columna **Período**, puede elegir un periodo de tiempo distinto para utilizarlo con el fin de monitorizar las métricas.
Para obtener más información, consulta Cómo [graficar las métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) y [Ver las métricas disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) en la *Guía del CloudWatch usuario de Amazon*.
### Métricas de utilización de recursos en el nivel de compilación
**Para acceder a las métricas de utilización de recursos en el nivel de compilación**
1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, seleccione **Métricas**.
1. En la pestaña **All metrics** (Todas las métricas), elija **CodeBuild**.
![\[Captura de pantalla de la consola que muestra la CodeBuild opción ubicada en la pestaña Todas las métricas.\]](http://docs.aws.amazon.com/es_es/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. Elige **BuildId, BuildNumber, ProjectName**.
1. Elija una o más combinaciones de compilaciones y métricas para añadirlas al gráfico. Todas las combinaciones de compilaciones y métricas seleccionadas se muestran en el gráfico de la página.
1. (Opcional) Es posible personalizar las métricas y los gráficos desde la pestaña **Métricas diagramadas**. Por ejemplo, en la lista desplegable de la columna **Estadística**, puede elegir otra estadística para mostrar. O bien, en el menú desplegable de la columna **Período**, puede elegir un periodo de tiempo distinto para utilizarlo con el fin de monitorizar las métricas.
Para obtener más información, consulta Cómo [graficar las métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) y [Ver las métricas disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) en la *Guía del CloudWatch usuario de Amazon*.
# El monitor CodeBuild se construye con CloudWatch alarmas
Puede crear una CloudWatch alarma para sus edificios. Una alarma vigila una única métrica durante el periodo de tiempo especificado y realiza una o varias acciones en función del valor de la métrica en relación con un determinado umbral durante una serie de periodos de tiempo. Con la funcionalidad de CloudWatch alarma nativa, puedes especificar cualquiera de las acciones que se admiten CloudWatch cuando se supera un umbral. Por ejemplo, es posible especificar que se envíe una notificación Amazon SNS cuando fallen más de tres compilaciones en su cuenta dentro de un plazo de quince minutos.
**Para crear una CloudWatch alarma para una CodeBuild métrica**
1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, elija **Alarmas**.
1. Elija **Create Alarm** (Crear alarma).
1. En **CloudWatch Métricas por categoría**, selecciona **CodeBuildMétricas**. Si sabe que desea solo las métricas en el nivel de proyecto, elija **By Project (Por proyecto)**. Si sabe que desea solo las métricas en el nivel de cuenta, elija **Account Metrics (Métricas de cuenta)**.
1. En **Create Alarm (Crear alarma)**si aún no está seleccionada, elija **Select Metric (Seleccionar métrica)**.
1. Seleccione una métrica para la que desee crear una alarma. Las opciones son **By Project (Por proyecto)** o **Account Metrics (Métricas de cuenta)**.
1. Elija **Next (Siguiente)** o **Define Alarm (Definir alarma)** y, a continuación, cree la alarma. Para obtener más información, consulta [Cómo crear CloudWatch alarmas de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) en la *Guía del CloudWatch usuario de Amazon*. Para obtener más información sobre la configuración de las notificaciones de Amazon SNS cuando se desencadena una alarma, consulte [Configuración de notificaciones de Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) en la *Guía del desarrollador de Amazon SNS*.
1. Seleccione **Crear alarma**.