Perintah konfigurasi untuk Agen Google Cloud untuk SAP

Dokumen ini menunjukkan perintah yang dapat Anda gunakan untuk mengubah konfigurasi Agen Google Cloud untuk SAP. Perintah ini didukung mulai agen versi 3.2.

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

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 di luar batas ini akan gagal dengan output: Could not restart the agent.

Jika Anda melihat output ini, setelah menjalankan semua perintah konfigurasi yang diperlukan, Anda harus 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 agen dan 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 informasi tentang argumen yang didukung oleh perintah google_cloud_sap_agent configure, lihat Argumen yang didukung.

Untuk setelan tingkat teratas

  • Untuk mengonfigurasi agen bagi server Solusi Bare Metal:
    sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -enable

    Untuk mengonfigurasi agen untuk instance 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.

Untuk penemuan sistem SAP

  • Agar agen dapat mengumpulkan nama dan versi produk SAP yang digunakan oleh sistem SAP Anda:

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

    Untuk menghentikan agen mengumpulkan nama dan versi produk SAP yang digunakan oleh sistem SAP Anda:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -disable
  • Agar agen dapat mengirim informasi sistem SAP yang ditemukan ke Cloud Logging, dan ke Workload Manager jika Workload Manager API diaktifkan di project Google Cloud Anda:

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

    Untuk menghentikan agen agar tidak mengirim informasi yang ditemukan ke Cloud Logging dan Workload Manager:

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

Untuk pengumpulan 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 pengumpulan metrik kesehatan Agen

  • Untuk mengaktifkan pengumpulan metrik kesehatan agen:

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

    Untuk menonaktifkan pengumpulan metrik kesehatan 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. Frekuensi 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 Process Monitoring

  • Untuk mengizinkan agen mengumpulkan metrik Process Monitoring:

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

    Untuk menghentikan pengumpulan metrik Process Monitoring:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -disable
  • Untuk mengubah frekuensi pengumpulan metrik Process Monitoring yang berubah cepat oleh agen:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY

    Untuk mengubah frekuensi pengumpulan metrik Process Monitoring yang berubah lambat oleh agen:

    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 Process Monitoring:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add

    Untuk melanjutkan pengumpulan metrik Process Monitoring 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 Process Monitoring yang ingin Anda lanjutkan pengumpulannya oleh agen. Gunakan koma untuk memisahkan nama metrik.

Untuk pengumpulan metrik evaluasi Workload Manager

  • Agar agen dapat mengumpulkan metrik evaluasi Workload Manager:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
  • Untuk menghentikan pengumpulan metrik evaluasi Workload Manager:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -disable
  • Untuk mengubah frekuensi saat agen harus mengumpulkan metrik evaluasi Workload Manager:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_metrics_frequency=FREQUENCY

    Ganti FREQUENCY dengan frekuensi, dalam 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_evaluation -workload_evaluation_db_metrics_frequency=FREQUENCY

    Ganti FREQUENCY dengan frekuensi, dalam 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 Pemantauan SAP HANA:

    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.

  • Untuk mengubah nilai waktu tunggu kueri yang dibuat ke instance SAP HANA:

    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 Process Monitoring 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 adalah nilai yang didukung:

  • host_metrics
  • process_metrics
  • agent_metrics
  • hana_monitoring
  • workload_evaluation
  • 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 Process Monitoring yang harus berhenti dikumpulkan 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 pengumpulan metrik Process Monitoring yang berubah cepat. Nilai default-nya adalah 5 detik.

-slow_process_metrics_frequency=FREQUENCY

INT

Menetapkan frekuensi pengumpulan metrik Process Monitoring yang berubah lambat. Nilai default-nya 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 Process Monitoring 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 Process Monitoring yang berubah lambat, dalam hitungan detik.

-v atau -version

Mencetak versi agen.

-workload_evaluation_metrics_frequency=FREQUENCY

INT

Menetapkan frekuensi saat agen mengumpulkan metrik evaluasi Workload Manager.

-workload_evaluation_db_metrics_frequency=FREQUENCY

INT

Menetapkan frekuensi saat agen mengumpulkan metrik database SAP HANA untuk evaluasi Workload Manager.