Melihat histori tugas melalui peristiwa status

Dokumen ini menjelaskan cara melihat peristiwa status untuk tugas dan pekerjaan Batch. Peristiwa status memberikan histori yang dapat Anda gunakan untuk menganalisis pekerjaan dan sering kali berisi pesan error berguna yang dapat Anda gunakan untuk memecahkan masalah.

Setiap tugas dan setiap tugasnya memiliki peristiwa status yang otomatis dibuat oleh Batch saat tugas berjalan. Setiap peristiwa status ini menjelaskan perubahan status dan detail tentang alasan status tersebut tercapai. Untuk mempelajari status tugas dan pekerjaan, lihat Siklus proses tugas. Secara opsional, Anda juga dapat mengonfigurasi tugas agar memiliki peristiwa status kustom, yang menggambarkan progres runnable. Untuk mempelajari lebih lanjut peristiwa status kustom, lihat Mengonfigurasi peristiwa status kustom.

Sebelum memulai

  1. Jika belum pernah menggunakan Batch, baca Mulai menggunakan Batch dan aktifkan Batch dengan menyelesaikan prasyarat untuk project dan pengguna.

  2. Untuk mendapatkan izin yang diperlukan untuk melihat tugas dan pekerjaan, minta administrator untuk memberi Anda peran IAM Batch Job Viewer (roles/batch.jobsViewer) atau Batch Job Editor (roles/batch.jobsEditor) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

    Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Melihat peristiwa status

Peristiwa status yang berbeda mungkin muncul di tingkat tugas (kolom statusEvents[] untuk tugas) dan tingkat tugas (kolom statusEvents[] untuk setiap tugas).

Petunjuk berikut menjelaskan cara melihat peristiwa status menggunakan Google Cloud konsol, gcloud CLI, dan Batch API. Untuk menggunakan bahasa library klien, ikuti langkah-langkah untuk melihat detail tugas atau melihat detail tugas lalu lihat kolom statusEvents[] yang sesuai.

Melihat peristiwa status tugas

Konsol

Untuk melihat peristiwa status tugas di project saat ini menggunakan konsolGoogle Cloud , ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Job list.

    Buka Daftar tugas

  2. Di kolom Nama tugas, klik nama tugas.

    Halaman Job details akan terbuka.

    Tab Detail terbuka secara default.

  3. Klik tab Events.

gcloud

Untuk melihat peristiwa status tugas menggunakan gcloud CLI, gunakan perintah gcloud batch jobs describe, lalu lihat kolom statusEvents[].

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

Ganti kode berikut:

  • JOB_NAME: nama tugas yang ada.

  • LOCATION: lokasi tempat tugas berada.

API

Untuk melihat peristiwa status tugas menggunakan Batch API, buat permintaan GET ke metode jobs.get, lalu lihat kolom statusEvents[].

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME

Ganti kode berikut:

  • PROJECT_ID: project ID project saat ini.

  • LOCATION: lokasi tempat tugas berada.

  • JOB_NAME: nama tugas yang ada.

Melihat peristiwa status tugas

gcloud

Untuk melihat peristiwa status tugas menggunakan gcloud CLI, gunakan perintah gcloud batch tasks describe, lalu lihat kolom statusEvents[].

gcloud batch tasks describe TASK_INDEX \
  --location=LOCATION \
  --job=JOB_NAME \
  --task_group=TASK_GROUP_NAME

Ganti kode berikut:

  • TASK_INDEX: indeks tugas yang detailnya ingin Anda lihat. Dalam grup tugas, indeks tugas dimulai dari 0 untuk tugas pertama dan bertambah 1 untuk setiap tugas tambahan. Misalnya, grup tugas yang berisi empat tugas memiliki indeks 0, 1, 2, dan 3.

  • JOB_NAME: nama tugas yang ada.

  • LOCATION: lokasi tempat tugas berada.

  • TASK_GROUP_NAME: nama grup tugas yang berisi tugas yang detailnya ingin Anda lihat. Nilai harus ditetapkan ke group0.

API

Untuk melihat peristiwa status tugas menggunakan Batch API, buat permintaan GET ke metode tasks.get, lalu lihat kolom statusEvents[].

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX

Ganti kode berikut:

  • PROJECT_ID: project ID project saat ini.

  • LOCATION: lokasi tempat tugas berada.

  • JOB_NAME: nama tugas yang ada.

  • TASK_GROUP_NAME: nama grup tugas yang berisi tugas yang detailnya ingin Anda lihat. Nilai harus ditetapkan ke group0.

  • TASK_INDEX: indeks tugas yang detailnya ingin Anda lihat. Dalam grup tugas, indeks tugas dimulai dari 0 untuk tugas pertama dan bertambah 1 untuk setiap tugas tambahan. Misalnya, grup tugas yang berisi empat tugas memiliki indeks 0, 1, 2, dan 3.

Langkah berikutnya