Mengumpulkan metrik resource tambahan menggunakan Agen Operasional

Dokumen ini menjelaskan cara membuat dan menjalankan tugas Batch yang secara otomatis menginstal Agen Operasional. Instal Agen Operasional untuk menyediakan 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.

Catatan: Fitur Agen Operasional bukan bagian dari Batch dan memiliki harga tersendiri. Untuk mengetahui informasi selengkapnya, lihat Harga Agen Operasional di dokumentasi Google Cloud Observability.

Sebelum memulai

1. Jika belum pernah menggunakan Batch, baca Mulai menggunakan Batch dan aktifkan Batch dengan menyelesaikan prasyarat untuk project dan pengguna.
2. Jika belum, aktifkan Cloud Monitoring dan Cloud Logging API untuk project Anda:

   Peran yang diperlukan untuk mengaktifkan API

   Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

   Aktifkan API

3. Untuk mendapatkan izin yang diperlukan untuk membuat tugas, minta administrator 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
   • Untuk melihat log: Logs Viewer (roles/logging.viewer) di project

   Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

4. Kecuali jika Anda menggunakan konfigurasi default untuk akun layanan tugas, pastikan akun tersebut memiliki izin yang diperlukan.

   Untuk memastikan bahwa akun layanan tugas memiliki izin yang diperlukan untuk menulis metrik Agen Operasional ke Monitoring, minta administrator untuk memberikan peran IAM berikut ke akun layanan tugas:

   Penting: Anda harus memberikan peran ini ke akun layanan tugas, bukan ke akun pengguna Anda. Kegagalan memberikan peran ke principal yang benar dapat menyebabkan error izin.
   • Monitoring Metric Writer (roles/monitoring.metricWriter) di project
   • Logs Writer (roles/logging.logWriter) di project

5. Pastikan konfigurasi tugas yang direncanakan 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 tersebut memenuhi persyaratan akses untuk Agen Operasional. Untuk mengetahui informasi selengkapnya, lihat VM tanpa akses paket jarak jauh di dokumentasi Google Cloud Observability.

• Pastikan tugas tidak menginstal agen Cloud Logging lama atau agen Cloud Monitoring—misalnya, melalui image kustom atau template instance.

Untuk mengetahui informasi selengkapnya tentang fitur dan persyaratan Agen Operasional, lihat Ringkasan Agen Operasional di dokumentasi Google Cloud Observability.

Membuat tugas yang secara otomatis menginstal Agen Operasional

Gunakan Google Cloud CLI atau REST API untuk membuat tugas yang menyertakan kolom installOpsAgent yang ditetapkan ke true di kolom allocationPolicy.instances di isi utama dalam file JSON:

"allocationPolicy": {
  "instances": [
    {
      "installOpsAgent": true
    }
  ]
}

Misalnya, tugas yang secara otomatis menginstal Agen Operasional dapat memiliki file konfigurasi JSON yang mirip dengan berikut ini:

{
  "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 Agen Operasional 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.
• Lihat tugas.
• Pelajari opsi pembuatan tugas lainnya .