Mengumpulkan metrik resource tambahan menggunakan Agen Operasional

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

Catatan: Fitur Agen Operasional bukan bagian dari Batch dan memiliki harganya sendiri. Untuk mengetahui informasi selengkapnya, lihat harga Agen Operasional dalam dokumentasi Kemampuan Observasi Google Cloud.

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 dan Cloud Logging API:

  Enable the APIs

• 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) pada project
    • 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 project

  Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

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

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

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

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

• 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 Agen Operasional. Untuk mengetahui informasi selengkapnya tentang OS image 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 dalam dokumentasi Kemampuan Observasi Google Cloud.

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

Untuk mengetahui informasi selengkapnya tentang fitur dan persyaratan Agen Operasional, lihat Ringkasan Agen Operasional dalam dokumentasi Kemampuan Observasi Google Cloud.

Membuat tugas yang otomatis menginstal Agen Operasional

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

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

Misalnya, tugas yang otomatis menginstal Agen Operasional dapat memiliki file konfigurasi JSON yang mirip dengan contoh 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 Agen Operasional yang sama dengan metrik resource lainnya. Untuk informasi selengkapnya, lihat Memantau dan mengoptimalkan resource tugas dengan melihat metrik.

Langkah selanjutnya

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