Mengonfigurasi pengumpulan metrik kondisi agen

Panduan ini menunjukkan cara mengonfigurasi Agen Google Cloud untuk SAP guna mengumpulkan metrik status dari proses daemon agen di instance Compute Engine atau server Solusi Bare Metal.

Untuk informasi tentang fitur ini, lihat Pengumpulan metrik kondisi agen.

Sebelum memulai

Menetapkan peran IAM

Agar Agen Google Cloud untuk SAP dapat mengumpulkan metrik kesehatan, Anda harus memastikan bahwa akun layanan yang digunakan oleh instance Compute Engine atau server Solusi Bare Metal menyertakan peran berikut:

Untuk menambahkan peran yang diperlukan ini ke akun layanan Anda, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman IAM.

    Buka IAM

  2. Pilih project Google Cloud Anda.

  3. Identifikasi akun layanan tempat Anda ingin menambahkan peran.

    • Jika akun layanan belum ada dalam daftar akun utama, akun layanan tidak memiliki peran yang ditetapkan pada akun tersebut. Klik Berikan Akses, lalu masukkan alamat email akun layanan.
    • Jika akun layanan sudah ada di daftar utama, berarti akun tersebut sudah memiliki peran. Klik tombol Edit untuk akun layanan yang ingin diedit.

  4. Pilih peran yang diperlukan dari daftar peran yang tersedia:

    • Compute Engine > Viewer Compute
    • Monitoring > Monitoring Metric Writer

  5. Klik Simpan untuk menerapkan peran ke akun layanan.

Mengaktifkan pengumpulan metrik kesehatan agen

Agar Agen Google Cloud untuk SAP dapat mengumpulkan metrik status untuk proses daemonnya di host Anda, ikuti langkah-langkah berikut:

  1. Buat koneksi SSH dengan instance Compute Engine host atau server Solusi Bare Metal.

  2. Aktifkan pengumpulan metrik kesehatan agen:

    Perintah jalankan

    1. Untuk mengaktifkan pengumpulan metrik kesehatan agen, jalankan perintah berikut:

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable

    2. Secara opsional, Anda dapat mengubah frekuensi saat agen mengumpulkan penggunaan CPU dan memori dari proses daemon-nya, lalu mengirimkannya ke Cloud Monitoring. Frekuensi default-nya adalah 60 detik.

      Untuk mengubah frekuensi ini, jalankan perintah berikut:

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY

      Ganti FREQUENCY dengan nilai yang diperlukan, dalam detik. Frekuensi tidak boleh kurang dari 5 detik.

    3. Secara opsional, Anda dapat mengubah frekuensi agen memeriksa kondisi operasionalnya dan mengirimkan informasi tersebut ke Cloud Monitoring. Frekuensi default-nya adalah 60 detik.

      Untuk mengubah frekuensi ini, jalankan perintah berikut. Frekuensinya tidak boleh kurang dari 5 detik.

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY

    Mengedit file konfigurasi

    Sebagai alternatif untuk menjalankan perintah agen, Anda dapat mengubah konfigurasi agen secara manual sebagai berikut:

    1. Buka file konfigurasi Backint:

      /etc/google-cloud-sap-agent/configuration.json

    2. Di bagian collection_configuration, sertakan hal berikut:

      "collect_agent_metrics": true

    3. Secara opsional, Anda dapat mengubah frekuensi saat agen mengumpulkan penggunaan CPU dan memori dari proses daemon-nya, lalu mengirimkannya ke Cloud Monitoring. Frekuensi default-nya adalah 60 detik.

      Untuk mengubah frekuensi ini, sertakan hal berikut di bagian collection_configuration.

      "agent_metrics_frequency": FREQUENCY

      Ganti FREQUENCY dengan nilai yang diperlukan, dalam detik. Frekuensi tidak boleh kurang dari 5 detik.

    4. Secara opsional, Anda dapat mengubah frekuensi agen memeriksa kondisi operasionalnya dan mengirimkan informasi tersebut ke Cloud Monitoring. Frekuensi default-nya adalah 60 detik.

      Untuk mengubah frekuensi ini, sertakan hal berikut di bagian collection_configuration. Frekuensi tidak boleh kurang dari 5 detik.

      "agent_health_frequency": FREQUENCY

    5. Simpan file konfigurasi.

    6. Mulai ulang agen agar setelan baru diterapkan:

      sudo systemctl restart google-cloud-sap-agent

Contoh file konfigurasi

Instance Compute Engine

Contoh berikut adalah file konfigurasi lengkap dari Agen Google Cloud untuk SAP yang berjalan di instance Compute Engine, tempat pengumpulan metrik kesehatan agen diaktifkan:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Solusi Bare Metal

Contoh berikut adalah file konfigurasi lengkap dari Agen Google Cloud untuk SAP yang berjalan di server Solusi Bare Metal, tempat pengumpulan metrik kesehatan agen diaktifkan:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agen Google Cloud untuk SAP yang khusus untuk pengumpulan metrik kesehatan agen:

Parameter
collection_configuration.collect_agent_metrics

Boolean

Opsional. Tentukan true agar agen dapat mengumpulkan informasi berikut dan mengirimkannya ke Cloud Monitoring:

  • Penggunaan CPU dan memori oleh proses daemon agen di host Anda.
  • Kondisi operasional proses daemon agen di host Anda.

Nilai defaultnya adalah false.
collection_configuration.agent_metrics_frequency

Int

Opsional. Tentukan frekuensi agen mengumpulkan penggunaan CPU dan memori dari proses daemon-nya di host dan mengirimkannya ke Cloud Monitoring. Informasi ini diambil oleh metrik sap/agent/cpu/utilization dan sap/agent/memory/utilization. Nilai default-nya adalah 60 detik. Frekuensi tidak boleh kurang dari 5 detik.

collection_configuration.agent_health_frequency

Int

Opsional. Tentukan frekuensi agen memeriksa kondisi operasionalnya dan mengirimkan informasi tersebut ke Cloud Monitoring. Informasi ini diambil oleh metrik sap/agent/health. Nilai default-nya adalah 60 detik. Frekuensi tidak boleh kurang dari 5 detik.