のモニタリングAWS CodeBuild

Amazon CloudWatch を使用してビルドをモニタリングし、異常が発生した報告して、必要に応じて対応策を取ることができます。ビルドは、次の 2 つのレベルでモニタリングできます。

プロジェクトレベル

これらのメトリクスは、指定したプロジェクトのすべてのビルドが対象となります。プロジェクトのメトリクスを表示するには、CloudWatch でディメンションとして ProjectName を指定します。

AWS アカウント・レベル

これらのメトリクスは、1 つのアカウントのすべてのビルドが対象となります。AWS アカウントレベルでメトリクスを表示するには、CloudWatch でディメンションを入力しないでください。ビルドリソース使用率のメトリクスは、AWS アカウントレベルでは使用できません。

CloudWatch メトリクスには、一定期間におけるビルドの動作が示されます。たとえば、以下のことをモニタリングできます。

• ビルドプロジェクトまたは AWS アカウントで一定期間に試みられたビルドの数。

• ビルドプロジェクトまたは AWS アカウントで一定期間に成功したビルドの数。

• ビルドプロジェクトまたは AWS アカウントで一定期間に失敗したビルドの数。

• ビルドプロジェクトまたは AWS アカウントで一定期間に CodeBuild がビルドの実行に費やした時間。

• ビルドまたはビルドプロジェクト全体のリソース使用率を構築します。CPU、メモリ、ストレージ使用率などのリソース使用率メトリクスを構築します。

詳細については、「CodeBuild メトリクスのモニタリング」を参照してください。

CodeBuild CloudWatch メトリクス

以下のメトリクスは、AWS アカウントまたはビルドプロジェクトごとに追跡できます。

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 (Singapore) Region

• Asia Pacific (Sydney) Region

• Canada (Central) Region

• Europe (Frankfurt) Region

• 欧州 (アイルランド) リージョン

• 欧州 (ロンドン) リージョン

• 欧州 (パリ) リージョン

• South America (São Paulo) Region

• 米国東部 (バージニア北部) リージョン

• US East (Ohio) Region

• 米国西部 (北カリフォルニア) リージョン

• 米国西部 (オレゴン) リージョン

次のリソース使用率メトリックを記録できます。

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 つのメトリクスは次のとおりです。

• FailedBuild。事前に設定した秒数内に失敗したビルドが一定数検出されたときにトリガーされるアラームを作成できます。CloudWatch で、秒数と、アラームをトリガーするための失敗したビルド数を指定します。

• Duration。ビルドに予想より時間がかかったときにトリガーするアラームを作成できます。ビルドの開始からビルドの完了までの経過所要時間を指定します。この時間を超えるとアラームがトリガーされます。

CodeBuild メトリクスのアラームを作成する方法については、「CloudWatch アラームによるビルドのモニタリング」を参照してください。CloudWatch アラームと、状態の変更の詳細については、Amazon CloudWatch ユーザーガイドの「Amazon CloudWatch アラームの作成」を参照してください。