本文說明如何查看 Batch 工作和工作的狀態事件。狀態事件會提供記錄,可用於分析作業,且通常包含實用的錯誤訊息,可用於疑難排解。
每個工作及其每個工作都有狀態事件,這些事件會在工作執行時由 Batch 自動建立。每個狀態事件都會說明狀態變化,以及達到該狀態的原因。如要瞭解工作和任務狀態,請參閱「工作生命週期」。您也可以選擇設定工作,加入自訂狀態事件,說明可執行檔的進度。如要進一步瞭解自訂狀態事件,請參閱「設定自訂狀態事件」。
事前準備
- 如果您從未使用過 Batch,請參閱「開始使用 Batch」,並完成專案和使用者的必要條件,啟用 Batch。
-
如要取得查看工作和工作所需的權限,請要求管理員授予您專案的 Batch 工作檢視者 (
roles/batch.jobsViewer
) 或 Batch 工作編輯者 (roles/batch.jobsEditor
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
查看狀態事件
工作層級 (工作的 statusEvents[]
欄位) 和工作層級 (每個工作的 statusEvents[]
欄位) 可能會顯示不同的狀態事件。
下列操作說明介紹如何使用Google Cloud 控制台、gcloud CLI 和 Batch API 查看狀態事件。如要使用用戶端程式庫語言,請按照步驟查看工作詳細資料或查看工作詳細資料,然後查看對應的 statusEvents[]
欄位。
查看工作的狀態事件
主控台
如要使用Google Cloud 控制台查看目前專案中工作的狀態事件,請按照下列步驟操作:
前往 Google Cloud 控制台的「Job list」(工作清單) 頁面。
在「Job name」(工作名稱) 欄中,按一下工作名稱。
「Job details」(工作詳細資料) 頁面隨即開啟。
系統預設會開啟「詳細資料」分頁。
按一下「事件」分頁標籤。
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
更改下列內容: