このイベントは、終了コードに関係なく、タスクが完了すると生成されます。 このイベントを使用して、タスクの期間、タスクが実行された場所、再試行されたかどうかを判断できます。
次の例は、タスク完了イベントの本文を示しています。
{
"jobId": "myJob",
"id": "myTask",
"taskType": "User",
"systemTaskVersion": 0,
"requiredSlots": 1,
"nodeInfo": {
"poolId": "pool-001",
"nodeId": "tvm-257509324_1-20160908t162728z"
},
"multiInstanceSettings": {
"numberOfInstances": 1
},
"constraints": {
"maxTaskRetryCount": 2
},
"executionInfo": {
"startTime": "2016-09-08T16:32:23.799Z",
"endTime": "2016-09-08T16:34:00.666Z",
"exitCode": 0,
"retryCount": 0,
"requeueCount": 0,
"result": "Success",
"schedulingError": {
"category": "",
"code": "",
"message": "",
"details": []
}
}
}
| 要素名 | タイプ | 注記 |
|---|---|---|
jobId |
糸 | タスクを含むジョブの ID。 |
id |
糸 | タスクの ID です。 |
taskType |
糸 | タスクの種類。 タスクの種類は、ジョブ マネージャー タスクであることを示す "JobManager" と、ジョブ マネージャー タスクではないことを示す "ユーザー" のいずれかです。 このイベントは、ジョブ準備タスク、ジョブ解放タスク、または開始タスクには出力されません。 |
systemTaskVersion |
Int32 | タスクの内部再試行カウンター。 内部的には、Batch サービスはタスクを再試行して、一時的な問題を考慮することができます。 これらの問題には、内部スケジュール エラーや、不適切な状態のコンピューティング ノードからの復旧の試行が含まれる場合があります。 |
requiredSlots |
Int32 | タスクを実行するために必要なスロット。 |
nodeInfo |
複合型 | タスクが実行されたコンピューティング ノードに関する情報が含まれます。 |
multiInstanceSettings |
複合型 | タスクが複数のコンピューティング ノードを必要とするマルチインスタンス タスクであることを指定します。 詳細については、multiInstanceSettings を参照してください。 |
constraints |
複合型 | このタスクに適用される実行制約。 |
executionInfo |
複合型 | タスクの実行に関する情報が含まれます。 |
nodeInfo
| 要素名 | タイプ | 注記 |
|---|---|---|
poolId |
糸 | タスクが実行されたプールの ID。 |
nodeId |
糸 | タスクが実行されたノードの ID。 |
multiInstanceSettings
| 要素名 | タイプ | 注記 |
|---|---|---|
numberOfInstances |
Int32 | タスクに必要なコンピューティング ノードの数。 |
制約
| 要素名 | タイプ | 注記 |
|---|---|---|
maxTaskRetryCount |
Int32 | タスクが再試行される最大回数。 終了コードが 0 以外の場合、Batch サービスはタスクを再試行します。 この値は、再試行回数を具体的に制御します。 Batch サービスはタスクを 1 回試行し、この制限まで再試行する場合があります。 たとえば、最大再試行回数が 3 の場合、Batch は最大 4 回 (1 回の最初の再試行と 3 回の再試行) のタスクを試行します。 最大再試行回数が 0 の場合、Batch サービスはタスクを再試行しません。 最大再試行回数が -1 の場合、Batch サービスは制限なくタスクを再試行します。 既定値は 0 (再試行なし) です。 |
executionInfo
| 要素名 | タイプ | 注記 |
|---|---|---|
startTime |
日付と時間 | タスクの実行が開始された時刻。 'Running' は 実行中 の状態に対応するため、タスクでリソース ファイルまたはアプリケーション パッケージが指定されている場合、開始時刻には、タスクがこれらのリソース ファイルまたはアプリケーション パッケージのダウンロードまたはデプロイを開始した時刻が反映されます。 タスクが再起動または再試行された場合、これはタスクの実行を開始した最新の時刻です。 |
endTime |
日付と時間 | タスクが完了した時刻。 |
exitCode |
Int32 | タスクの終了コード。 タスクが実行を開始する前に失敗した場合、exitCode は null になります。 |
retryCount |
Int32 | Batch サービスがタスクを再試行した回数。 タスクは、指定された MaxTaskRetryCount まで、0 以外の終了コードで終了した場合に再試行されます。 |
requeueCount |
Int32 | Batch サービスがユーザー要求の結果としてタスクを再キューした回数。 (サイズ変更または縮小によって) ノードがプールから削除された場合、またはジョブが無効になっている場合は、それらのノードで実行中のタスクを再キューに入れ直すことができます。 この数は、これらの理由からタスクが再キューされた回数を追跡します。 |
result |
糸 | タスクの結果文字列。"Success" または "Failure" である可能性があります。 |
schedulingError |
複合型 | エラーに関する詳細情報が含まれています。 |
schedulingError
| 要素名 | タイプ | 注記 |
|---|---|---|
category |
糸 | エラー カテゴリ ("UserError" など)。 |
code |
糸 | エラー コード (例: "FailureExitCode")。 |
message |
糸 | エラー メッセージ。 |
details |
Array | エラーの詳細。 |