本文档介绍了如何查看批量作业和任务的状态事件。状态事件提供了可用于分析作业的历史记录,通常包含可用于问题排查的实用错误消息。
每个作业及其每个任务都有状态事件,这些状态事件会在作业运行时由 Batch 自动创建。每个状态事件都描述了状态更改以及达到该状态的原因。如需了解作业和任务状态,请参阅作业生命周期。或者,您也可以将作业配置为包含自定义状态事件,用于描述可运行资源的进度。如需详细了解自定义状态事件,请参阅配置自定义状态事件。
准备工作
- 如果您之前未使用过 Batch,请查看 Batch 使用入门,并通过完成项目和用户的前提条件来启用 Batch。
-
如需获取查看作业和任务所需的权限,请让管理员为您授予项目的 Batch Job Viewer (
roles/batch.jobsViewer
) 或 Batch Job Editor (roles/batch.jobsEditor
) IAM 角色。如需详细了解如何授予角色,请参阅管理访问权限。
查看状态事件
作业级别(作业的 statusEvents[]
字段)和任务级别(每个任务的 statusEvents[]
字段)可能会显示不同的状态事件。
以下说明介绍了如何使用 Google Cloud 控制台、gcloud CLI 和 Batch API 查看状态事件。如需使用客户端库语言,请按照相应步骤查看作业详情或查看任务详情,然后查看相应的 statusEvents[]
字段。
查看作业的状态事件
控制台
如需使用 Google Cloud 控制台查看当前项目中作业的状态事件,请按以下步骤操作:
在 Google Cloud 控制台中,前往作业列表页面。
在作业名称列中,点击作业的名称。
作业详情页面随即打开。
默认情况下,详细信息标签页处于打开状态。
点击事件标签页。
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
请替换以下内容: