As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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.