透過狀態事件查看工作記錄

本文說明如何查看 Batch 工作和工作的狀態事件。狀態事件會提供記錄,可用於分析作業,且通常包含實用的錯誤訊息,可用於疑難排解。

每個工作及其每個工作都有狀態事件,這些事件會在工作執行時由 Batch 自動建立。每個狀態事件都會說明狀態變化,以及達到該狀態的原因。如要瞭解工作和任務狀態,請參閱「工作生命週期」。您也可以選擇設定工作,加入自訂狀態事件,說明可執行檔的進度。如要進一步瞭解自訂狀態事件,請參閱「設定自訂狀態事件」。

事前準備

  1. 如果您從未使用過 Batch,請參閱「開始使用 Batch」,並完成專案和使用者的必要條件,啟用 Batch。
  2. 如要取得查看工作和工作所需的權限,請要求管理員授予您專案的 Batch 工作檢視者 (roles/batch.jobsViewer) 或 Batch 工作編輯者 (roles/batch.jobsEditor) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。

    您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

查看狀態事件

工作層級 (工作的 statusEvents[] 欄位) 和工作層級 (每個工作的 statusEvents[] 欄位) 可能會顯示不同的狀態事件。

下列操作說明介紹如何使用Google Cloud 控制台、gcloud CLI 和 Batch API 查看狀態事件。如要使用用戶端程式庫語言,請按照步驟查看工作詳細資料查看工作詳細資料,然後查看對應的 statusEvents[] 欄位。

查看工作的狀態事件

主控台

如要使用Google Cloud 控制台查看目前專案中工作的狀態事件,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Job list」(工作清單) 頁面。

    前往工作清單

  2. 在「Job name」(工作名稱) 欄中,按一下工作名稱。

    「Job details」(工作詳細資料) 頁面隨即開啟。

    系統預設會開啟「詳細資料」分頁。

  3. 按一下「事件」分頁標籤。

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

更改下列內容:

  • PROJECT_ID:目前專案的專案 ID

  • LOCATION:職缺所在的地點

  • 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

更改下列內容:

  • TASK_INDEX:要查看詳細資料的工作索引。在工作群組中,第一個工作的索引從 0 開始,每新增一個工作,索引就會增加 1。舉例來說,如果工作群組包含四項工作,則索引為 0123

  • JOB_NAME:現有工作的名稱。

  • LOCATION:職缺所在的位置

  • TASK_GROUP_NAME:工作群組的名稱,其中包含您要查看詳細資料的工作。這個值必須設為 group0

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

更改下列內容:

  • PROJECT_ID:目前專案的專案 ID

  • LOCATION:職缺所在的地點

  • JOB_NAME:現有工作的名稱。

  • TASK_GROUP_NAME:工作群組的名稱,其中包含您要查看詳細資料的工作。這個值必須設為 group0

  • TASK_INDEX:要查看詳細資料的工作索引。在工作群組中,第一個工作的索引從 0 開始,每新增一個工作,索引就會增加 1。舉例來說,如果工作群組包含四項工作,則索引為 0123

後續步驟