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.