Mengonfigurasi Agen untuk SAP guna menyiapkan kemampuan observasi

Dokumen ini menjelaskan cara mengonfigurasi Google Cloud's Agen untuk SAP untuk menyiapkan kemampuan observasi bagi workload SAP Anda menggunakan Workload Manager.

Layanan kemampuan observasi Workload Manager memerlukan agen untuk mengumpulkan metrik dari workload SAP dan infrastruktur yang mendasarinya. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kemampuan observasi SAP.

Sebelum memulai

• Validasi penginstalan Google CloudAgen untuk SAP di semua instance Compute Engine yang menjalankan workload SAP yang ingin Anda siapkan kemampuan observasinya.

  Untuk mengetahui informasi tentang cara memvalidasi penginstalan agen, lihat Memvalidasi penginstalan agen Anda.

• Pastikan Anda telah menyelesaikan Prasyarat untuk kemampuan observasi SAP.

Mengonfigurasi agen untuk workload satu zona

VM Extension Manager

Untuk mengonfigurasi dan mengelola agen di fleet instance Compute Engine, Anda harus membuat kebijakan VM Extension Manager untuknya.

Perhatian: Jika Anda menerapkan kebijakan VM Extension Manager ke VM tempat Agen untuk SAP sudah berjalan, kebijakan tersebut akan mengganti versi dan konfigurasi agen yang ada dengan apa yang telah Anda tetapkan dalam kebijakan.

Konfigurasi agen yang ada ditulis ke file BAK di direktori /etc/google-cloud-sap-agent/ di VM masing-masing.

Untuk mengonfigurasi agen guna menyiapkan kemampuan observasi bagi workload SAP yang berjalan di satu zona, selesaikan langkah-langkah berikut:

1. Siapkan VM Extension Manager:

   • Dalam dokumentasi VM Extension Manager, tinjau Sebelum memulai bagian.

   • Siapkan peran IAM yang diperlukan untuk membuat dan mengelola kebijakan VM Extension Manager. Untuk mengetahui informasi selengkapnya, lihat referensi berikut:

     • Membuat kebijakan ekstensi VM
     • Mengupdate kebijakan ekstensi VM
     • Menghapus kebijakan ekstensi VM
     • Mencantumkan dan menjelaskan kebijakan ekstensi VM

2. Buat kebijakan ekstensi VM yang menginstal dan mengelola Google Cloud's Agen untuk SAP di instance komputasi yang menjalankan workload SAP Anda:

   • Buat kebijakan ekstensi VM di zona tempat workload SAP Anda berjalan. Untuk mengetahui informasi tentang cara membuat kebijakan ekstensi VM tersebut, lihat Membuat kebijakan ekstensi VM zonal.
   • Untuk melihat contoh konfigurasi agen untuk kemampuan observasi, lihat Contoh konfigurasi agen.

Pengelola paket

Jika Anda mengelola siklus proses agen secara manual, bukan menggunakan VM Extension Manager, Anda dapat mengonfigurasi Google Cloud's Agen untuk SAP menggunakan pengelola paket:

1. Buat koneksi SSH dengan instance komputasi yang menjalankan workload SAP Anda.

2. Pastikan Anda menjalankan Agen untuk SAP versi terbaru.

   Untuk mengetahui informasi tentang cara mengupdate agen, lihat Mengupdate Google Cloud's Agen untuk SAP.

3. Agar agen dapat mencari detail tentang workload SAP dan mengirimkannya ke Workload Manager:

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

4. Aktifkan agen untuk mengumpulkan metrik dari proses yang berjalan di workload SAP Anda:

   1. Aktifkan fitur pemantauan proses agen:

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

   1. Agar agen dapat mengumpulkan metrik proses yang terkait dengan instance database SAP HANA Anda, Anda harus mengonfigurasi parameter tambahan di bagian hana_metrics_config.

   Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi pengumpulan metrik pemantauan proses.

5. Aktifkan agen untuk mengumpulkan metrik dari instance SAP HANA yang berjalan di workload SAP Anda:

   1. Aktifkan fitur pemantauan SAP HANA agen:

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

   1. Agar agen dapat terhubung dengan instance SAP HANA dan mengumpulkan metrik, Anda harus mengonfigurasi parameter tambahan.

   Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi pengumpulan metrik pemantauan SAP HANA.

