工作失敗事件

當工作因失敗而完成時,就會發出此事件。 目前所有非零結束代碼都會被視為失敗。 除了工作完成事件 之外 ,也會發出此事件,並可用來偵測工作失敗的時間。

下列範例顯示工作失敗事件的主體。

{
    "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 繩子 工作識別碼。
taskType 繩子 工作的型別。 它可能是 『JobManager』,表示它是作業管理員工作,或 「使用者」表示它不是作業管理員工作。 此事件不會用於工作準備任務、工作釋放任務或開始任務。
systemTaskVersion Int32 這是工作的內部重試計數器。 在內部,Batch 服務可以重試工作以考慮暫時性問題。 這些問題可能包括內部排程錯誤,或嘗試從處於不良狀態的計算節點復原。
requiredSlots Int32 執行工作所需的位置。
nodeInfo 複雜類型 包含工作執行所在的計算節點相關信息。
multiInstanceSettings 複雜類型 指定工作是需要多個計算節點的多實例工作。 如需詳細資訊,請參閱 multiInstanceSettings
constraints 複雜類型 套用至此工作的執行條件約束。
executionInfo 複雜類型 包含工作執行的相關信息。

nodeInfo

元素名稱 類型 註釋
poolId 繩子 工作執行所在的集區標識碼。
nodeId 繩子 工作執行所在的節點識別碼。

multiInstanceSettings

元素名稱 類型 註釋
numberOfInstances Int32 工作所需的計算節點數目。

限制式

元素名稱 類型 註釋
maxTaskRetryCount Int32 任務可重試的最大次數。 如果 Batch 服務結束代碼為非零,則會重試工作。

這個值會特別控制重試次數。 批次服務會嘗試一次任務,然後可能會重複嘗試到這個限制。 例如,如果最大重試次數是 3 次,批次會嘗試同一任務最多四次(一次初次嘗試,三次重試)。

如果重試計數上限為0,Batch服務就不會重試工作。

如果重試計數上限為 -1,Batch 服務會重試沒有限制的工作。

預設值為 0(沒有重試)。

executionInfo

元素名稱 類型 註釋
startTime 日期時間 工作開始執行的時間。 'Running' 會對應至 執行 中狀態,因此,如果工作指定資源檔或應用程式套件,則開始時間會反映工作開始下載或部署它們的時間。 如果工作重新啟動或重試,這是工作開始執行的最新時間。
endTime 日期時間 工作完成的時間。
exitCode Int32 工作的結束代碼。 如果任務在開始執行前失敗,則 exitCode 為空。
retryCount Int32 批次服務重試該任務的次數。 如果工作以非零結束代碼結束,則工作會重試,最多到指定的 MaxTaskRetryCount。
requeueCount Int32 批次服務因使用者請求而重新排隊該任務的次數。

當節點從池中移除(透過調整大小或縮小)或工作被停用時,你可以選擇重新排隊那些節點上的正在執行的任務。 這個計數會追蹤因這些原因而重新排隊任務的次數。
result 繩子 任務結果字串,可以是「成功」或「失敗」。
schedulingError 複雜類型 包含關於錯誤的詳細資訊。

排程錯誤

元素名稱 類型 註釋
category 繩子 錯誤類別,例如「UserError」。
code 繩子 錯誤代碼,例如「FailureExitCode」。
message 繩子 錯誤訊息。
details Array 錯誤詳細數據。