Perintah konfigurasi untuk Agen Google Cloud untuk SAP

Dokumen ini menunjukkan perintah yang dapat digunakan untuk mengubah konfigurasi Agent for SAP Google Cloud. Perintah ini didukung mulai dari agen versi 3.2.

Perintah konfigurasi adalah alternatif untuk mengedit file konfigurasi agen: /etc/google-cloud-sap-agent/configuration.json. Setiap perintah konfigurasi juga akan memulai ulang agen untuk memastikan perubahan diterapkan.

Batas mulai ulang agen

Anda dapat memulai ulang Agen Google Cloud untuk SAP hingga 3 kali dalam 60 detik. Selama jangka waktu ini, meskipun Anda dapat terus mengonfigurasi agen dengan menjalankan perintah konfigurasi, semua operasi mulai ulang otomatis yang melebihi batas ini akan gagal dengan output: Could not restart the agent.

Jika melihat output ini, setelah menjalankan semua perintah konfigurasi yang diperlukan, Anda perlu memulai ulang agen secara manual agar perubahan diterapkan. Untuk mengetahui petunjuknya, lihat Memulai ulang agen.

Perintah bantuan

Untuk mencetak bantuan ringkasan untuk perintah google_cloud_sap_agent configure pada agen, lalu keluar:
```
sudo /usr/bin/google_cloud_sap_agent configure -help
```

Untuk mencetak status fitur instance agen Anda:

sudo /usr/bin/google_cloud_sap_agent configure -showall

Untuk mencetak versi instance agen Anda:

sudo /usr/bin/google_cloud_sap_agent configure -version

Untuk mengetahui informasi tentang argumen yang didukung oleh perintah google_cloud_sap_agent configure, lihat Argumen yang didukung.

Untuk setelan tingkat atas

Guna mengonfigurasi agen untuk server Solusi Bare Metal:

sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -enable

Untuk mengonfigurasi agen untuk instance VM Compute Engine:

sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -disable

Untuk menetapkan level logging agen:
```
sudo /usr/bin/google_cloud_sap_agent configure -loglevel=LOG_LEVEL
```
Ganti LOG_LEVEL dengan salah satu level log yang didukung: debug, info, warn, atau error.

Agar agen dapat menemukan sistem SAP yang berjalan di host Anda:

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

Untuk tidak mengizinkan agen menemukan sistem SAP Anda:

sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -disable

Untuk kumpulan metrik Agen Host SAP

Untuk mengizinkan agen mengumpulkan metrik Agen Host SAP:

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

Untuk menghentikan pengumpulan metrik Agen Host SAP:

sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -disable

Untuk kumpulan metrik kesehatan Agen

Untuk mengaktifkan pengumpulan metrik kondisi agen:

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

Untuk menonaktifkan pengumpulan metrik kondisi agen:

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

Untuk mengubah frekuensi saat agen mengumpulkan penggunaan CPU dan memori dari proses daemon-nya dan mengirimkannya ke Cloud Monitoring:
```
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.
Untuk mengubah frekuensi agen memeriksa kondisi operasionalnya dan mengirim informasi tersebut ke Cloud Monitoring:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```

Untuk pengumpulan metrik Pemantauan proses

Untuk mengizinkan agen mengumpulkan metrik Pemantauan Proses:

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

Untuk menghentikan pengumpulan metrik Pemantauan Proses:

sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -disable

Untuk mengubah frekuensi agen harus mengumpulkan metrik Pemantauan Proses yang berubah dengan cepat:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY
```
Untuk mengubah frekuensi agen harus mengumpulkan metrik Process Monitoring yang berubah lambat:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -slow_process_metrics_frequency=FREQUENCY
```
Ganti FREQUENCY dengan frekuensi, dalam detik, saat agen harus mengumpulkan metrik.
Untuk menghentikan pengumpulan metrik Pemantauan Proses:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add
```
Untuk melanjutkan pengumpulan metrik Pemantauan Proses yang Anda hentikan agennya:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -remove
```
Ganti LIST_OF_METRICS dengan nama metrik Pemantauan Proses yang Anda inginkan untuk dilanjutkan pengumpulannya oleh agen. Gunakan koma untuk memisahkan nama metrik.

Untuk kumpulan metrik evaluasi Workload Manager

Untuk mengizinkan agen mengumpulkan metrik evaluasi Workload Manager:

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

Untuk menghentikan pengumpulan metrik evaluasi Workload Manager:

sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -disable

Untuk mengubah frekuensi agen harus mengumpulkan metrik evaluasi Workload Manager:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_metrics_frequency=FREQUENCY
```
Ganti FREQUENCY dengan frekuensi, dalam hitungan detik, saat agen harus mengumpulkan metrik evaluasi Workload Manager.
Untuk mengubah frekuensi saat agen harus mengumpulkan metrik database SAP HANA, untuk evaluasi Workload Manager:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_db_metrics_frequency=FREQUENCY
```
Ganti FREQUENCY dengan frekuensi, dalam hitungan detik, saat agen harus mengumpulkan metrik database SAP HANA untuk evaluasi Workload Manager.

Untuk pengumpulan metrik pemantauan SAP HANA

Untuk mengizinkan agen mengumpulkan metrik pemantauan SAP HANA:

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

Untuk menghentikan pengumpulan metrik pemantauan SAP HANA:

sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -disable

Untuk mengubah interval sampel saat agen harus mengumpulkan metrik SAP HANA Monitoring:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -sample_interval_sec=SAMPLE_INTERNAL
```
Ganti SAMPLE_INTERNAL dengan interval, dalam detik. Interval harus 5 detik atau lebih lama.
Guna mengubah nilai waktu tunggu untuk kueri yang dibuat ke instance SAP HANA Anda:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -query_timeout_sec=QUERY_TIMEOUT
```
Ganti QUERY_TIMEOUT dengan nilai, dalam detik.

Argumen yang didukung

Tabel berikut menjelaskan argumen yang dapat Anda gunakan dengan perintah google_cloud_sap_agent configure:

Argumen	Deskripsi
`-add`	Argumen ini membuat agen berhenti mengumpulkan metrik Pemantauan Proses yang Anda tentukan untuk argumen `-process_metrics_to_skip`.
`-disable`	Menonaktifkan fitur atau parameter agen yang ditentukan.
`-enable`	Mengaktifkan fitur atau parameter agen yang ditentukan.
`-f`=`FEATURE_NAME` atau `-feature`=`FEATURE_NAME`	`STRING` Menetapkan fitur agen yang ingin Anda konfigurasi. Berikut ini adalah nilai yang didukung: `host_metrics` `process_metrics` `agent_metrics` `hana_monitoring` `workload_validation` `sap_discovery`
`-h` atau `-help`	Menampilkan informasi bantuan untuk perintah.
`-loglevel`=`LOG_LEVEL`	`STRING` Menetapkan level logging untuk agen. Nilai yang didukung adalah: `debug`, `info`, `warn`, dan `error`.
`-path`=`PATH`	`STRING` Menetapkan jalur untuk file konfigurasi agen: `/etc/google-cloud-sap-agent/configuration.json`.
`-process_metrics_to_skip`="`LIST_OF_METRICS`"	`STRING` Menentukan metrik Pemantauan Proses yang harus dihentikan oleh agen. Gunakan koma untuk memisahkan nama metrik. Gunakan argumen `-add` dan `-remove` dengan `-process_metrics_to_skip`.
`-process_metrics_frequency`=`FREQUENCY`	`INT` Menetapkan frekuensi agen mengumpulkan metrik Pemantauan Proses yang berubah dengan cepat. Nilai defaultnya adalah `5` detik.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Menetapkan frekuensi agen mengumpulkan metrik Pemantauan Proses yang lambat. Nilai defaultnya adalah `30` detik.
`-query_timeout_sec`=`TIMEOUT`	`INT` Menetapkan waktu tunggu kueri, dalam detik, untuk pengumpulan metrik pemantauan SAP HANA.
`-remove`	Argumen ini membuat agen melanjutkan pengumpulan metrik Pemantauan Proses yang Anda hentikan menggunakan argumen `-process_metrics_to_skip`.
`-sample_interval_sec`=`INTERVAL`	`INT` Menetapkan frekuensi, dalam detik, saat agen mengkueri instance SAP HANA Anda dan mengumpulkan metrik pemantauan SAP HANA.
`-setting`=`SETTING`	`STRING` Menentukan setelan agen yang ingin Anda konfigurasi.
`-showall`	Mencetak status fitur instance agen Anda.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Menetapkan frekuensi pengumpulan metrik Pemantauan Proses yang lambat, dalam hitungan detik.
`-v` atau `-version`	Mencetak versi agen.
`-workload_validation_metrics_frequency`=`FREQUENCY`	`INT` Menetapkan frekuensi agen mengumpulkan metrik evaluasi Workload Manager.
`-workload_validation_db_metrics_frequency`=`FREQUENCY`	`INT` Menetapkan frekuensi agen mengumpulkan metrik database SAP HANA untuk evaluasi Workload Manager.