기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS CodeBuild에서 로깅 및 모니터링
로깅 및 모니터링은 AWS CodeBuild와 사용자의 AWS 솔루션의 안정성, 가용성 및 성능을 유지하는 중요한 역할을 합니다. 다중 지점 실패가 발생할 경우 보다 쉽게 디버깅할 수 있도록 AWS 솔루션의 모든 부분으로부터 모니터링 데이터를 수집해야 합니다. AWS는 CodeBuild 리소스 및 빌드를 모니터링하고 잠재적 인시던트에 대응하기 위한 다음 도구를 제공합니다.
**Topics**
+ [를 사용하여 AWS CodeBuild API 호출 로깅 AWS CloudTrail](cloudtrail.md)
+ [CloudWatch를 사용하여 CodeBuild 빌드 모니터링](monitoring-builds.md)
# 를 사용하여 AWS CodeBuild API 호출 로깅 AWS CloudTrail
AWS CodeBuild 는 CodeBuild에서 사용자 AWS CloudTrail, 역할 또는 서비스가 수행한 작업에 대한 레코드를 제공하는 AWS 서비스와 통합됩니다. CloudTrail은 CodeBuild 콘솔의 호출 및 CodeBuild API에 대한 코드 호출을 포함하여 CodeBuild에 대한 모든 API 직접 호출을 이벤트로 캡처합니다. 추적을 생성하면 CodeBuild 이벤트를 포함한 CloudTrail 이벤트를 지속적으로 S3 버킷에 배포할 수 있습니다. 추적을 구성하지 않은 경우에도 **이벤트 기록**에서 CloudTrail 콘솔의 최신 이벤트를 볼 수 있습니다. CloudTrail에서 수집한 정보를 사용하여 CodeBuild에 수행된 요청, 요청이 수행된 IP 주소, 요청을 수행한 사람, 요청이 수행된 시간 및 추가 세부 정보를 확인할 수 있습니다.
CloudTrail에 대한 자세한 내용은 [AWS CloudTrail 사용 설명서](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)를 참조하세요.
**Topics**
+ [CloudTrail의 AWS CodeBuild 정보](service-name-info-in-cloudtrail.md)
+ [AWS CodeBuild 로그 파일 항목 정보](understanding-service-name-entries.md)
# CloudTrail의 AWS CodeBuild 정보
AWS 계정을 생성할 때 계정에서 CloudTrail이 활성화됩니다. CodeBuild에서 활동이 발생하면 해당 활동이 **이벤트 기록**의 다른 AWS 서비스 이벤트와 함께 CloudTrail 이벤트에 기록됩니다. AWS 계정에서 최근 이벤트를 보고 검색하고 다운로드할 수 있습니다. 자세한 내용은 *AWS CloudTrail 사용 설명서*의 [CloudTrail 이벤트 기록으로 이벤트 보기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)를 참조하세요.
CodeBuild에 대한 이벤트를 포함하여 AWS 계정에 이벤트를 지속적으로 기록하려면 추적을 생성합니다. 추적은 CloudTrail이 S3 버킷으로 로그 파일을 전송할 수 있도록 합니다. 콘솔에서 트레일을 생성하면 기본적으로 모든 리전에 트레일이 적용됩니다. 추적은 AWS 파티션의 모든 리전에서 이벤트를 로깅하고 지정한 S3 버킷으로 로그 파일을 전송합니다. CloudTrail 로그에서 수집된 이벤트 데이터를 추가로 분석하고 조치를 취하도록 다른 AWS 서비스를 구성할 수 있습니다. 자세한 내용은 다음을 참조하세요.
+ [추적 생성 개요](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail 지원 서비스 및 통합](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [CloudTrail에 대한 Amazon SNS 알림 구성](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [여러 리전에서 CloudTrail 로그 파일 받기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) 및 [여러 계정에서 CloudTrail 로그 파일 받기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
모든 CodeBuild 작업은 CloudTrail에서 로깅되고 [CodeBuild API 참조](https://docs.aws.amazon.com/codebuild/latest/APIReference/)에 기록됩니다. 예를 들어, `CreateProject` (, AWS CLI`create-project`), `StartBuild` ( AWS CLI, `start-project`) 및 `UpdateProject` () AWS CLI`update-project`작업에 대한 호출은 CloudTrail 로그 파일에 항목을 생성합니다.
모든 이벤트 또는 로그 항목에는 요청을 생성했던 사용자에 관한 정보가 포함됩니다. 보안 인증 정보를 이용하면 다음을 쉽게 판단할 수 있습니다.
+ 요청을 루트로 했는지 아니면 사용자 자격 증명으로 했는지 여부
+ 역할 또는 페더레이션 사용자에 대한 임시 보안 인증을 사용하여 요청이 생성되었는지 여부.
+ 요청이 다른 AWS 서비스에서 이루어졌는지 여부입니다.
자세한 내용은AWS CloudTrail 사용 설명서의 [CloudTrail userIdentity 요소](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)를 참조하세요.**
# AWS CodeBuild 로그 파일 항목 정보
추적이란 지정한 S3 버킷에 이벤트를 로그 파일로 입력할 수 있도록 하는 구성입니다. CloudTrail 로그 파일에는 하나 이상의 로그 항목이 포함될 수 있습니다. 이벤트는 모든 소스의 단일 요청을 나타내며 요청된 작업, 작업 날짜와 시간, 요청 파라미터 등에 대한 정보를 포함하고 있습니다. CloudTrail 로그 파일은 퍼블릭 API 직접 호출에 대한 순서 지정된 스택 추적이 아니기 때문에 특정 순서로 표시되지 않습니다.
**참고**
중요한 정보를 보호하기 위해 CodeBuild 로그에 다음 항목이 숨겨져 있습니다.
AWS 액세스 키 IDs. 자세한 내용은AWS Identity and Access Management 사용 설명서에서 [IAM 사용자의 액세스 키 관리](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)를 참조하세요.**
파라미터 스토어를 사용하여 지정된 문자열입니다. 자세한 내용은 Amazon EC2 Systems Manager 사용 설명서의 [Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html) 및 [Systems Manager Parameter Store 콘솔 연습](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-walk.html#sysman-paramstore-console)을 참조하세요.**
를 사용하여 지정된 문자열입니다 AWS Secrets Manager. 자세한 내용은 [키 관리](security-key-management.md) 단원을 참조하십시오.
다음은 CodeBuild에서 빌드 프로젝트 만들기 작업을 보여 주는 CloudTrail 로그 항목의 예입니다.
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "FederatedUser",
"principalId": "account-ID:user-name",
"arn": "arn:aws:sts::account-ID:federated-user/user-name",
"accountId": "account-ID",
"accessKeyId": "access-key-ID",
"sessionContext": {
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2016-09-06T17:59:10Z"
},
"sessionIssuer": {
"type": "IAMUser",
"principalId": "access-key-ID",
"arn": "arn:aws:iam::account-ID:user/user-name",
"accountId": "account-ID",
"userName": "user-name"
}
}
},
"eventTime": "2016-09-06T17:59:11Z",
"eventSource": "codebuild.amazonaws.com",
"eventName": "CreateProject",
"awsRegion": "region-ID",
"sourceIPAddress": "127.0.0.1",
"userAgent": "user-agent",
"requestParameters": {
"awsActId": "account-ID"
},
"responseElements": {
"project": {
"environment": {
"image": "image-ID",
"computeType": "BUILD_GENERAL1_SMALL",
"type": "LINUX_CONTAINER",
"environmentVariables": []
},
"name": "codebuild-demo-project",
"description": "This is my demo project",
"arn": "arn:aws:codebuild:region-ID:account-ID:project/codebuild-demo-project:project-ID",
"encryptionKey": "arn:aws:kms:region-ID:key-ID",
"timeoutInMinutes": 10,
"artifacts": {
"location": "arn:aws:s3:::codebuild-region-ID-account-ID-output-bucket",
"type": "S3",
"packaging": "ZIP",
"outputName": "MyOutputArtifact.zip"
},
"serviceRole": "arn:aws:iam::account-ID:role/CodeBuildServiceRole",
"lastModified": "Sep 6, 2016 10:59:11 AM",
"source": {
"type": "GITHUB",
"location": "https://github.com/my-repo.git"
},
"created": "Sep 6, 2016 10:59:11 AM"
}
},
"requestID": "9d32b228-745b-11e6-98bb-23b67EXAMPLE",
"eventID": "581f7dd1-8d2e-40b0-aeee-0dbf7EXAMPLE",
"eventType": "AwsApiCall",
"recipientAccountId": "account-ID"
}
```
# CloudWatch를 사용하여 CodeBuild 빌드 모니터링
Amazon CloudWatch를 사용하여 빌드를 관찰하고, 문제 발생 시 보고하고, 적절한 경우 자동 조치를 취할 수 있습니다. 두 수준에서 빌드를 모니터링할 수 있습니다.
프로젝트 수준
이러한 지표는 지정된 프로젝트의 모든 빌드에 대한 것입니다. 프로젝트의 지표를 보려면 CloudWatch의 차원에 `ProjectName`을 지정합니다.
AWS 계정 수준
이러한 지표는 한 계정의 모든 빌드에 대한 것입니다. AWS 계정 수준에서 지표를 보려면 CloudWatch에 차원을 입력하지 마세요. 빌드 리소스 사용률 지표는 AWS 계정 수준에서 사용할 수 없습니다.
CloudWatch 지표는 일정 기간 동안의 빌드의 양상을 보여 줍니다. 예를 들면, 다음을 모니터링할 수 있습니다.
+ 시간 경과에 따라 빌드 프로젝트 또는 AWS 계정에서 시도된 빌드 수입니다.
+ 시간 경과에 따라 빌드 프로젝트 또는 AWS 계정에서 성공한 빌드 수입니다.
+ 시간 경과에 따라 빌드 프로젝트 또는 AWS 계정에서 실패한 빌드 수입니다.
+ CodeBuild가 시간 경과에 따라 빌드 프로젝트 또는 AWS 계정에서 빌드를 실행하는 데 소요한 시간입니다.
+ 빌드 또는 전체 빌드 프로젝트의 빌드 리소스 사용률입니다. 빌드 리소스 사용률 지표에는 CPU, 메모리, 스토리지 사용률과 같은 지표가 포함됩니다.
자세한 내용은 [CodeBuild 지표 보기](monitoring-metrics.md) 단원을 참조하십시오.
# CodeBuild CloudWatch 지표
AWS 계정 또는 빌드 프로젝트별로 다음 지표를 추적할 수 있습니다. CloudWatch를 CodeBuild와 함께 사용하는 자세한 방법은 [CloudWatch를 사용하여 CodeBuild 빌드 모니터링](monitoring-builds.md) 섹션을 참조하세요.
BuildDuration
빌드의 `BUILD` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
빌드
트리거된 빌드 수를 측정합니다.
단위: 개
유효한 CloudWatch 통계: 합계
DownloadSourceDuration
빌드의 `DOWNLOAD_SOURCE` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
지속 시간
일정 기간 동안 모든 빌드 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
FailedBuilds
클라이언트 오류 또는 시간 초과로 인해 실패한 빌드 수를 측정합니다.
단위: 개
유효한 CloudWatch 통계: 합계
FinalizingDuration
빌드의 `FINALIZING` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
InstallDuration
빌드의 `INSTALL` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
PostBuildDuration
빌드의 `POST_BUILD` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
PreBuildDuration
빌드의 `PRE_BUILD` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
ProvisioningDuration
빌드의 `PROVISIONING` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
QueuedDuration
빌드의 `QUEUED` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
SubmittedDuration
빌드의 `SUBMITTED` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
SucceededBuilds
성공한 빌드 수를 측정합니다.
단위: 개
유효한 CloudWatch 통계: 합계
UploadArtifactsDuration
빌드의 `UPLOAD_ARTIFACTS` 단계 지속 시간을 측정합니다.
단위: 초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
# CodeBuild CloudWatch 리소스 사용률 지표
**참고**
CodeBuild 리소스 사용률 지표는 다음 리전에서만 사용할 수 있습니다.
아시아 태평양(도쿄) 리전
Asia Pacific (Seoul) Region
Asia Pacific (Mumbai) Region
Asia Pacific (Singapore) Region
Asia Pacific (Sydney) Region
캐나다(중부) 리전
Europe (Frankfurt) Region
유럽(아일랜드) 리전
Europe (London) Region
Europe (Paris) Region
South America (São Paulo) Region
US East (N. Virginia) Region
US East (Ohio) Region
US West (N. California) Region
미국 서부(오리건) 리전
다음 리소스 사용률 지표를 추적할 수 있습니다. CloudWatch를 CodeBuild와 함께 사용하는 자세한 방법은 [CloudWatch를 사용하여 CodeBuild 빌드 모니터링](monitoring-builds.md) 섹션을 참조하세요.
CpuUtilized
빌드 컨테이너에서 사용하는 할당된 처리의 CPU 단위 수입니다.
단위: CPU 단위
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
CPUUtilizedPercent
빌드 컨테이너에서 사용된 할당된 처리의 비율입니다.
단위: 백분율
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
MemoryUtilized
빌드 컨테이너가 사용된 메모리 크기(메가바이트)입니다.
단위: 메가바이트
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
MemoryUtilizedPercent
빌드 컨테이너에서 사용된 할당된 메모리의 비율입니다.
단위: 백분율
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
StorageReadBytes
빌드 컨테이너에서 사용된 스토리지 읽기 속도입니다.
단위: 바이트/초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
StorageWriteBytes
빌드 컨테이너에서 사용된 스토리지 쓰기 속도입니다.
단위: 바이트/초
유효한 CloudWatch 통계: 평균(권장), 최대, 최소
# CodeBuild CloudWatch 차원
CodeBuild는 다음과 같은 CloudWatch 지표 차원을 제공합니다. 이 중 아무 것도 지정하지 않으면 지표는 현재 AWS 계정에 대한 것입니다.
BuildId, BuildNumber, ProjectName
빌드 식별자, 빌드 번호, 프로젝트 이름에 대한 지표가 제공됩니다.
ProjectName
프로젝트 이름에 대한 지표가 제공됩니다.
# CodeBuild CloudWatch 경보
CloudWatch 콘솔을 사용하여 CodeBuild 지표를 기준으로 경보를 생성함으로써 빌드에 문제가 생길 경우 조치를 취할 수 있습니다. 경보에 가장 유용한 두 가지 지표는 다음 글머리 기호에 설명되어 있습니다. CloudWatch를 CodeBuild와 함께 사용하는 자세한 방법은 [CloudWatch를 사용하여 CodeBuild 빌드 모니터링](monitoring-builds.md) 섹션을 참조하세요.
+ `FailedBuild`. 지정한 시간(초) 내에 특정 수의 실패한 빌드 수가 감지될 경우 트리거되는 경보를 만들 수 있습니다. CloudWatch에서 경보를 발생시킬 실패 빌드 수와 시간(초)을 지정합니다.
+ `Duration`. 빌드가 예상한 것보다 오래 걸릴 경우 트리거되는 경보를 만들 수 있습니다. 빌드가 시작된 후 완료되기까지 걸리는 시간(초)을 지정하여 이 시간을 초과할 경우 경보를 생성하도록 지정합니다.
CodeBuild 지표에 대한 경보를 만드는 방법은 [CloudWatch 경보를 사용한 CodeBuild 빌드 모니터링](monitoring-alarms.md) 섹션을 참조하세요. 경보에 대한 자세한 내용은 Amazon CloudWatch 사용 설명서의 [Amazon CloudWatch 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)을 참조하세요.**
# CodeBuild 지표 보기
AWS CodeBuild 는 사용자를 대신하여 함수를 모니터링하고 Amazon CloudWatch를 통해 지표를 보고합니다. 이러한 지표에는 총 빌드, 실패한 빌드, 성공한 빌드, 빌드 기간 등이 포함됩니다.
CodeBuild 콘솔 또는 CloudWatch 콘솔을 사용하여 CodeBuild에 대한 지표를 모니터링할 수 있습니다. 다음 절차에서는 지표에 보는 방법을 보여 줍니다.
**Topics**
+ [빌드 지표 보기(CodeBuild 콘솔)](#metrics-in-codebuild-console)
+ [빌드 지표 보기(Amazon CloudWatch 콘솔)](#metrics-in-cloudwatch-console)
## 빌드 지표 보기(CodeBuild 콘솔)
**참고**
CodeBuild 콘솔에서는 지표를 표시하는 데 사용되는 지표나 그래프를 사용자 지정할 수 없습니다. 디스플레이를 사용자 지정하려면 Amazon CloudWatch 콘솔을 사용하여 빌드 지표를 확인합니다.
### 계정 수준 지표
**AWS 계정 수준 지표를 보려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) AWS CodeBuild 콘솔을 엽니다.
1. 탐색 창에서 **계정 지표**를 선택합니다.
### 프로젝트 수준 지표
**프로젝트 수준 지표를 보려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) AWS CodeBuild 콘솔을 엽니다.
1. 탐색 창에서 **프로젝트 빌드**를 선택합니다.
1. 빌드 프로젝트 목록의 **이름** 열에서 지표를 보려는 프로젝트를 선택합니다.
1. **지표** 탭을 선택합니다.
## 빌드 지표 보기(Amazon CloudWatch 콘솔)
CloudWatch 콘솔에서 지표 및 지표를 표시하는 데 사용되는 그래프를 사용자 지정할 수 있습니다.
### 계정 수준 지표
**계정 수준 지표를 보려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **지표(Metrics)**를 선택합니다.
1. **모든 지표** 탭에서 **CodeBuild**를 선택합니다.
![\[CodeBuild 지표를 보는 방법입니다.\]](http://docs.aws.amazon.com/ko_kr/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. **계정 지표**를 선택합니다.
1. 하나 이상의 프로젝트 및 지표를 선택합니다. 각 프로젝트에 대해 **SucceededBuilds**, **FailedBuilds**, **Builds** 및 **Duration** 지표를 선택할 수 있습니다. 선택한 모든 프로젝트 및 지표 조합이 페이지의 그래프에 표시됩니다.
### 프로젝트 수준 지표
**프로젝트 수준 지표를 보려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **지표(Metrics)**를 선택합니다.
1. **모든 지표** 탭에서 **CodeBuild**를 선택합니다.
![\[CodeBuild 지표를 보는 방법입니다.\]](http://docs.aws.amazon.com/ko_kr/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. **프로젝트별**을 선택합니다.
1. 하나 이상의 프로젝트 및 지표 조합을 선택합니다. 각 프로젝트에 대해 **SucceededBuilds**, **FailedBuilds**, **Builds** 및 **Duration** 지표를 선택할 수 있습니다. 선택한 모든 프로젝트 및 지표 조합이 페이지의 그래프에 표시됩니다.
1. (선택 사항) 지표 및 그래프를 사용자 지정할 수 있습니다. 예를 들어 **통계** 열의 드롭다운 목록에서 표시할 다른 통계를 선택할 수 있습니다. 또는 **기간** 열의 드롭다운 메뉴에서 지표를 모니터링하는 데 사용할 다른 기간을 선택할 수 있습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 [그래프 지표](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) 및 [사용 가능한 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)를 참조하세요.**
# CodeBuild 리소스 사용률 지표 보기
AWS CodeBuild 는 사용자를 대신하여 빌드 리소스 사용률을 모니터링하고 Amazon CloudWatch를 통해 지표를 보고합니다. 여기에는 CPU, 메모리, 스토리지 사용률과 같은 지표가 포함됩니다.
**참고**
CodeBuild 리소스 사용률 지표는 1분 넘게 실행되는 빌드에 대해서만 기록됩니다.
CodeBuild 콘솔 또는 CloudWatch 콘솔을 사용하여 CodeBuild에 대한 리소스 사용률 지표를 모니터링할 수 있습니다.
**참고**
CodeBuild 리소스 사용률 지표는 다음 리전에서만 사용할 수 있습니다.
아시아 태평양(도쿄) 리전
Asia Pacific (Seoul) Region
Asia Pacific (Mumbai) Region
Asia Pacific (Singapore) Region
Asia Pacific (Sydney) Region
캐나다(중부) 리전
Europe (Frankfurt) Region
유럽(아일랜드) 리전
Europe (London) Region
Europe (Paris) Region
South America (São Paulo) Region
US East (N. Virginia) Region
US East (Ohio) Region
US West (N. California) Region
미국 서부(오리건) 리전
다음 절차에서는 리소스 사용률 지표에 액세스하는 방법을 보여 줍니다.
**Topics**
+ [리소스 사용률 지표 액세스(CodeBuild 콘솔)](#utilization-metrics-codebuild-console)
+ [리소스 사용률 지표 액세스(Amazon CloudWatch 콘솔)](#utilization-metrics-cloudwatch-console)
## 리소스 사용률 지표 액세스(CodeBuild 콘솔)
**참고**
CodeBuild 콘솔에서는 지표를 표시하는 데 사용되는 지표나 그래프를 사용자 지정할 수 없습니다. 디스플레이를 사용자 지정하려면 Amazon CloudWatch 콘솔을 사용하여 빌드 지표를 확인합니다.
### 프로젝트 수준 리소스 사용률 지표
**프로젝트 수준 리소스 사용률 지표에 액세스하려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) AWS CodeBuild 콘솔을 엽니다.
1. 탐색 창에서 **프로젝트 빌드**를 선택합니다.
1. 빌드 프로젝트 목록의 **이름** 열에서 사용률 지표를 보려는 프로젝트를 선택합니다.
1. **지표** 탭을 선택합니다. 리소스 사용률 지표는 **리소스 사용률 지표** 섹션에 표시됩니다.
1. CloudWatch 콘솔에서 프로젝트 수준 리소스 사용률 지표를 보려면 **리소스 사용률 지표** 섹션에서 **CloudWatch에서 보기**를 선택합니다.
### 빌드 수준의 리소스 사용률 지표
**빌드 수준 리소스 사용률 지표에 액세스하려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) AWS CodeBuild 콘솔을 엽니다.
1. 탐색 창에서 [**Build history**]를 선택합니다.
1. 빌드 목록의 **빌드 실행** 열에서 사용률 지표를 보려는 빌드를 선택합니다.
1. **리소스 사용률** 탭을 선택합니다.
1. CloudWatch 콘솔에서 빌드 수준 리소스 사용률 지표를 보려면 **리소스 사용률 지표** 섹션에서 **CloudWatch에서 보기**를 선택합니다.
## 리소스 사용률 지표 액세스(Amazon CloudWatch 콘솔)
Amazon CloudWatch 콘솔을 사용하여 CodeBuild 리소스 사용률 지표에 액세스할 수 있습니다.
### 프로젝트 수준 리소스 사용률 지표
**프로젝트 수준 리소스 사용률 지표에 액세스하려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **지표(Metrics)**를 선택합니다.
1. **모든 지표** 탭에서 **CodeBuild**를 선택합니다.
![\[모든 지표 탭에 있는 CodeBuild 옵션을 보여 주는 콘솔 스크린샷\]](http://docs.aws.amazon.com/ko_kr/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. **프로젝트별**을 선택합니다.
1. 그래프에 추가할 하나 이상의 프로젝트와 지표 조합을 선택합니다. 선택한 모든 프로젝트 및 지표 조합이 페이지의 그래프에 표시됩니다.
1. (선택 사항) **그래프로 표시된 지표** 탭에서 지표와 그래프를 사용자 지정할 수 있습니다. 예를 들어 **통계** 열의 드롭다운 목록에서 표시할 다른 통계를 선택할 수 있습니다. 또는 **기간** 열의 드롭다운 메뉴에서 지표를 모니터링하는 데 사용할 다른 기간을 선택할 수 있습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 [그래프 지표](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) 및 [사용 가능한 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)를 참조하세요.**
### 빌드 수준의 리소스 사용률 지표
**빌드 수준 리소스 사용률 지표에 액세스하려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **지표(Metrics)**를 선택합니다.
1. **모든 지표** 탭에서 **CodeBuild**를 선택합니다.
![\[모든 지표 탭에 있는 CodeBuild 옵션을 보여 주는 콘솔 스크린샷\]](http://docs.aws.amazon.com/ko_kr/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. **BuildId, BuildNumber, ProjectName**을 선택합니다.
1. 그래프에 추가할 하나 이상의 빌드와 지표 조합을 선택합니다. 선택한 모든 빌드 및 지표 조합이 페이지의 그래프에 표시됩니다.
1. (선택 사항) **그래프로 표시된 지표** 탭에서 지표와 그래프를 사용자 지정할 수 있습니다. 예를 들어 **통계** 열의 드롭다운 목록에서 표시할 다른 통계를 선택할 수 있습니다. 또는 **기간** 열의 드롭다운 메뉴에서 지표를 모니터링하는 데 사용할 다른 기간을 선택할 수 있습니다.
자세한 내용은 Amazon CloudWatch 사용 설명서의 [그래프 지표](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) 및 [사용 가능한 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)를 참조하세요.**
# CloudWatch 경보를 사용한 CodeBuild 빌드 모니터링
빌드에 대한 CloudWatch 경보를 생성할 수 있습니다. 경보는 지정한 기간에 단일 메트릭을 감시하고 여러 기간에 지정된 임계값에 대한 메트릭 값을 기준으로 작업을 하나 이상 수행합니다. 기본 CloudWatch 경보 기능을 사용하면 임계값 초과 시 CloudWatch에서 지원하는 모든 작업을 지정할 수 있습니다. 예를 들어, 15분 이내에 계정의 빌드가 4개 이상 실패할 경우 Amazon SNS 알림이 전송되도록 지정할 수 있습니다.
**CodeBuild 지표에 대한 CloudWatch 경보를 생성하려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **경보(Alarms)**를 선택하세요.
1. **경보 생성**을 선택합니다.
1. **범주별 CloudWatch 지표**에서 **CodeBuild 지표**를 선택합니다. 프로젝트 수준 지표만 사용하려는 경우 **프로젝트별**을 선택합니다. 계정 수준 지표만 사용하려는 경우 **계정 지표**를 선택합니다.
1. **경보 생성**에서 아직 선택하지 않은 경우 **지표 선택**을 선택합니다.
1. 경보를 생성하려는 지표를 선택합니다. 옵션은 **프로젝트별** 또는 **계정 지표**입니다.
1. **다음** 또는 **경보 정의**를 선택한 다음, 경보를 생성합니다. 자세한 내용은 Amazon CloudWatch 사용 설명서의 [Amazon CloudWatch 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)을 참조하세요.** 경보가 트리거될 때 Amazon SNS 알림을 설정하는 방법에 대한 자세한 내용은 Amazon SNS 개발자 안내서의 [Amazon SNS 알림 설정](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html)을 참조하세요.**
1. **경보 생성**을 선택합니다.