Mengumpulkan metrik resource tambahan menggunakan Agen Operasional

Dokumen ini menjelaskan cara membuat dan menjalankan tugas Batch yang otomatis menginstal Ops Agent. Instal Agen Operasional untuk memberikan metrik tambahan di Cloud Monitoring tentang performa tugas Google Cloud Platform. Untuk mempelajari lebih lanjut tentang cara menggunakan metrik kinerja sumber daya untuk pekerjaan, lihat Pantau dan optimalkan resource tugas dengan melihat metrik.

Catatan: Fitur Ops Agent bukan bagian dari Batch dan memiliki harganya sendiri. Untuk informasi selengkapnya, lihat Harga Agen Operasional dalam 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 project Anda belum melakukannya, aktifkan Cloud Monitoring dan Cloud Logging API:

   Mengaktifkan API

3. Untuk mendapatkan izin yang diperlukan untuk membuat tugas, minta administrator untuk memberi Anda peran IAM berikut:

   • Untuk membuat tugas:
     • Editor Tugas Batch (roles/batch.jobsEditor) pada proyek
     • Service Account User (roles/iam.serviceAccountUser) di akun layanan tugas, yang secara default merupakan akun layanan Compute Engine default
   • Untuk melihat log: Logs Viewer (roles/logging.viewer) pada proyek

   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 perintah peran atau setelan standar lainnya peran tertentu.

4. Kecuali Anda menggunakan konfigurasi {i>default<i} untuk akun layanan tugas, memastikan bahwa kode itu memiliki izin yang diperlukan.

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

   • Monitoring Metric Writer (roles/monitoring.metricWriter) pada proyek
   • Logs Writer (roles/logging.logWriter) di project

5. 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 bahwa VM tugas menggunakan sistem operasi (OS) yang didukung Agen Operasional. Untuk mengetahui informasi selengkapnya tentang VM OS image 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 Ops Agent. Untuk informasi selengkapnya, lihat VM tanpa akses paket jarak jauh dalam dokumentasi Google Cloud Observability.

• Pastikan tugas tersebut 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 Ops Agent, lihat Ringkasan Ops Agent dalam dokumentasi Google Cloud Observability.

Membuat tugas yang otomatis menginstal Agen Operasional

Gunakan Google Cloud CLI atau REST API untuk membuat tugas yang mencakup Kolom installOpsAgent ditetapkan ke true di kolom allocationPolicy.instances di bagian utama dalam File JSON:

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

Misalnya, tugas yang otomatis menginstal Agen Operasional dapat memiliki yang mirip dengan yang 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 Ops yang sama dengan metrik resource lainnya. Untuk informasi selengkapnya, lihat Pantau dan optimalkan sumber daya tugas dengan melihat metrik.

Langkah selanjutnya

• Jika Anda mengalami masalah saat membuat atau menjalankan tugas, lihat Pemecahan masalah.
• Melihat pekerjaan dan tugas.
• Pelajari lebih lanjut opsi pembuatan tugas.