상태 이벤트를 통해 작업 기록 보기

이 문서에서는 Batch 작업 및 태스크의 상태 이벤트를 보는 방법을 설명합니다. 상태 이벤트는 작업을 분석하는 데 사용할 수 있는 기록을 제공하며 문제 해결에 사용할 수 있는 유용한 오류 메시지를 포함하는 경우가 많습니다.

각 작업 및 각 태스크에는 작업이 실행되는 동안 Batch에서 자동으로 생성되는 상태 이벤트가 있습니다. 이러한 각 상태 이벤트는 상태 변경사항을 설명하고 해당 상태에 도달한 이유에 대한 세부정보를 제공합니다. 작업 및 태스크 상태에 대한 자세한 내용은 작업 수명 주기를 참조하세요. 원하는 경우 실행 가능 항목의 진행 상황을 설명하는 커스텀 상태 이벤트를 갖도록 작업을 구성할 수도 있습니다. 커스텀 상태 이벤트에 대한 자세한 내용은 커스텀 상태 이벤트 구성을 참조하세요.

시작하기 전에

  1. Batch를 사용한 적이 없으면 Batch 시작하기를 검토하고 프로젝트 및 사용자 기본 요건을 완료하여 Batch를 사용 설정하세요.

  2. 작업 및 태스크를 보는 데 필요한 권한을 얻으려면 프로젝트에 대한 일괄 작업 뷰어(roles/batch.jobsViewer) 또는 일괄 작업 편집자(roles/batch.jobsEditor) IAM 역할을 부여해 달라고 관리자에게 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

    커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

상태 이벤트 보기

작업 수준(작업의 statusEvents[] 필드) 및 태스크 수준(각 태스크의 statusEvents[] 필드)에서 서로 다른 상태 이벤트가 나타날 수 있습니다.

다음 안내에서는 Google Cloud 콘솔, gcloud CLI, Batch API를 사용하여 상태 이벤트를 보는 방법을 설명합니다. 클라이언트 라이브러리 언어를 사용하려면 작업 세부정보 보기 또는 태스크 세부정보 보기 단계를 수행하고 해당하는 statusEvents[] 필드를 참조하세요.

작업 상태 이벤트 보기

콘솔

Google Cloud 콘솔을 사용하여 현재 프로젝트의 작업 상태 이벤트를 보려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 작업 목록 페이지로 이동합니다.

    작업 목록으로 이동

  2. 작업 이름 열에서 작업 이름을 클릭합니다.

    작업 세부정보 페이지가 열립니다.

    세부정보 탭이 기본적으로 열립니다.

  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씩 증가합니다. 예를 들어 태스크 4개가 포함된 태스크 그룹의 색인은 0, 1, 2, 3입니다.

  • 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씩 증가합니다. 예를 들어 태스크 4개가 포함된 태스크 그룹의 색인은 0, 1, 2, 3입니다.

다음 단계