Monitorar o AWS CodeBuild

É possível usar o Amazon CloudWatch para ver as compilações, informar quando algo está errado e realizar ações automáticas quando apropriado. Você pode monitorar as compilações em dois níveis:

Nível de projeto

Essas métricas servem para todas as compilações no projeto especificado. Para ver as métricas de um projeto, especifique o ProjectName para a dimensão no CloudWatch.

Nível de conta da AWS

Essas métricas servem para todas as compilações em uma conta. Para ver as métricas na conta da AWS, não insira uma dimensão no CloudWatch. As métricas de utilização de recursos de compilação não estão disponíveis na conta da AWS.

As métricas do CloudWatch mostram o comportamento das compilações ao longo do tempo. Por exemplo, é possível monitorar:

• Quantas compilações foram tentadas em um projeto de criação ou uma conta da AWS ao longo do tempo.

• Quantas compilações foram bem-sucedidas em um projeto de criação ou uma conta da AWS ao longo do tempo.

• Quantas compilações falharam em um projeto de criação ou uma conta da AWS ao longo do tempo.

• Quanto tempo o CodeBuild levou na execução de compilações em um projeto de compilação ou em uma conta da AWS.

• Utilização de recursos de uma compilação ou um projeto de compilação inteiro. As métricas de utilização de recursos de compilação incluem métricas, como utilização de CPU, memória e armazenamento.

Para obter mais informações, consulte CodeBuild Métricas de monitoramento.

Métricas do CloudWatch no CodeBuild

As métricas a seguir podem ser monitoradas por conta da AWS ou por projeto de compilação.

BuildDuration

Mede a duração da fase BUILD da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo

Builds

Mede o número de compilações acionadas.

Unidade: contagem

Estatísticas válidas do CloudWatch: soma

DownloadSourceDuration

Mede a duração da fase DOWNLOAD_SOURCE da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

Duração

Mede a duração de todas as compilações ao longo do tempo.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

FailedBuilds

Mede o número de compilações que falharam em virtude de um erro de cliente ou um tempo limite.

Unidade: contagem

Estatísticas válidas do CloudWatch: soma

FinalizingDuration

Mede a duração da fase FINALIZING da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

InstallDuration

Mede a duração da fase INSTALL da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

PostBuildDuration

Mede a duração da fase POST_BUILD da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

PreBuildDuration

Mede a duração da fase PRE_BUILD da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

ProvisioningDuration

Mede a duração da fase PROVISIONING da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

QueuedDuration

Mede a duração da fase QUEUED da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

SubmittedDuration

Mede a duração da fase SUBMITTED da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

SucceededBuilds

Mede o número de compilações bem-sucedidas.

Unidade: contagem

Estatísticas válidas do CloudWatch: soma

UploadArtifactsDuration

Mede a duração da fase UPLOAD_ARTIFACTS da compilação.

Unidade: segundos

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

Métricas de utilização de recursos do CloudWatch no CodeBuild

nota

As métricas de utilização de recursos do CodeBuild só estão disponíveis nas seguintes regiões:

• Asia Pacific (Tokyo) Region

• Região Ásia-Pacífico (Seul)

• Região Ásia-Pacífico (Mumbai)

• Região Ásia-Pacífico (Singapura)

• Região Ásia-Pacífico (Sydney)

• Região do Canadá (Central)

• Região Europa (Frankfurt)

• Região Europa (Irlanda)

• Região Europa (Londres)

• Região Europa (Paris)

• South America (São Paulo) Region

• Região Leste dos EUA (N. da Virgínia)

• Região Leste dos EUA (Ohio)

• Região Leste dos EUA (Norte da Califórnia)

• Região Oeste dos EUA (Oregon)

As métricas de utilização de recursos a seguir podem ser monitoradas.

CPUUtilized

O número de unidades de CPU do processamento alocado usado pelo contêiner de compilação.

Unidades: unidades de CPU

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

CPUUtilizedPercent

A porcentagem de processamento alocado usado pelo contêiner de compilação.

Unidades: percentual

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

MemoryUtilized

O número de megabytes de memória usado pelo contêiner de compilação.

Unidades: megabytes

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

MemoryUtilizedPercent

A porcentagem de processamento alocado usado pelo contêiner de compilação.

Unidades: percentual

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

StorageReadBytes

A velocidade de leitura do armazenamento usada pelo contêiner de compilação.

Unidade: bytes/segundo

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

StorageWriteBytes

A velocidade de gravação do armazenamento usada pelo contêiner de compilação.

Unidade: bytes/segundo

Estatísticas válidas do CloudWatch: média (recomendada), máximo, mínimo.

Dimensões do CloudWatch no CodeBuild

O CodeBuild fornece as dimensões métricas do CloudWatch a seguir. Se não for especificado, as métricas serão da conta atual da AWS.

BuildId, BuildNumber, ProjectName

As métricas são fornecidas para um identificador de compilação, número de compilação e nome do projeto.

ProjectName

As métricas são fornecidas para o nome de um projeto.

Alertas do CloudWatch no CodeBuild

É possível usar o console do CloudWatch para criar alarmes com base em métricas do CodeBuild, para que possa reagir se ocorrer algum problema com as compilações. As duas métricas mais úteis com alarmes são:

• FailedBuild. É possível criar um alarme que é acionado quando um número específico de compilações com falha é detectado em um número predefinido de segundos. No CloudWatch, você especifica o número de segundos e quantas compilações com falha acionarão um alarme.

• Duration. É possível criar um alarme que é acionado quando uma compilação leva mais tempo do que o esperado. Você especifica quantos segundos devem decorrer depois que uma compilação é iniciada e antes que uma compilação seja concluída, antes que o alarme seja acionado.

Para obter informações sobre como criar alarmes para métricas do CodeBuild, consulte Monitorar compilações com alarmes do CloudWatch. Para obter mais informações sobre alarmes, consulte Creating Amazon CloudWatch alarms no Guia do usuário do Amazon CloudWatch.