當工作因失敗而完成時,就會發出此事件。 目前所有非零結束代碼都會被視為失敗。 除了工作完成事件 之外 ,也會發出此事件,並可用來偵測工作失敗的時間。
下列範例顯示工作失敗事件的主體。
{
"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 | 錯誤詳細數據。 |