이 문서에서는 Batch 작업 및 태스크의 상태 이벤트를 보는 방법을 설명합니다. 상태 이벤트는 작업을 분석하는 데 사용할 수 있는 기록을 제공하며 문제 해결에 사용할 수 있는 유용한 오류 메시지를 포함하는 경우가 많습니다.
각 작업 및 각 태스크에는 작업이 실행되는 동안 Batch에서 자동으로 생성되는 상태 이벤트가 있습니다. 이러한 각 상태 이벤트는 상태 변경사항을 설명하고 해당 상태에 도달한 이유에 대한 세부정보를 제공합니다. 작업 및 태스크 상태에 대한 자세한 내용은 작업 수명 주기를 참조하세요. 원하는 경우 실행 가능 항목의 진행 상황을 설명하는 커스텀 상태 이벤트를 갖도록 작업을 구성할 수도 있습니다. 커스텀 상태 이벤트에 대한 자세한 내용은 커스텀 상태 이벤트 구성을 참조하세요.
시작하기 전에
- Batch를 사용한 적이 없으면 Batch 시작하기를 검토하고 프로젝트 및 사용자 기본 요건을 완료하여 Batch를 사용 설정하세요.
-
작업 및 태스크를 보는 데 필요한 권한을 얻으려면 프로젝트에 대한 일괄 작업 뷰어(
roles/batch.jobsViewer
) 또는 일괄 작업 편집자(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
다음을 바꿉니다.
다음 단계
오류를 설명하는 Batch의 상태 이벤트를 이해하려면 문제 해결을 참조하세요.
실행 가능 항목이 시작 및 종료될 때의 상태 이벤트와 같이 작업에 대한 자세한 기록이 필요하면 커스텀 상태 이벤트를 구성합니다.
로그를 이용한 작업 분석 방법 알아보기