このドキュメントでは、バッチジョブとタスクのステータス イベントを表示する方法について説明します。ステータス イベントは、ジョブの分析に使用できる履歴を提供します。多くの場合、トラブルシューティングに使用できる有用なエラー メッセージが含まれています。
各ジョブとそのタスクにはステータス イベントがあり、ジョブの実行中、Batch によって自動的に作成されます。各ステータス イベントは、状態の変化と、その状態になった理由の詳細を表します。ジョブとタスクの状態の詳細については、ジョブのライフサイクルをご覧ください。必要に応じて、実行可能ファイルの進行状況を示すカスタム ステータス イベントを持つようにジョブを構成することもできます。カスタム ステータス イベントの詳細については、カスタム ステータス イベントの構成をご覧ください。
準備
- Batch を以前に使用したことがない場合は、Batch を使ってみるを確認し、プロジェクトとユーザーの前提条件を完了して Batch を有効にします。
-
ジョブとタスクを表示するために必要な権限を取得するには、管理者にプロジェクトのバッチジョブ閲覧者(
roles/batch.jobsViewer
)またはバッチジョブ編集者(roles/batch.jobsEditor
)の IAM ロールを付与するように依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。
ステータス イベントを表示する
異なるステータス イベントが、ジョブレベル(ジョブの statusEvents[]
フィールド)とタスクレベル(各タスクの statusEvents[]
フィールド)で表示される場合があります。
次の手順では、Google Cloud コンソール、gcloud CLI、Batch API を使用してステータス イベントを表示する方法について説明します。クライアント ライブラリ言語を使用するには、ジョブの詳細を表示またはタスクの詳細を表示するの手順に沿って操作し、対応する statusEvents[]
フィールドをご覧ください。
ジョブのステータス イベントを表示する
コンソール
Google Cloud コンソールを使用して現在のプロジェクトのジョブの詳細を表示するには、次の手順に沿って操作します。
Google Cloud コンソールで、[ジョブリスト] ページに移動します。
[ジョブ名] 列で、ジョブの名前をクリックします。
[ジョブの詳細] ページが開きます。
デフォルトで [詳細] タブが開きます。
[イベント] タブをクリックします。
gcloud
gcloud CLI を使用してジョブのステータス イベントを表示するには、gcloud batch jobs describe
コマンドを使用してから、statusEvents[]
フィールドを確認します。
gcloud batch jobs describe JOB_NAME \
--location=LOCATION
次のように置き換えます。
JOB_NAME
: 既存のジョブの名前。LOCATION
: ジョブが存在するロケーション。
API
Batch API を使用してジョブのステータス イベントを表示するには、jobs.get
メソッドに GET
リクエストを行い、statusEvents[]
フィールドを確認します。
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME
次のように置き換えます。
タスクのステータス イベントを表示する
gcloud
gcloud CLI を使用してタスクのステータス イベントを表示するには、gcloud batch tasks describe
コマンドを使用してから、statusEvents[]
フィールドを確認します。
gcloud batch tasks describe TASK_INDEX \
--location=LOCATION \
--job=JOB_NAME \
--task_group=TASK_GROUP_NAME
次のように置き換えます。
API
Batch API を使用してタスクのステータス イベントを表示するには、tasks.get
メソッドに GET
リクエストを行い、statusEvents[]
フィールドを確認します。
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX
次のように置き換えます。
次のステップ
エラーを説明する Batch のステータス イベントを理解するには、トラブルシューティングをご覧ください。
実行可能ファイルの開始と終了のステータス イベントなど、ジョブの詳細な履歴が必要な場合は、カスタム ステータス イベントを構成します。
ログを使用してジョブを分析する方法を確認する。