Dokumen ini menjelaskan cara melihat tugas dan tugas Batch.
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 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 lowongan Anda
Untuk melihat tugas, pilih salah satu metode berikut:
Untuk melihat semua tugas dalam project Anda, lihat daftar tugas Anda.
Untuk melihat semua detail konfigurasi tugas tertentu, lihat detail tugas.
Melihat daftar lowongan Anda
Anda dapat melihat daftar tugas dalam project saat ini menggunakan konsol Google Cloud, gcloud CLI, Batch API, Go, Java, Node.js, Python, atau C++.
Konsol
Untuk melihat daftar tugas dalam project saat ini menggunakan konsol Google Cloud, buka halaman Daftar tugas.
Daftar tugas mungkin terdiri dari beberapa halaman. Jika Anda perlu melanjutkan ke halaman berikutnya, klik
Berikutnya di bagian bawah layar.Opsional: Jika Anda ingin memfilter daftar tugas, klik
Filter. Kemudian, ketik atau pilih properti dan nilai.Misalnya, untuk memfilter daftar agar hanya menyertakan tugas dalam status tertentu, masukkan kode berikut:
Status:JOB_STATE
Ganti
JOB_STATE
dengan status tugas—misalnya,FAILED
.
gcloud
Lihat semua tugas
Untuk melihat daftar tugas dalam project saat ini menggunakan gcloud CLI, gunakan perintah gcloud batch jobs list
.
gcloud batch jobs list
Melihat daftar tugas yang difilter
Secara opsional, Anda dapat menambahkan satu atau beberapa tanda untuk melihat daftar tugas yang difilter:
Untuk hanya melihat lowongan di lokasi tertentu, sertakan flag
--location
.Untuk hanya melihat tugas berdasarkan ekspresi filter, tentukan flag
--filter
.
Misalnya, gunakan perintah berikut:
gcloud batch jobs list \
--location=LOCATION \
--filter="FILTER_EXPRESSION"
Ganti kode berikut:
LOCATION
: lokasi tempat satu atau beberapa tugas berada.FILTER_EXPRESSION
: Ekspresi filter yang menentukan tugas yang ingin Anda cantumkan. Ekspresi filter harus menentukan satu atau beberapa pasangan nilai properti yang dipisahkan oleh nol atau beberapa operator boolean (AND
,OR
, danNOT
).Misalnya, lihat ekspresi filter berikut:
Filter berdasarkan status tugas: Untuk hanya melihat tugas yang berada dalam status tertentu, gunakan ekspresi filter berikut:
status.state="JOB_STATE"
Ganti
JOB_STATE
dengan status tugas—misalnya,FAILED
.Memfilter berdasarkan label: Misalnya, project Anda telah menentukan label kustom berikut:
Untuk menunjukkan tugas dan resource-nya yang dibuat oleh tim riset Anda saat Anda melihat laporan Penagihan Cloud, beberapa tugas dan resource-nya memiliki label
team
yang ditetapkan keresearch
.Untuk menunjukkan beban kerja yang sensitif terhadap waktu, beberapa tugas memiliki label
deadline
, yang ditetapkan ke berbagai nilai.Untuk menunjukkan runnable yang telah berhasil diuji oleh tim pengembangan Anda, beberapa runnable memiliki label
tested
yang disetel ketrue
.
Kemudian, Anda dapat menentukan ekspresi filter berikut:
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))
Ekspresi filter ini hanya mencantumkan tugas yang memenuhi semua kriteria berikut:
Tugas yang berasal dari tim riset, yang memiliki label
team
pada kebijakan alokasi tugas yang ditetapkan keresearch
.Pekerjaan yang memenuhi setidaknya salah satu kriteria berikut:
Tugas yang sensitif terhadap waktu, yang memiliki label
deadline
pada tugas yang ditetapkan ke nilai apa pun.Tugas yang memiliki setidaknya satu tugas yang dapat dijalankan yang telah berhasil diuji, yaitu tugas yang memiliki setidaknya satu tugas yang dapat dijalankan dengan label
tested
yang disetel ketrue
.
API
Lihat semua tugas
Untuk melihat daftar tugas dalam project saat ini untuk lokasi tertentu menggunakan
Batch API, buat permintaan GET
ke
metode jobs.list
.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs
Ganti kode berikut:
PROJECT_ID
: Project ID project Anda saat ini.LOCATION
: lokasi tempat tugas berada.
Melihat daftar tugas yang difilter
Secara opsional, Anda dapat menentukan parameter kueri filter
untuk melihat daftar
lowongan yang difilter berdasarkan ekspresi filter.
Misalnya, buat permintaan GET
berikut:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs?filter=FILTER_EXPRESSION
Ganti FILTER_EXPRESSION
dengan
ekspresi filter
yang menggunakan encoding URL.
Ekspresi filter harus menentukan satu atau beberapa pasangan nilai properti yang
dipisahkan oleh nol atau beberapa
operator boolean (AND
, OR
, dan NOT
).
Misalnya, lihat ekspresi filter berikut:
Filter berdasarkan status tugas: Untuk hanya melihat tugas yang berada dalam status tertentu, gunakan ekspresi filter berikut:
status.state="JOB_STATE"
Ganti
JOB_STATE
dengan status tugas—misalnya,FAILED
.Memfilter berdasarkan label: Misalnya, project Anda telah menentukan label kustom berikut:
Untuk menunjukkan tugas dan resource-nya yang dibuat oleh tim riset Anda saat Anda melihat laporan Penagihan Cloud, beberapa tugas dan resource-nya memiliki label
team
yang ditetapkan keresearch
.Untuk menunjukkan beban kerja yang sensitif terhadap waktu, beberapa tugas memiliki label
deadline
, yang ditetapkan ke berbagai nilai.Untuk menunjukkan runnable yang telah berhasil diuji oleh tim pengembangan Anda, beberapa runnable memiliki label
tested
yang disetel ketrue
.
Kemudian, Anda dapat menentukan ekspresi filter berikut:
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))
Ekspresi filter ini hanya mencantumkan tugas yang memenuhi semua kriteria berikut:
Tugas yang berasal dari tim riset, yang memiliki label
team
pada kebijakan alokasi tugas yang ditetapkan keresearch
.Pekerjaan yang memenuhi setidaknya salah satu kriteria berikut:
Tugas yang sensitif terhadap waktu, yang memiliki label
deadline
pada tugas yang ditetapkan ke nilai apa pun.Tugas yang memiliki setidaknya satu tugas yang dapat dijalankan yang telah berhasil diuji, yaitu tugas yang memiliki setidaknya satu tugas yang dapat dijalankan dengan label
tested
yang disetel ketrue
.
Go
Go
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Go API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Java
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Java API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Node.js API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Python
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Python API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C++
C++
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch C++ API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Melihat detail tugas
Anda dapat melihat detail tugas dalam project saat ini menggunakan Konsol Google Cloud, gcloud CLI, Batch API, Go, Java, Node.js, Python, atau C++.
Konsol
Untuk melihat detail tugas dalam project saat ini menggunakan konsol Google Cloud, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman Daftar tugas.
Di kolom Nama tugas, klik nama tugas.
Halaman Detail tugas akan terbuka.
Tab Details terbuka secara default. Untuk informasi selengkapnya, klik tab lainnya.
gcloud
Untuk melihat detail tugas dalam project saat ini menggunakan gcloud CLI, gunakan perintah gcloud batch jobs describe
dengan flag --location
.
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 detail tugas dalam project saat ini menggunakan
Batch API, buat permintaan GET
ke
metode jobs.get
.
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.
Go
Go
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Go API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Java
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Java API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Node.js API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Python
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Python API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C++
C++
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch C++ API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Lihat tugas
Untuk melihat tugas untuk salah satu tugas Anda, pilih salah satu metode berikut:
Untuk melihat semua tugas dalam tugas atau grup tugas tugas, lihat daftar tugas tugas.
Untuk melihat semua detail konfigurasi tugas tertentu, lihat detail tugas.
Melihat daftar tugas tugas
Anda dapat melihat daftar tugas dalam tugas atau grup tugas tugas menggunakan konsol Google Cloud, gcloud CLI, Batch API, Go, Java, Node.js, Python, atau C++.
Jika ingin memfilter daftar tugas dalam tugas atau grup tugas tugas—misalnya, hanya untuk mencantumkan tugas yang telah berhasil selesai berjalan—Anda harus menggunakan gcloud CLI atau Batch API.
Konsol
Untuk melihat ringkasan tugas tugas menggunakan konsol Google Cloud, lihat detail tugas untuk membuka halaman Detail tugas. Kemudian, lihat bagian Detail tugas.
gcloud
Untuk melihat daftar tugas dalam grup tugas tugas menggunakan gcloud CLI, gunakan perintah gcloud batch tasks list
dengan flag berikut:
gcloud batch tasks list \
--job=JOB_NAME \
--location=LOCATION
Ganti kode berikut:
JOB_NAME
: nama tugas yang ada.LOCATION
: lokasi tempat tugas berada.
Secara opsional, Anda dapat menambahkan flag --filter
untuk melihat daftar tugas yang difilter
dalam grup tugas tugas berdasarkan ekspresi filter.
Misalnya, gunakan perintah berikut:
gcloud batch tasks list \
--job=example-job \
--location=us-central1 \
--filter="FILTER_EXPRESSION"
Ganti FILTER_EXPRESSION
dengan
ekspresi filter.
Misalnya, Anda dapat menentukan ekspresi filter berikut untuk hanya melihat tugas dalam grup tugas tugas yang sedang berjalan atau telah berhasil selesai berjalan:
STATE=RUNNING OR STATE=SUCCEEDED
API
Untuk melihat daftar tugas dalam grup tugas tugas menggunakan
Batch API, buat permintaan GET
ke
metode tasks.list
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks
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 ingin Anda lihat detailnya. Nilai harus ditetapkan kegroup0
.
Secara opsional, Anda dapat menentukan parameter kueri filter
untuk melihat daftar tugas yang difilter dalam grup tugas tugas berdasarkan ekspresi filter.
Misalnya, buat permintaan GET
berikut:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs/example-job/taskGroups/group0/tasks?filter=FILTER_EXPRESSION
Ganti FILTER_EXPRESSION
dengan
ekspresi filter yang menggunakan
encoding URL.
Misalnya, Anda dapat menentukan ekspresi filter berikut untuk hanya melihat tugas dalam grup tugas tugas yang sedang berjalan atau telah berhasil selesai berjalan:
STATE=RUNNING%20OR%20STATE=SUCCEEDED
Perhatikan bahwa ekspresi filter yang dienkode ke URL mewakili ekspresi filter yang didekode berikut:
STATE=RUNNING OR STATE=SUCCEEDED
Go
Go
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Go API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Java
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Java API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Node.js API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Python
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Python API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C++
C++
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch C++ API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Melihat detail tugas
Anda dapat melihat detail tugas menggunakan konsol Google Cloud, gcloud CLI, Batch API, Go, Java, Node.js, Python, atau C++.
Konsol
Untuk melihat detail tugas menggunakan konsol Google Cloud, lihat detail tugas untuk membuka halaman Detail tugas. Kemudian, lihat bagian Detail tugas.
gcloud
Untuk melihat detail tugas menggunakan gcloud CLI, gunakan perintah gcloud batch tasks describe
dengan flag berikut:
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 indeks0
,1
,2
, dan3
.TASK_GROUP_NAME
: nama grup tugas yang berisi tugas yang ingin Anda lihat detailnya. Nilai harus ditetapkan kegroup0
.JOB_NAME
: nama tugas yang ada.LOCATION
: lokasi tempat tugas berada.
API
Untuk melihat detail tugas menggunakan Batch API, buat
permintaan GET
ke
metode tasks.get
:
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 kegroup0
.TASK_INDEX
: indeks tugas yang ingin Anda lihat detailnya. 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 indeks0
,1
,2
, dan3
.
Go
Go
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Go API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Java
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Java API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Node.js API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Python
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch Python API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C++
C++
Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Batch C++ API.
Untuk melakukan autentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Langkah selanjutnya
Pelajari cara memecahkan masalah.
Pelajari cara memantau dan menganalisis tugas:
Jika mengonfigurasi log untuk tugas, Anda dapat menganalisis tugas menggunakan log.
Jika telah mengonfigurasi notifikasi status, Anda dapat memantau tugas menggunakan notifikasi Pub/Sub dan menganalisis notifikasi menggunakan BigQuery.
Pelajari cara mengelola tugas: