Dokumen ini menjelaskan cara membuat dan menjalankan tugas Batch yang menginstal Ops Agent secara otomatis. Instal Agen Operasional untuk memberikan metrik tambahan di Cloud Monitoring tentang performa resource tugas. Untuk mempelajari lebih lanjut cara menggunakan metrik performa resource untuk tugas, lihat Memantau dan mengoptimalkan resource tugas dengan melihat metrik.
Sebelum memulai
- Jika belum pernah menggunakan Batch, baca Mulai menggunakan Batch dan aktifkan Batch dengan menyelesaikan prasyarat untuk project dan pengguna.
- Jika project Anda belum melakukannya, aktifkan Cloud Monitoring API dan Cloud Logging API:
-
Untuk mendapatkan izin yang Anda perlukan untuk membuat tugas, minta administrator Anda untuk memberi Anda peran IAM berikut:
-
Untuk membuat tugas:
-
Batch Job Editor (
roles/batch.jobsEditor
) di project -
Pengguna Akun Layanan (
roles/iam.serviceAccountUser
) di akun layanan tugas, yang secara default adalah akun layanan Compute Engine default
-
Batch Job Editor (
-
Untuk melihat log:
Logs Viewer (
roles/logging.viewer
) 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.
-
Untuk membuat tugas:
Kecuali jika Anda menggunakan konfigurasi default untuk akun layanan tugas, pastikan akun layanan tersebut memiliki izin yang diperlukan.
Untuk memastikan bahwa akun layanan tugas memiliki izin yang diperlukan untuk menulis metrik Agen Operasi ke Monitoring, minta administrator untuk memberi akun layanan tugas peran IAM berikut:
-
Monitoring Metric Writer (
roles/monitoring.metricWriter
) di project -
Logs Writer (
roles/logging.logWriter
) di project
-
Monitoring Metric Writer (
- Pastikan konfigurasi tugas yang Anda rencanakan memenuhi persyaratan Agen Operasional.
Persyaratan Agen Operasional
Untuk membuat dan menjalankan tugas yang menggunakan Agen Operasional, tugas Anda harus mematuhi semua persyaratan berikut:
Pastikan VM tugas menggunakan sistem operasi (OS) yang didukung oleh Agen Operasional. Untuk mengetahui informasi selengkapnya tentang image OS VM untuk tugas, lihat Ringkasan lingkungan OS untuk VM tugas.
Jika tugas Anda menggunakan konfigurasi jaringan non-default atau menggunakan Kontrol Layanan VPC, pastikan tugas memenuhi persyaratan akses untuk Ops Agent. Untuk mengetahui informasi selengkapnya, lihat VM tanpa akses paket jarak jauh dalam dokumentasi Google Cloud Observability.
Pastikan tugas tidak menginstal agen Cloud Logging atau agen Cloud Monitoring lama—misalnya, melalui image kustom atau template instance.
Untuk mengetahui informasi selengkapnya tentang fitur dan persyaratan Agen Operasi, lihat Ringkasan Agen Operasi dalam dokumentasi Google Cloud Observability.
Membuat tugas yang menginstal Agen Operasional secara otomatis
Gunakan Google Cloud CLI atau REST API untuk
membuat tugas yang
mencakup
kolom installOpsAgent
yang ditetapkan ke true
di kolom allocationPolicy.instances
di isi utama dalam
file JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Misalnya, tugas yang otomatis menginstal Agen Operasi dapat memiliki file konfigurasi JSON yang mirip dengan berikut:
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello World! This is task $BATCH_TASK_INDEX."
}
}
]
},
"taskCount": 3,
}
],
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Setelah VM tugas mulai berjalan, Anda dapat melihat metrik Ops Agent yang sama seperti metrik resource lainnya. Untuk mengetahui informasi selengkapnya, lihat Memantau dan mengoptimalkan resource tugas dengan melihat metrik.
Langkah berikutnya
- Jika Anda mengalami masalah saat membuat atau menjalankan tugas, lihat Pemecahan masalah.
- Melihat tugas.
- Pelajari lebih lanjut opsi pembuatan tugas.