Dokumen ini menjelaskan cara melihat peristiwa status untuk tugas dan tugas Batch. Peristiwa status menyediakan histori yang dapat Anda gunakan untuk menganalisis tugas dan sering kali berisi pesan error berguna yang dapat Anda gunakan untuk pemecahan 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 tugas dan status 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 artikel Mengonfigurasi peristiwa status kustom.
Sebelum memulai
- Jika belum pernah menggunakan Batch, baca Mulai menggunakan Batch dan aktifkan Batch dengan menyelesaikan prasyarat untuk project dan pengguna.
-
Untuk mendapatkan izin yang Anda perlukan untuk 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.Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Lihat peristiwa status
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 melihat kolom statusEvents[]
yang sesuai.
Melihat peristiwa status lowongan
Konsol
Untuk melihat peristiwa status tugas di project saat ini menggunakan Konsol Google Cloud, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman Job list.
Di kolom Nama pekerjaan, klik nama pekerjaan.
Halaman Detail pekerjaan akan terbuka.
Tab Details terbuka secara default.
Klik tab Peristiwa.
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 pekerjaan yang ada.LOCATION
: lokasi tempat lowongan 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 lowongan berada.JOB_NAME
: nama pekerjaan yang ada.
Melihat peristiwa status tugas
Konsol
- Jika tugas hanya memiliki satu tugas, Anda dapat melihat peristiwa status tugas dengan menggunakan Konsol Google Cloud untuk melihat peristiwa status tugas.
- Jika tidak, jika tugas memiliki beberapa tugas, Anda tidak dapat menggunakan konsol Google Cloud untuk 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 ingin Anda lihat detailnya. Dalam grup tugas, indeks tugas dimulai dari 0 untuk tugas pertama dan meningkat 1 dengan setiap tugas tambahan. Misalnya, grup tugas yang berisi empat tugas memiliki indeks0
,1
,2
, dan3
.JOB_NAME
: nama pekerjaan yang ada.LOCATION
: lokasi tempat pekerjaan berada.TASK_GROUP_NAME
: nama grup tugas yang berisi tugas yang ingin Anda lihat detailnya. Nilai ini harus ditetapkan kegroup0
.
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 lowongan berada.JOB_NAME
: nama pekerjaan yang ada.TASK_GROUP_NAME
: nama grup tugas yang berisi tugas yang ingin Anda lihat detailnya. Nilai ini harus ditetapkan kegroup0
.TASK_INDEX
: indeks tugas yang ingin Anda lihat detailnya. Dalam grup tugas, indeks tugas dimulai dari 0 untuk tugas pertama dan meningkat 1 dengan setiap tugas tambahan. Misalnya, grup tugas yang berisi empat tugas memiliki indeks0
,1
,2
, dan3
.
Langkah selanjutnya
Untuk memahami peristiwa status dari Batch yang menjelaskan error, lihat Pemecahan masalah.
Jika Anda menginginkan histori yang lebih mendetail untuk tugas Anda, seperti peristiwa status saat runnable dimulai dan berakhir, konfigurasi peristiwa status kustom.
Pelajari cara menganalisis tugas menggunakan log.