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á.
# O monitor é CodeBuild construído com CloudWatch
Você pode usar CloudWatch a Amazon para observar suas construções, relatar 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.
AWS nível da conta
Essas métricas servem para todas as compilações em uma conta. Para ver as métricas no nível da conta da AWS , não insira uma dimensão no CloudWatch. As métricas de utilização de recursos de criação não estão disponíveis no nível da AWS conta.
CloudWatch as métricas mostram o comportamento de suas construções ao longo do tempo. Por exemplo, é possível monitorar:
+ Quantas construções foram tentadas em um projeto de compilação ou em uma AWS conta ao longo do tempo.
+ Quantas construções foram bem-sucedidas em um projeto de construção ou em uma AWS conta ao longo do tempo.
+ Quantas compilações falharam em um projeto de compilação ou em uma AWS conta ao longo do tempo.
+ Quanto tempo CodeBuild gasto executando compilações em um projeto de compilação ou em uma AWS conta ao longo do tempo.
+ 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 [Exibir CodeBuild métricas](monitoring-metrics.md).
# CodeBuild CloudWatch métricas
As métricas a seguir podem ser monitoradas por AWS conta ou por projeto de compilação. Para obter mais informações sobre como usar CloudWatch com CodeBuild, consulte[O monitor é CodeBuild construído com CloudWatch](monitoring-builds.md).
BuildDuration
Mede a duração da fase `BUILD` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
Compilações
Mede o número de compilações acionadas.
Unidades: contagem
CloudWatch Estatísticas válidas: Soma
DownloadSourceDuration
Mede a duração da fase `DOWNLOAD_SOURCE` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
Duração
Mede a duração de todas as compilações ao longo do tempo.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
FailedBuilds
Mede o número de compilações que falharam em virtude de um erro de cliente ou um tempo limite.
Unidades: contagem
CloudWatch Estatísticas válidas: Soma
FinalizingDuration
Mede a duração da fase `FINALIZING` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
InstallDuration
Mede a duração da fase `INSTALL` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
PostBuildDuration
Mede a duração da fase `POST_BUILD` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
PreBuildDuration
Mede a duração da fase `PRE_BUILD` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
ProvisioningDuration
Mede a duração da fase `PROVISIONING` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
QueuedDuration
Mede a duração da fase `QUEUED` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
SubmittedDuration
Mede a duração da fase `SUBMITTED` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
SucceededBuilds
Mede o número de compilações bem-sucedidas.
Unidades: contagem
CloudWatch Estatísticas válidas: Soma
UploadArtifactsDuration
Mede a duração da fase `UPLOAD_ARTIFACTS` da compilação.
Unidades: segundos
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
# CodeBuild CloudWatch métricas de utilização de recursos
**nota**
CodeBuild as métricas de utilização de recursos só estão disponíveis nas seguintes regiões:
Região Ásia-Pacífico (Tóquio)
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 Canadá (Central)
Região Europa (Frankfurt)
Região Europa (Irlanda)
Região Europa (Londres)
Região Europa (Paris)
Região América do Sul (São Paulo)
Região Leste dos EUA (N. da Virgínia)
Região Leste dos EUA (Ohio)
Região Oeste dos EUA (N. da Califórnia)
Região Oeste dos EUA (Oregon)
As métricas de utilização de recursos a seguir podem ser monitoradas. Para obter mais informações sobre como usar CloudWatch com CodeBuild, consulte[O monitor é CodeBuild construído com CloudWatch](monitoring-builds.md).
CPUUtilized
O número de unidades de CPU do processamento alocado usado pelo contêiner de compilação.
Unidades: unidades de CPU
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
CPUUtilizedPorcentagem
A porcentagem de processamento alocado usado pelo contêiner de compilação.
Unidades: percentual
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
MemoryUtilized
O número de megabytes de memória usado pelo contêiner de compilação.
Unidades: megabytes
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
MemoryUtilizedPercent
A porcentagem de processamento alocado usado pelo contêiner de compilação.
Unidades: percentual
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
StorageReadBytes
A velocidade de leitura do armazenamento usada pelo contêiner de compilação.
Unidade: bytes/segundo
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
StorageWriteBytes
A velocidade de gravação do armazenamento usada pelo contêiner de compilação.
Unidade: bytes/segundo
CloudWatch Estatísticas válidas: Média (recomendada), Máxima, Mínima
# CodeBuild CloudWatch dimensões
CodeBuild fornece as seguintes dimensões CloudWatch métricas. Se nenhuma delas for especificada, as métricas são para a AWS conta corrente.
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.
# CodeBuild CloudWatch alarmes
Você pode usar o CloudWatch console para criar alarmes com base em CodeBuild métricas para poder reagir se algo der errado com suas compilações. As duas métricas mais úteis com alarmes são descritas nos itens a seguir. Para obter mais informações sobre como usar CloudWatch com CodeBuild, consulte[O monitor é CodeBuild construído com CloudWatch](monitoring-builds.md).
+ `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. Em CloudWatch, você especifica o número de segundos e quantas compilações com falha acionam 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 CodeBuild métricas, consulte[Monitore CodeBuild construções com alarmes CloudWatch](monitoring-alarms.md). Para obter mais informações sobre alarmes, consulte [Criação de CloudWatch alarmes da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) no Guia * CloudWatch do usuário da Amazon*.
# Exibir CodeBuild métricas
AWS CodeBuild monitora funções em seu nome e relata métricas por meio da Amazon CloudWatch. Essas métricas incluem o número total de compilações, compilações com falha, compilações bem-sucedidas e a duração de compilações.
Você pode usar o CodeBuild console ou o CloudWatch console para monitorar as métricas de CodeBuild. Os procedimentos a seguir mostram como exibir as métricas.
**Topics**
+ [Exibir métricas de compilação (CodeBuild console)](#metrics-in-codebuild-console)
+ [Exibir métricas de compilação ( CloudWatch console da Amazon)](#metrics-in-cloudwatch-console)
## Exibir métricas de compilação (CodeBuild console)
**nota**
Você não pode personalizar as métricas ou os gráficos usados para exibi-las no CodeBuild console. Se você quiser personalizar a exibição, use o CloudWatch console da Amazon para visualizar suas métricas de criação.
### Métricas em nível de conta
**Para visualizar métricas em AWS nível de conta**
1. Faça login no Console de gerenciamento da AWS e abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. No painel de navegação, escolha **Account metrics (Métricas da conta)**.
### Métricas em nível de projeto
**Para exibir métricas no nível do projeto**
1. Faça login no Console de gerenciamento da AWS e abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. No painel de navegação, selecione **Projetos de compilação**.
1. Na lista de projetos de compilação, na coluna **Name (Nome)**, escolha o projeto onde você deseja visualizar as métricas.
1. Escolha a guia **Métricas**.
## Exibir métricas de compilação ( CloudWatch console da Amazon)
Você pode personalizar as métricas e os gráficos usados para exibi-las com o CloudWatch console.
### Métricas em nível de conta
**Para exibir métricas no nível da conta**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Métricas**.
1. Na guia **All metrics** (Todas as métricas), escolha **CodeBuild**.
![\[Como visualizar as CodeBuild métricas.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. Escolha **Métricas da conta**.
1. Escolha um ou mais projetos e métricas. Para cada projeto, você pode escolher as métricas **SucceededBuilds**FailedBuilds****,, **Construções** e **Duração**. Todas as combinações selecionadas de projeto e de métrica são exibidas no gráfico na página.
### Métricas em nível de projeto
**Para exibir métricas no nível do projeto**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Métricas**.
1. Na guia **All metrics** (Todas as métricas), escolha **CodeBuild**.
![\[Como visualizar as CodeBuild métricas.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. Escolha **Por projeto**.
1. Escolha uma ou mais combinações de projeto e métrica. Para cada projeto, você pode escolher as métricas **SucceededBuilds**FailedBuilds****,, **Construções** e **Duração**. Todas as combinações selecionadas de projeto e de métrica são exibidas no gráfico na página.
1. (Opcional) Você pode personalizar suas métricas e gráficos. Por exemplo, na lista suspensa na coluna **Estatística**, é possível escolher outra estatística para exibir. Ou, no menu suspenso na coluna **Período**, você pode escolher um período diferente a ser usado para monitorar as métricas.
Para obter mais informações, consulte [Métricas gráficas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) e [Visualizar métricas disponíveis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) no *Guia CloudWatch do usuário da Amazon*.
# Exibir CodeBuild métricas de utilização de recursos
AWS CodeBuild monitora a utilização de recursos de construção em seu nome e relata métricas por meio da Amazon CloudWatch. Elas incluem métricas, como CPU, memória e utilização do armazenamento.
**nota**
CodeBuild as métricas de utilização de recursos são registradas somente para compilações que são executadas por mais de um minuto.
Você pode usar o CodeBuild console ou o CloudWatch console para monitorar as métricas de utilização de recursos para CodeBuild.
**nota**
CodeBuild as métricas de utilização de recursos só estão disponíveis nas seguintes regiões:
Região Ásia-Pacífico (Tóquio)
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 Canadá (Central)
Região Europa (Frankfurt)
Região Europa (Irlanda)
Região Europa (Londres)
Região Europa (Paris)
Região América do Sul (São Paulo)
Região Leste dos EUA (N. da Virgínia)
Região Leste dos EUA (Ohio)
Região Oeste dos EUA (N. da Califórnia)
Região Oeste dos EUA (Oregon)
Os procedimentos a seguir mostram como acessar as métricas de utilização de recursos.
**Topics**
+ [Acesse métricas de utilização de recursos (CodeBuild console)](#utilization-metrics-codebuild-console)
+ [Acesse métricas de utilização de recursos ( CloudWatch console da Amazon)](#utilization-metrics-cloudwatch-console)
## Acesse métricas de utilização de recursos (CodeBuild console)
**nota**
Você não pode personalizar as métricas ou os gráficos usados para exibi-las no CodeBuild console. Se você quiser personalizar a exibição, use o CloudWatch console da Amazon para visualizar suas métricas de criação.
### Métricas de utilização de recursos em nível de projeto
**Como acessar métricas de utilização de recursos em nível de projeto**
1. Faça login no Console de gerenciamento da AWS e abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. No painel de navegação, selecione **Projetos de compilação**.
1. Na lista de projetos de compilação, na coluna **Nome**, escolha o projeto cujas métricas de utilização você deseja ver.
1. Escolha a guia **Métricas**. As métricas de utilização de recursos são exibidas na seção **Métricas de utilização de recursos**.
1. Para visualizar as métricas de utilização de recursos em nível de projeto no CloudWatch console, escolha **Exibir CloudWatch na seção** Métricas de **utilização de recursos**.
### Métricas de utilização de recursos em nível de compilação
**Como acessar métricas de utilização de recursos em nível de compilação**
1. Faça login no Console de gerenciamento da AWS e abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. No painel de navegação, selecione **Histórico de compilação**.
1. Na lista de compilações, na coluna **Execução da compilação**, selecione a compilação cujas métricas de utilização você deseja visualizar.
1. Escolha a guia **Utilização de recursos**.
1. Para visualizar as métricas de utilização de recursos em nível de compilação no CloudWatch console, escolha **Exibir CloudWatch na seção** Métricas de **utilização de recursos**.
## Acesse métricas de utilização de recursos ( CloudWatch console da Amazon)
O CloudWatch console da Amazon pode ser usado para acessar métricas CodeBuild de utilização de recursos.
### Métricas de utilização de recursos em nível de projeto
**Como acessar métricas de utilização de recursos em nível de projeto**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Métricas**.
1. Na guia **All metrics** (Todas as métricas), escolha **CodeBuild**.
![\[Captura de tela do console mostrando a CodeBuild opção localizada na guia Todas as métricas.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. Escolha **Por projeto**.
1. Escolha uma ou mais combinações de projetos e métricas para adicionar ao grafo. Todas as combinações selecionadas de projeto e de métrica são exibidas no gráfico na página.
1. (Opcional) É possível personalizar as métricas e os grafos na guia **Métricas em gráficos**. Por exemplo, na lista suspensa na coluna **Estatística**, é possível escolher outra estatística para exibir. Ou, no menu suspenso na coluna **Período**, você pode escolher um período diferente a ser usado para monitorar as métricas.
Para obter mais informações, consulte [Representação gráfica de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) e [Visualização de métricas disponíveis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) no *Guia do CloudWatch usuário da Amazon*.
### Métricas de utilização de recursos em nível de compilação
**Como acessar métricas de utilização de recursos em nível de compilação**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Métricas**.
1. Na guia **All metrics** (Todas as métricas), escolha **CodeBuild**.
![\[Captura de tela do console mostrando a CodeBuild opção localizada na guia Todas as métricas.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. Escolha **BuildId, BuildNumber, ProjectName**.
1. Selecione uma ou mais combinações de compilações e métricas para adicionar ao grafo. Todas as combinações selecionadas de compilação e de métrica são exibidas no grafo na página.
1. (Opcional) É possível personalizar as métricas e os grafos na guia **Métricas em gráficos**. Por exemplo, na lista suspensa na coluna **Estatística**, é possível escolher outra estatística para exibir. Ou, no menu suspenso na coluna **Período**, você pode escolher um período diferente a ser usado para monitorar as métricas.
Para obter mais informações, consulte [Representação gráfica de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) e [Visualização de métricas disponíveis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) no *Guia do CloudWatch usuário da Amazon*.
# Monitore CodeBuild construções com alarmes CloudWatch
Você pode criar um CloudWatch alarme para suas construções. Um alarme observa uma única métrica ao longo de um período especificado por você e realiza uma ou mais ações com base no valor da métrica em relação a um limite especificado ao longo de vários períodos. Usando a funcionalidade de CloudWatch alarme nativa, você pode especificar qualquer uma das ações suportadas CloudWatch quando um limite é excedido. Por exemplo, é possível especificar que uma notificação do Amazon SNS seja enviada quando mais de três compilações na conta falhar em 15 minutos.
**Para criar um CloudWatch alarme para uma CodeBuild métrica**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Alarmes**.
1. Escolha **Create Alarm** (Criar alarme).
1. Em **CloudWatch Métricas por categoria**, escolha **CodeBuildMétricas**. Se você souber que deseja apenas métricas no nível do projeto, escolha **By Project (Por projeto)**. Se você souber que deseja apenas métricas no nível da conta, escolha **Account Metrics (Métricas da conta)**.
1. Em **Create Alarm (Criar alarme)**, se ainda não estiver selecionado, escolha **Select Metric (Selecionar métrica)**.
1. Escolha uma métrica para a qual você deseja criar um alarme. As opções são **By Project (Por projeto)** ou **Account Metrics (Métricas da conta)**.
1. Escolha **Next (Próximo)** ou **Define Alarm (Definir alarme)** e, em seguida, crie o alarme. Para obter mais informações, consulte [Criação de CloudWatch alarmes da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) no *Guia do CloudWatch usuário da Amazon*. Para obter mais informações sobre como configurar notificações do Amazon SNS quando um alarme for acionado, consulte [Set up Amazon SNS notifications](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) no *Guia do desenvolvedor do Amazon SNS*.
1. Escolha **Criar Alarm**.