での CloudWatch メトリクスの使用 AWS Batch

AWS Batch は Amazon CloudWatch にジョブメトリクスを発行し、ジョブの状態遷移と期間をモニタリングします。 は、これらのメトリクスを追加料金なしで AWS/Batch名前空間に AWS Batch 発行します。

メトリクスは、ジョブの状態間の移行とジョブの試行が完了すると出力されます。状態遷移メトリクスは、特定の状態に入ったジョブの数を追跡し、期間メトリクスは、ジョブまたはジョブ試行が状態間の移動に費やした時間を追跡します。これらのメトリクスを使用して、CloudWatch ダッシュボードの構築、CloudWatch アラームの設定、ワークロードのパフォーマンスベースラインの確立を行います。詳細については、「Amazon CloudWatch ユーザーガイド」の「CloudWatch メトリクスの使用」および「CloudWatch アラーム CloudWatchの使用」を参照してください。 Amazon CloudWatch

配列ジョブ および のレポート動作は、単一ノードジョブマルチノード並列ジョブとは異なります。次の表の Reporting 動作列では、これらのケースについて説明し、配列と MNP の動作について詳しく配列ジョブとマルチノード並列ジョブのメトリクス説明します。

注記

AWS Batch は、ジョブキューに送信されたジョブに対してこれらのメトリクスを発行します。すべてのメトリクスは JobQueueNameディメンションで発行されます。このディメンションを使用して、ジョブが送信されたジョブキューでメトリクスデータをグループ化およびフィルタリングできます。

重要

これらのメトリクスはベストエフォートベースで提供され、請求、監査、調整ではなく、モニタリングとオブザーバビリティを目的としています。ジョブの状態遷移はイベント駆動型であるため、メトリクスが失われることがあります。たとえば、ジョブの実行が開始され、ほぼすぐに成功または失敗した場合、ジョブが終了RUNNING状態になるまでに 状態への移行が観察されないことがあります。この場合、 AWS Batch はそのジョブのRUNNING移行に関連付けられたメトリクスを出力しません。時折のギャップを許容するようにアラームやダッシュボードを設計し、これらのメトリクスから派生した正確な数に依存しないようにします。

AWS Batch CloudWatch メトリクス

AWS Batch は次のジョブメトリクスを CloudWatch に送信します。状態遷移メトリクスはCount単位を使用し、期間メトリクスはMilliseconds単位を使用します。

次のメトリクスは、タイプに関係なく AWS Batch ジョブに適用されます。

メトリクス	説明	単位	報告動作
JobsSubmitted	ジョブキューに送信されたジョブの数。	カウント	ジョブが最初に送信されたときに発行されます ( SUBMITTED状態になります）。配列ジョブの場合、値は配列のサイズです。
JobsMovedToPending	PENDING 状態に移行したジョブの数。	カウント	ジョブが に移動したときに出力されますPENDING。ジョブは通常、ジョブの依存関係を待機PENDINGしている間です。
JobsMovedToRunnable	RUNNABLE 状態に移行したジョブの数。	カウント	ジョブが初回または再試行の結果として RUNNABLEに移動したときに発行されます。
JobsMovedToStarting	STARTING 状態に移行したジョブの数。	カウント	ジョブが に移動したときに発行されますSTARTING。
JobsMovedToRunning	RUNNING 状態に移行したジョブの数。	カウント	ジョブが に移動したときに出力されますRUNNING。
JobsMovedToSucceeded	正常に完了したジョブの数。	カウント	ジョブが に移動したときに発行されますSUCCEEDED。
JobsMovedToFailed	FAILED 状態に移行したジョブの数。	カウント	ジョブが FAILED状態になったときに発行されます。キャンセルまたは終了したジョブが含まれます。
JobsCancelled	キャンセルされたジョブの数。	カウント	キャンセルリクエストの結果としてジョブが FAILED状態になったときに発行されます (ジョブの実行が開始される前）。
JobsTerminated	終了したジョブの数。	カウント	終了リクエストの結果としてジョブが FAILED状態になったときに発行されます。
JobsRetried	再試行されたジョブの試行回数。	カウント	ジョブの試行が失敗し、ジョブが RUNNABLEに返されて再試行されると出力されます。
JobSubmittedToRunnableDuration	ジョブが から SUBMITTEDになるまでにかかった時間RUNNABLE。	ミリ秒	ジョブが に入ると出力されますRUNNABLE。配列子ジョブの場合、親ジョブが送信された時点から子ジョブが になった時点までの時間を測定しますRUNNABLE。
JobAttemptStartingToRunningDuration	ジョブの試行が実行を開始する前に で費STARTINGやされた時間。	ミリ秒	ジョブが に入ると、試行ごとに出力されますRUNNING。再試行されたジョブは、 に達する試行ごとに 1 つのデータポイントを出力しますRUNNING。
JobAttemptExecutionDuration	ジョブの試行が実行に費やされた時間。試行が開始されてから停止するまでに測定されます。	ミリ秒	ジョブの試行が完了したときに発行され、試行の実行が開始された時点から停止した時点まで測定されます。
JobAttemptDuration	ジョブの試行が継続した合計時間。開始してから試行が終了STARTINGするまでに測定されます。	ミリ秒	試行が終了したときに出力されます。この試行は、ジョブが終了状態 (SUCCEEDED または FAILED) に達したとき、または再試行RUNNABLEのために に戻ったときに終了します。

次のメトリクスは、 AWS Batch コンピューティングジョブにのみ適用されます。

メトリクス	説明	単位	報告動作
JobSubmittedToFirstStartingDuration	ジョブが から で初めて開始SUBMITTEDされるまでにかかった時間STARTING。	ミリ秒	ジョブが最初に に入るときに、最初の試行時に出力されますSTARTING。
JobAttemptRunnableToStartingDuration	ジョブの試行が開始RUNNABLEするまでに費やされた時間。	ミリ秒	ジョブが に入ると出力されますSTARTING。

以下のメトリクスは、 にのみ適用されますのサービスジョブ AWS Batch。

メトリクス	説明	単位	報告動作
JobsMovedToScheduled	SCHEDULED 状態に移行したジョブの数。	カウント	サービスジョブに対して、ジョブが最初に に移動したときに発行されSCHEDULED、プリエンプションSCHEDULED後にジョブが に移動するたびに再度発行されます。
JobSubmittedToFirstScheduledDuration	サービスジョブが から SUBMITTED で初めて になるまでにかかった時間SCHEDULED。	ミリ秒	サービスジョブが最初に に移動したときに出力されますSCHEDULED。
JobAttemptRunnableToScheduledDuration	ジョブの試行が に移行するRUNNABLEまでに費やされた時間SCHEDULED。	ミリ秒	サービスジョブが に移動したときに試行ごとに出力されます。ジョブが に初めて移動したときSCHEDULEDとSCHEDULED、プリエンプションSCHEDULED後に に移動するたびに出力されます。
JobAttemptScheduledToStartingDuration	サービスジョブの試行が、最初の への移行から SCHEDULEDへの移行までにかかった時間STARTING。	ミリ秒	ジョブが から に移行したときにサービスジョブSCHEDULEDに対して発行されますSTARTING。
JobsPreempted	プリエンプションされたジョブの数。	カウント	ジョブが優先されるたびにクォータ管理ジョブに対して発行されます。

配列ジョブとマルチノード並列ジョブのメトリクス

AWS Batch は、1 つ以上の子ジョブを追跡する親ジョブマルチノード並列ジョブとして 配列ジョブおよび を表します。単一の論理ジョブが 2 回カウントされないように、 はジョブタイプに応じて、これら 2 つのレコードのうち 1 つのみからメトリクス AWS Batch を発行します。

配列ジョブ

配列の親ジョブは、 を除いてメトリクスを出力しませんJobsSubmitted。代わりに、各配列の子ジョブは、ジョブのライフサイクルを通じてこれらのメトリクスを個別に出力するため、メトリクス数は、送信された配列ジョブの数ではなく子ジョブの数を反映します。

JobsSubmitted メトリクスは送信時に配列の親ジョブに対して 1 回発行され、その値は配列のサイズ (子ジョブの数) です。たとえば、1,000 人の子を持つ 1 つの配列ジョブを送信すると、 の値を持つ 1 つのJobsSubmittedデータポイントが発行されます1000。

など、送信からの時間を測定する期間メトリクスJobSubmittedToRunnableDurationは、配列の子ジョブごとに出力され、配列の親が送信された時点から、その子が問題の状態に達した時点まで測定されます。

マルチノード並列 (MNP) ジョブ

MNP メトリクスは、ジョブ全体を表す MNP 親ジョブから出力されます。個々の MNP 子 (ノード) ジョブは、これらのメトリクスを出力しません。その結果、MNP ジョブは、使用するノードの数に関係なく 1 回カウントされます。

AWS Batch CloudWatch メトリクスのディメンション

AWS Batch CloudWatch のジョブメトリクスは、単一のディメンション を使用しますJobQueueName。すべてのメトリクスデータは、ジョブが送信されたジョブキューの名前でグループ化およびフィルタリングされます。

View AWS Batch CloudWatch メトリクス

AWS Batch ジョブメトリクスは、 AWS Batch コンソールまたは CloudWatch コンソールの名前AWS/Batch空間で表示できます。

重要

コンソールにメトリクスを表示すると、標準の CloudWatch 料金が発生します。メトリクスの表示はいつでもオフにして、料金を停止できます。詳細については、「Amazon CloudWatch 料金表」をご覧ください。

バッチメトリクスダッシュボードでメトリクスを表示するには

1. AWS Batch コンソールを開きます。

2. ナビゲーションペインで、ダッシュボードを選択し、バッチメトリクスタブを選択します。

3. CloudWatch メトリクスの表示を有効にします。

4. メトリクスをフィルタリング で、最大 5 つのジョブキューとグラフ化するメトリクスを選択します。

5. フィルターを適用 を選択します。コンソールには、メトリクスごとに 1 つのグラフが表示され、ジョブキューごとに 1 行が表示されます。

6. 最初は、フィルターをクリアを選択して選択内容を削除するか、フィルターをリセットしてデフォルトを復元します。

7. (オプション) ジョブキューとメトリクスの組み合わせを再利用するには、保存されたフィルターセットを使用します。フィルターセットは AWS ユーザー設定に保存されるため、セッション間で保持され、最大 5 つ節約できます。保存済みフィルターセットドロップダウンとフィルターのクリアボタンの矢印メニューからそれらを管理し、次のいずれかを選択します。

   • 保存 - ジョブキューとメトリクスを選択し、新しいフィルターセットとして保存を選択します。一意の名前を入力し、オプションでデフォルトとしてマークします。

   • 適用 - 保存済みフィルターセットドロップダウンからセットを選択し、フィルターを適用を選択します。

   • 更新 - セットを選択した状態で、選択を変更し、現在のフィルターセットの更新を選択します。

   • デフォルトとして設定 - セットを選択した状態で、設定を選択し、デフォルトとして設定を選択します。タブを開くと、デフォルトのセットが自動的にロードされます。

   • 削除 - セットを選択し、現在のフィルターセットの削除を選択します。

1 つのジョブキューのメトリクスを表示するには

1. ナビゲーションペインで、ジョブキューを選択し、ジョブキューを選択します。

2. [モニタリング] タブを選択します。

3. CloudWatch メトリクスの表示を有効にします。

4. 状態遷移メトリクス、ライフサイクルイベントメトリクス、期間メトリクスセクションで、各メトリクスセレクタを使用してグラフ化するメトリクスを選択します。

表示されるメトリクスは、このジョブキューに限定されます。選択内容はジョブキューごとに保存され、セッション間で保持されます。

ダッシュボードの構築やアラームの設定など、CloudWatch でこれらのメトリクスを直接操作するには、CloudWatch コンソールを開き、AWS/Batch名前空間を選択します。