6. Simpan file konfigurasi.

Untuk melihat contoh konfigurasi agen untuk kemampuan observasi, lihat Contoh konfigurasi agen.

Mengonfigurasi agen untuk workload multi-zona

VM Extension Manager

Untuk mengonfigurasi dan mengelola agen di fleet instance Compute Engine, Anda harus membuat kebijakan VM Extension Manager untuknya.

Perhatian: Jika Anda menerapkan kebijakan VM Extension Manager ke VM tempat Agen untuk SAP sudah berjalan, kebijakan tersebut akan mengganti versi dan konfigurasi agen yang ada dengan apa yang telah Anda tetapkan dalam kebijakan.

Konfigurasi agen yang ada ditulis ke file BAK di direktori /etc/google-cloud-sap-agent/ di VM masing-masing.

Untuk mengonfigurasi agen guna menyiapkan kemampuan observasi bagi workload SAP yang berjalan di dua zona atau lebih, selesaikan langkah-langkah berikut:

1. Siapkan VM Extension Manager:

   • Dalam dokumentasi VM Extension Manager, tinjau Sebelum memulai bagian.

   • Siapkan peran IAM yang diperlukan untuk membuat dan mengelola kebijakan VM Extension Manager. Untuk mengetahui informasi selengkapnya, lihat referensi berikut:

     • Membuat kebijakan ekstensi VM
     • Mengupdate kebijakan ekstensi VM
     • Menghapus kebijakan ekstensi VM
     • Mencantumkan dan menjelaskan kebijakan ekstensi VM

2. Buat kebijakan ekstensi VM yang menginstal dan mengelola Google Cloud's Agen untuk SAP di instance komputasi yang menjalankan situs utama workload SAP Anda:

   • Buat kebijakan ekstensi VM di zona tempat situs utama workload SAP Anda berjalan. Untuk mengetahui informasi tentang cara membuat kebijakan ekstensi VM tersebut, lihat Membuat kebijakan ekstensi VM zonal.
   • Untuk melihat contoh konfigurasi agen untuk kemampuan observasi, lihat Contoh konfigurasi agen.

3. Jika Anda menjalankan workload SAP dengan ketersediaan tinggi, atau memiliki situs pemulihan dari bencana (DR) untuk workload SAP Anda, buat kebijakan ekstensi VM yang menginstal dan mengelola Google CloudAgen untuk SAP di instance komputasi yang menjalankan situs sekunder atau DR workload SAP Anda.

Pengelola paket

Jika Anda mengelola siklus proses agen secara manual, bukan menggunakan VM Extension Manager, Anda dapat mengonfigurasi Google Cloud's Agen untuk SAP menggunakan pengelola paket:

1. Buat koneksi SSH dengan instance komputasi yang menjalankan workload SAP Anda.

2. Pastikan Anda menjalankan Agen untuk SAP versi terbaru.

   Untuk mengetahui informasi tentang cara mengupdate agen, lihat Mengupdate Google Cloud's Agen untuk SAP.

3. Agar agen dapat mengumpulkan detail tentang workload SAP dan mengirimkannya ke Workload Manager:

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

4. Aktifkan agen untuk mengumpulkan metrik dari proses yang berjalan di workload SAP Anda:

   1. Aktifkan fitur pemantauan proses agen:

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

   1. Agar agen dapat mengumpulkan metrik proses yang terkait dengan instance database SAP HANA Anda, Anda harus mengonfigurasi parameter tambahan di bagian hana_metrics_config.

   Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi pengumpulan metrik pemantauan proses.

5. Aktifkan agen untuk mengumpulkan metrik dari instance SAP HANA yang berjalan di workload SAP Anda:

   1. Aktifkan fitur pemantauan SAP HANA agen:

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

   1. Agar agen dapat terhubung dengan instance SAP HANA dan mengumpulkan metrik, Anda harus mengonfigurasi parameter tambahan.

   Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi pengumpulan metrik pemantauan SAP HANA.

6. Simpan file konfigurasi.

7. Jika Anda menjalankan workload SAP dengan ketersediaan tinggi, atau memiliki situs pemulihan dari bencana (DR) untuk workload SAP Anda, ulangi prosedur ini untuk semua instance komputasi lain yang menjalankan workload SAP Anda.

Untuk melihat contoh konfigurasi agen untuk kemampuan observasi, lihat Contoh konfigurasi agen.

Memvalidasi penyiapan untuk kemampuan observasi Workload Manager

Anda dapat memvalidasi apakah Anda memiliki Google Cloud penyiapan yang benar untuk menggunakan layanan kemampuan observasi Workload Manager dengan menjalankan perintah agen status.

Untuk memvalidasi penyiapan Google Cloud , selesaikan langkah-langkah berikut:

1. Buat koneksi SSH dengan instance Compute Engine yang menjalankan workload SAP Anda.

2. Periksa Google Cloud penyiapan untuk kemampuan observasi:

   sudo /usr/bin/google_cloud_sap_agent status
   

   Jika Google Cloud penyiapan Anda untuk menggunakan layanan kemampuan observasi Workload Manager sudah benar, output akan mencakup hal berikut. Konfigurasi Anda mungkin memiliki nilai selain default.

   Agent Status:
       Installed version: 3.15-....
       ...
       Systemd Service Enabled: True
       Systemd Service Running: True
       Cloud API Full Scopes: True
       Configuration File: /etc/google-cloud-sap-agent/configuration.json
       Configuration Valid: True
   ...
   ----------------------------------------------------------------------------
   Process Metrics: Enabled
       Status: Fully Functional
       IAM Permissions: All granted
       Configuration:
           collect_process_metrics:        true (configuration file)
           process_metrics_frequency:      30    (default)
           process_metrics_to_skip:        []   (default)
           slow_process_metrics_frequency: 120   (default)
   ...
   ----------------------------------------------------------------------------
   HANA Monitoring Metrics: Enabled
       Status: Fully Functional
       IAM Permissions: All granted
       Configuration:
           connection_timeout:       120   (default)
           enabled:                  true  (configuration file)
           execution_threads:        10    (default)
           max_connect_retries:      1     (default)
           query_timeout_sec:        300   (default)
           sample_interval_sec:      300   (default)
           send_query_response_time: false (default)
   ...
   ----------------------------------------------------------------------------
   System Discovery: Enabled
       Status: Fully Functional
       IAM Permissions: All granted
       Configuration:
           enable_discovery:                  true  (default)
           enable_workload_discovery:         true  (default)
           sap_instances_update_frequency:    60    (default)
           system_discovery_update_frequency: 14400 (default)
   ...
   

3. Jika output Anda menunjukkan bahwa beberapa penyiapan tidak ada, tinjau informasi yang diberikan di bagian sebelumnya, lakukan tindakan yang diperlukan, lalu jalankan kembali perintah status untuk memvalidasi ulang penyiapan.

4. Jika Anda menggunakan lebih dari satu instance komputasi untuk menjalankan workload, ulangi prosedur ini untuk semua instance komputasi lain yang menjalankan workload Anda.

Contoh konfigurasi agen

Contoh berikut adalah file konfigurasi lengkap Google Cloud's Agen untuk SAP yang dikonfigurasi untuk mendukung kemampuan observasi bagi workload SAP HANA:

Contoh berikut menggunakan kunci Secure user store (hdbuserstore) untuk autentikasi SAP HANA:

  {
    "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": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

Contoh berikut menggunakan nama pengguna dan secret Secret Manager untuk autentikasi SAP HANA:

  {
    "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": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "host": "localhost",
          "port": "30015",
          "user": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

Contoh berikut menggunakan nama pengguna dan sandi untuk autentikasi SAP HANA autentikasi. Sebaiknya gunakan kunci Secure user store (hdbuserstore) atau secret Secret Manager untuk autentikasi SAP HANA.

  {
    "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": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "host": "localhost",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi.

Langkah berikutnya

• Setelah Anda berhasil menyelesaikan penyiapan kemampuan observasi untuk workload SAP, workload tersebut mungkin memerlukan waktu hingga 15 menit untuk muncul di halaman Kemampuan Observasi Workload Manager di Google Cloud konsol.

  Untuk mengetahui informasi tentang cara mengamati workload SAP Anda, lihat Melihat metrik kemampuan observasi untuk SAP.