翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# でのログ記録とモニタリング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 は AWS CloudTrail、CodeBuild のユーザー、ロール、または のサービスによって実行されたアクションを記録する AWS サービスである と統合されています。CloudTrail は、 スタックコンソールからの呼び出しや、 スタック API へのコード呼び出しを含む、 スタックのすべての API コールをイベントとしてキャプチャします。証跡を作成する場合は、CodeBuild のイベントなど、S3 バケットへの CloudTrail イベントの継続的な配信を有効にすることができます。証跡を設定しない場合でも、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 の情報について
CloudTrail は、 AWS アカウントの作成時にアカウントで有効になります。CodeBuild でアクティビティが発生すると、そのアクティビティは [**Event history**] (イベント履歴) の他の AWS のサービスイベントと共に CloudTrail イベントに記録されます。 AWS アカウントで最近のイベントを表示、検索、ダウンロードできます。詳細については、*「AWS CloudTrail ユーザーガイド」*の[「Viewing events with CloudTrail event history」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)(CloudTrail イベント履歴でのイベントの表示) を参照してください。
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` ( では `create-project`) AWS CLI、 `StartBuild` ( では `start-project`) AWS CLI、`UpdateProject`および ( では `update-project`) アクションを呼び出すと AWS CLI、CloudTrail ログファイルにエントリが生成されます。
各イベントまたはログエントリには、誰がリクエストを生成したかという情報が含まれます。ID 情報は次の判断に役立ちます。
+ リクエストが、ルートとユーザー認証情報のどちらを使用して送信されたか。
+ リクエストが、ロールとフェデレーションユーザーの一時的なセキュリティ認証情報のどちらを使用して送信されたか。
+ リクエストが別の AWS サービスによって行われたかどうか。
詳細については、*AWS CloudTrail ユーザーガイド*の [CloudTrail userIdentity エレメント](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)を参照してください。
# AWS CodeBuild ログファイルエントリについて
証跡は、指定した S3 バケットにイベントをログファイルとして配信するように設定できます。CloudTrail ログファイルには、1 つ以上のログエントリがあります。イベントはあらゆるソースからの単一のリクエストを表し、リクエストされたアクション、アクションの日時、リクエストのパラメータなどの情報が含まれます。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 パラメータストア](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html)」および「[Systems Manager パラメータストアコンソールのチュートリアル](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 を使用してビルドをモニタリングし、異常が発生した報告して、必要に応じて対応策を取ることができます。ビルドは、次の 2 つのレベルでモニタリングできます。
プロジェクトレベル
これらのメトリクスは、指定したプロジェクトのすべてのビルドが対象となります。プロジェクトのメトリクスを表示するには、CloudWatch でディメンションとして `ProjectName` を指定します。
AWS アカウントレベル
これらのメトリクスは、1 つのアカウントのすべてのビルドが対象となります。 AWS アカウントレベルでメトリクスを表示するには、CloudWatch でディメンションを入力しないでください。ビルドリソース使用率メトリクスは、 AWS アカウントレベルでは使用できません。
CloudWatch メトリクスには、一定期間におけるビルドの動作が示されます。たとえば、以下のことをモニタリングできます。
+ ビルドプロジェクトまたは AWS アカウントで時間の経過とともに試行されたビルドの数。
+ ビルドプロジェクトまたは AWS アカウントで成功したビルドの数。
+ ビルドプロジェクトまたは AWS アカウントで時間の経過とともに失敗したビルドの数。
+ CodeBuild がビルドプロジェクトまたは AWS アカウントでビルドの実行に費やした時間。
+ ビルドまたはビルドプロジェクト全体のリソース使用率を構築します。CPU、メモリ、ストレージ使用率などのリソース使用率メトリクスを構築します。
詳細については、「[CodeBuild メトリクスを表示](monitoring-metrics.md)」を参照してください。
# CodeBuild CloudWatch メトリクス
以下のメトリクスは、 AWS アカウントまたはビルドプロジェクトごとに追跡できます。CodeBuild で CloudWatch を使用する方法の詳細については、「[CloudWatch で CodeBuild ビルドをモニタリング](monitoring-builds.md)」を参照してください。
BuildDuration
ビルドの `BUILD` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
ビルド数
トリガーされたビルドの数を測定します。
単位: Count (個)
有効な CloudWatch 統計: Sum
DownloadSourceDuration
ビルドの `DOWNLOAD_SOURCE` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
Duration
一定期間におけるすべてのビルドの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
FailedBuilds
クライアントエラーまたはタイムアウトのために失敗したビルドの数を測定します。
単位: Count (個)
有効な CloudWatch 統計: Sum
FinalizingDuration
ビルドの `FINALIZING` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
InstallDuration
ビルドの `INSTALL` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
PostBuildDuration
ビルドの `POST_BUILD` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
PreBuildDuration
ビルドの `PRE_BUILD` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
ProvisioningDuration
ビルドの `PROVISIONING` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
QueuedDuration
ビルドの `QUEUED` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
SubmittedDuration
ビルドの `SUBMITTED` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
SucceededBuilds
成功したビルドの数を測定します。
単位: Count (個)
有効な CloudWatch 統計: Sum
UploadArtifactsDuration
ビルドの `UPLOAD_ARTIFACTS` フェーズの所要時間を測定します。
単位: 秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
# CodeBuild CloudWatch リソース使用率メトリックス
**注記**
CodeBuild リソース使用率メトリクスは、以下のリージョンでのみ利用可能です。
Asia Pacific (Tokyo) Region
Asia Pacific (Seoul) Region
Asia Pacific (Mumbai) Region
アジアパシフィック (シンガポール) リージョン
Asia Pacific (Sydney) Region
Canada (Central) Region
欧州 (フランクフルト) リージョン
欧州 (アイルランド) リージョン
欧州 (ロンドン) リージョン
欧州 (パリ) リージョン
South America (São Paulo) Region
米国東部 (バージニア北部) リージョン
US East (Ohio) Region
米国西部 (北カリフォルニア) リージョン
米国西部 (オレゴン) リージョン
次のリソース使用率メトリックを記録できます。CodeBuild で CloudWatch を使用する方法の詳細については、「[CloudWatch で CodeBuild ビルドをモニタリング](monitoring-builds.md)」を参照してください。
CPUUtilized
ビルドコンテナで使用されている、割り当てられた処理の CPU ユニットの数。
単位: CPU 単位
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
CPUUtilizedPercent
ビルドコンテナによって使用される割り当てられた処理の割合。
単位: パーセント
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
MemoryUtilized
ビルドコンテナで使用されるメモリのメガバイト数。
単位: メガバイト
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
MemoryUtilizedPercent
ビルドコンテナで使用されている、割り当てられたメモリの割合。
単位: パーセント
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
StorageReadBytes
ビルドコンテナーによって使用されるストレージの読み取り速度。
単位: バイト/秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
StorageWriteBytes
ビルドコンテナによって使用されるストレージ書き込み速度。
単位: バイト/秒
有効な CloudWatch 統計: Average (推奨)、Maximum、Minimum
# CodeBuild CloudWatch のディメンション
CodeBuild には、以下の CloudWatch メトリクスディメンションが用意されています。これらが指定されていない場合、メトリクスは現在の AWS アカウントのものです。
BuildId、BuildNumber、ProjectName
メトリクスは、ビルド識別子、ビルド番号、およびプロジェクト名に対して提供されます。
ProjectName
プロジェクト名には、メトリクスが提供されます。
# CodeBuild CloudWatch アラーム
CloudWatch コンソールを使用してCodeBuild メトリクスに基づいてアラームを作成できるため、ビルドで問題が発生した場合に対応できます。アラームで最も役立つ 2 つのメトリクスについては、次の箇条書きで説明します。CodeBuild で CloudWatch を使用する方法の詳細については、「[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 マネジメントコンソール し、[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) で AWS CodeBuild コンソールを開きます。
1. ナビゲーションペインで [**Account metrics (アカウントメトリクス)**] を選択します。
### プロジェクトレベルのメトリクス
**プロジェクトレベルのメトリクスを表示するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) で AWS CodeBuild コンソールを開きます。
1. ナビゲーションペインで、[**Build projects**] を選択します。
1. ビルドプロジェクトのリストの [**名前**] 列で、メトリクスを表示するプロジェクトを選択します。
1. [**Metrics**] タブを選択します。
## ビルドメトリクスを表示 (Amazon CloudWatch コンソール)
CloudWatch コンソールでの表示に使用されるメトリクスまたはグラフをカスタマイズすることはできます。
### アカウントレベルのメトリクス
**アカウントレベルのメトリクスを表示するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. ナビゲーションペインで [**Metrics (メトリクス)**] を選択してください。
1. [**All metrics (すべてのメトリクス)**] タブで、[**CodeBuild**] を選択します。
![\[CodeBuild メトリクスを表示する方法です。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. [**アカウントメトリクス**] を選択します。
1. プロジェクトとメトリクスを 1 つ以上選択します。プロジェクトごとに、**[SucceededBuilds]**、**[FailedBuilds]**、**[Builds]**、**[Duration]** の各メトリクスを選択できます。選択されたすべてのプロジェクトとメトリクスの組み合わせが、ページのグラフに表示されます。
### プロジェクトレベルのメトリクス
**プロジェクトレベルのメトリクスを表示するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. ナビゲーションペインで [**Metrics (メトリクス)**] を選択してください。
1. [**All metrics (すべてのメトリクス)**] タブで、[**CodeBuild**] を選択します。
![\[CodeBuild メトリクスを表示する方法です。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. [**By Project (プロジェクト別)**] を選択します。
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 (Tokyo) Region
Asia Pacific (Seoul) Region
Asia Pacific (Mumbai) Region
アジアパシフィック (シンガポール) リージョン
Asia Pacific (Sydney) Region
Canada (Central) Region
欧州 (フランクフルト) リージョン
欧州 (アイルランド) リージョン
欧州 (ロンドン) リージョン
欧州 (パリ) リージョン
South America (São Paulo) Region
米国東部 (バージニア北部) リージョン
US East (Ohio) Region
米国西部 (北カリフォルニア) リージョン
米国西部 (オレゴン) リージョン
次の手順は、リソース使用率メトリクスにアクセスする方法を示しています。
**Topics**
+ [リソース使用率メトリクスへのアクセス (CodeBuild コンソール)](#utilization-metrics-codebuild-console)
+ [リソース使用率メトリクスへのアクセス（Amazon CloudWatch コンソール）](#utilization-metrics-cloudwatch-console)
## リソース使用率メトリクスへのアクセス (CodeBuild コンソール)
**注記**
CodeBuild コンソールで、表示に使用されるメトリクスまたはグラフをカスタマイズすることはできません。表示をカスタマイズする場合は、Amazon CloudWatch コンソールを使用して設定されたビルドメトリクスを表示します。
### プロジェクトレベルのリソース使用率メトリクス
**プロジェクトレベルのリソース使用率メトリクスにアクセスするには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) で AWS CodeBuild コンソールを開きます。
1. ナビゲーションペインで、[**Build projects**] を選択します。
1. ビルドプロジェクトのリストの **[名前]** 列で、使用率メトリクスを表示するプロジェクトを選択します。
1. [**Metrics**] タブを選択します。リソース使用率のメトリクスは、**[リソース使用率メトリクス]** セクションに表示されます。
1. CloudWatch コンソールでプロジェクトレベルのリソース使用率のメトリクスを表示するには、**[リソース使用率メトリクス]** セクションで **[CloudWatch で表示]** を選択します。
### ビルドレベルのリソース使用率メトリクス
**ビルドレベルのリソース使用率メトリクスにアクセスするには**
1. にサインイン AWS マネジメントコンソール し、[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 マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. ナビゲーションペインで [**Metrics (メトリクス)**] を選択してください。
1. [**All metrics (すべてのメトリクス)**] タブで、[**CodeBuild**] を選択します。
![\[[All metrics (すべてのメトリクス)] タブにある [CodeBuild] オプションを示すコンソールのスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. [**By Project (プロジェクト別)**] を選択します。
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 マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. ナビゲーションペインで [**Metrics (メトリクス)**] を選択してください。
1. [**All metrics (すべてのメトリクス)**] タブで、[**CodeBuild**] を選択します。
![\[[All metrics (すべてのメトリクス)] タブにある [CodeBuild] オプションを示すコンソールのスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/images/codebuild-metrics-in-cw.png)
1. **[BuildId、BuildNumber、ProjectName]** を選択します。
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)」を参照してください。
# CloudWatch アラームを使用して CodeBuild ビルドをモニタリング
ビルドの CloudWatch アラームを作成できます。アラームは、指定した期間にわたって 1 つのメトリクスをモニタリングし、複数期間にわたる指定しきい値との比較結果に基づいて 1 つ以上のアクションを実行します。ネイティブ CloudWatch アラーム機能を使用して、しきい値を超えたときに CloudWatch にサポートされる任意のアクションを指定できます。たとえば、15 分以内にアカウントで 3 つ以上のビルドが失敗したときに Amazon SNS 通知が送信されるように指定できます。
**CodeBuild メトリクスの CloudWatch アラームを作成するには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. ナビゲーションペインで、**[Alarms]** (アラーム) を選択します。
1. **[Create Alarm]** (アラームの作成) を選択します。
1. [**CloudWatch Metrics by Category (カテゴリ別の CloudWatch メトリクス)**] で、[**CodeBuild Metrics (CodeBuild メトリクス)**] を選択します。プロジェクトレベルのメトリクスのみでよいことがわかっている場合は、[**By Project (プロジェクト別)**] を選択します。アカウントレベルのメトリクスのみでよいことがわかっている場合は、[**Account Metrics (アカウントメトリクス)**] を選択します。
1. [**Create Alarm (アラームの作成)**] で、まだ選択されていない場合は [**Select Metric (メトリクスの選択)**] を選択します。
1. アラームを作成する対象のメトリクスを選択します。オプションは [**By Project (プロジェクト別)**] または [**Account Metrics (アカウントメトリクス)**] です。
1. [**Next (次へ)**] または [**Define Alarm (アラームの定義)**] を選択し、アラームを作成します。詳細については、*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. **[Create Alarm]** (アラームの作成) を選択します。