Mengonfigurasi pengumpulan metrik kesehatan agen

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

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

Sebelum memulai

Validasi penginstalan Agen Google Cloud untuk SAP. Untuk mengetahui petunjuknya, lihat panduan penginstalan untuk skenario Anda.
Jika Anda telah menginstal agen di server Solusi Bare Metal, pastikan Anda telah menyelesaikan prasyarat yang diperlukan dan menyiapkan akun layanan. Untuk mengetahui petunjuknya, lihat Mengonfigurasi Agen Google Cloud untuk SAP di Linux.

Menetapkan peran IAM

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

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

Di konsol Google Cloud, buka halaman IAM.

Buka IAM
Pilih project Google Cloud Anda.
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 dan 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.
Pilih peran yang diperlukan dari daftar peran yang tersedia:
- Compute Engine > Viewer Compute
- Monitoring > Monitoring Metric Writer
Klik Simpan untuk menerapkan peran ke akun layanan.

Aktifkan pengumpulan metrik kesehatan agen

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

Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Aktifkan pengumpulan metrik kondisi agen:
Perintah jalankan
1. Untuk mengaktifkan pengumpulan metrik kondisi agen, jalankan perintah berikut:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable
```
2. Jika ingin, Anda dapat mengubah frekuensi saat agen mengumpulkan penggunaan CPU dan memori dari proses daemonnya dan mengirimkannya ke Cloud Monitoring. Frekuensi default 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. Frekuensinya tidak boleh kurang dari 5 detik.
3. Jika ingin, Anda dapat mengubah frekuensi agen memeriksa kondisi operasionalnya dan mengirim informasi tersebut ke Cloud Monitoring. Frekuensi default 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
```
Edit 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. Jika ingin, Anda dapat mengubah frekuensi saat agen mengumpulkan penggunaan CPU dan memori dari proses daemonnya dan mengirimkannya ke Cloud Monitoring. Frekuensi default 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. Frekuensinya tidak boleh kurang dari 5 detik.
4. Jika ingin, Anda dapat mengubah frekuensi agen memeriksa kondisi operasionalnya dan mengirim informasi tersebut ke Cloud Monitoring. Frekuensi default adalah 60 detik.
  
  Untuk mengubah frekuensi ini, sertakan hal berikut di bagian collection_configuration. Frekuensinya 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 VM Compute Engine

Contoh berikut adalah file konfigurasi lengkap dari Agen untuk SAP Google Cloud yang berjalan di instance VM Compute Engine, tempat pengumpulan metrik kondisi 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": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Server Solusi Bare Metal

Contoh berikut adalah file konfigurasi lengkap dari Agen untuk SAP Google Cloud yang berjalan di server Solusi Bare Metal, tempat pengumpulan metrik kondisi 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
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agen untuk SAP Google Cloud yang spesifik untuk kumpulan metrik kesehatan agen:

Parameter

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 {i>daemon<i} agen di {i>host<i} Anda. Kondisi operasional proses daemon agen di host Anda. Nilai defaultnya adalah `false`.
`collection_configuration.agent_metrics_frequency`	`Int` Opsional. Tentukan frekuensi saat agen mengumpulkan penggunaan CPU dan memori dari proses daemonnya pada host dan mengirimkannya ke Cloud Monitoring. Informasi ini diambil oleh metrik `sap/agent/cpu/utilization` dan `sap/agent/memory/utilization`. Nilai defaultnya adalah `60` detik. Frekuensinya tidak boleh kurang dari 5 detik.
`collection_configuration.agent_health_frequency`	`Int` Opsional. Tentukan frekuensi agen memeriksa kondisi operasionalnya dan mengirim informasi tersebut ke Cloud Monitoring. Informasi ini diambil oleh metrik `sap/agent/health`. Nilai defaultnya adalah `60` detik. Frekuensinya tidak boleh kurang dari 5 detik.

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 {i>daemon<i} agen di {i>host<i} Anda.
Kondisi operasional proses daemon agen di host Anda.

Nilai defaultnya adalah false.

collection_configuration.agent_metrics_frequency

Int

Opsional. Tentukan frekuensi saat agen mengumpulkan penggunaan CPU dan memori dari proses daemonnya pada host dan mengirimkannya ke Cloud Monitoring. Informasi ini diambil oleh metrik sap/agent/cpu/utilization dan sap/agent/memory/utilization. Nilai defaultnya adalah 60 detik. Frekuensinya tidak boleh kurang dari 5 detik.

collection_configuration.agent_health_frequency