次の方法で共有

タスクの失敗イベント

このイベントは、タスクが失敗して完了したときに生成されます。 現在、0 以外のすべての終了コードは失敗と見なされます。 このイベントは、タスク完了イベント に加えて 生成され、タスクが失敗したときに検出するために使用できます。

次の例は、タスクの失敗イベントの本文を示しています。

{
    "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": 1,
        "retryCount": 2,
        "requeueCount": 0,
        "result": "Failure",
        "schedulingError": {
            "category": "UserError",
            "code": "FailureExitCode",
            "message": "The task exited with an exit code representing a failure",
            "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 DateTime タスクの実行が開始された時刻。 'Running' は 実行中 の状態に対応するため、タスクでリソース ファイルまたはアプリケーション パッケージが指定されている場合、開始時刻には、タスクがダウンロードまたはデプロイを開始した時刻が反映されます。 タスクが再起動または再試行された場合は、タスクの実行が開始された最新の時刻です。
endTime DateTime タスクが完了した時刻。
exitCode Int32 タスクの終了コード。 タスクが実行を開始する前に失敗した場合、exitCode は null になります。
retryCount Int32 Batch サービスがタスクを再試行した回数。 タスクは、指定された MaxTaskRetryCount まで、0 以外の終了コードで終了した場合に再試行されます。
requeueCount Int32 Batch サービスがユーザー要求の結果としてタスクを再キューした回数。

(サイズ変更または縮小によって) ノードがプールから削除された場合、またはジョブが無効になっている場合は、それらのノードで実行中のタスクを再キューに入れ直すことができます。 この数は、これらの理由からタスクが再キューされた回数を追跡します。
result 糸 タスクの結果文字列。"Success" または "Failure" にすることができます。
schedulingError 複合型 エラーに関する詳細情報が含まれています。

schedulingError

要素名 タイプ 注記
category 糸 エラー カテゴリ ("UserError" など)。
code 糸 エラー コード (例: "FailureExitCode")。
message 糸 エラー メッセージ。
details Array エラーの詳細。
  • Last updated on