Melihat histori tugas melalui peristiwa status

Dokumen ini menjelaskan cara melihat peristiwa status untuk tugas dan tugas Batch. Peristiwa status memberikan histori yang dapat Anda gunakan untuk menganalisis tugas dan sering kali berisi pesan error yang 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 tugas, lihat Siklus proses tugas. Secara opsional, Anda juga dapat mengonfigurasi tugas agar memiliki peristiwa status kustom, yang menjelaskan progres runnable. Untuk mempelajari peristiwa status kustom lebih lanjut, 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 guna melihat tugas dan tugas, minta administrator untuk memberi Anda peran IAM Batch Job Viewer (roles/batch.jobsViewer) atau Batch Job Editor (roles/batch.jobsEditor) pada 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 Konsol Google Cloud, 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 dalam project saat ini menggunakan konsol Google Cloud, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman Daftar tugas.

    Buka Daftar tugas

  2. Di kolom Nama tugas, klik nama tugas.

    Halaman Detail tugas akan terbuka.

    Tab Details 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 dari 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 dengan 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 ingin Anda lihat detailnya. 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 dari project saat ini.

  • LOCATION: lokasi tempat tugas berada.

  • JOB_NAME: nama tugas yang ada.

  • TASK_GROUP_NAME: nama grup tugas yang berisi tugas yang ingin Anda lihat detailnya. 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 dengan setiap tugas tambahan. Misalnya, grup tugas yang berisi empat tugas memiliki indeks 0, 1, 2, dan 3.

Langkah selanjutnya