Mengonfigurasi Agen untuk SAP guna menyiapkan kemampuan observasi

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dokumen ini menjelaskan cara mengonfigurasi Agen Google Clouduntuk SAP guna menyiapkan kemampuan pengamatan untuk workload SAP Anda menggunakan Workload Manager.

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

Sebelum memulai

• Validasi penginstalan Agen Google Clouduntuk SAP di semua instance Compute Engine yang menjalankan workload SAP yang ingin Anda siapkan kemampuannya untuk diamati.

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

• Pastikan Anda telah menyelesaikan Prasyarat untuk kemampuan pengamatan SAP.

Mengonfigurasi agen untuk workload zona tunggal

VM Extension Manager

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

Perhatian: Jika Anda membuat kebijakan VM Extension Manager untuk menargetkan instance Compute yang sudah menjalankan Agen untuk SAP, kebijakan tersebut akan menggantikan versi dan konfigurasi agen yang ada dengan yang telah Anda tentukan dalam kebijakan.

Konfigurasi agen yang ada ditulis ke file BAK di direktori /etc/google-cloud-workload-agent/ pada instance komputasi masing-masing.

Untuk mengonfigurasi agen guna menyiapkan kemampuan pengamatan untuk beban kerja SAP yang berjalan di satu zona, selesaikan langkah-langkah berikut:

1. Siapkan VM Extension Manager:

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

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

     • Membuat kebijakan ekstensi VM
     • Memperbarui kebijakan ekstensi VM
     • Menghapus kebijakan ekstensi VM
     • Mencantumkan dan mendeskripsikan kebijakan ekstensi VM

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

   • 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 pengamatan, lihat Contoh konfigurasi agen.

Pengelola paket

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

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

2. Pastikan Anda menjalankan Agen untuk SAP versi terbaru.

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

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 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 beban kerja SAP Anda:

   1. Aktifkan fitur pemantauan SAP HANA pada 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 perlu 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 pengamatan, lihat Contoh konfigurasi agen.

Mengonfigurasi agen untuk workload multi-zona

VM Extension Manager

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

Perhatian: Jika Anda membuat kebijakan VM Extension Manager untuk menargetkan instance Compute yang sudah menjalankan Agen untuk SAP, kebijakan tersebut akan menggantikan versi dan konfigurasi agen yang ada dengan yang telah Anda tentukan dalam kebijakan.

Konfigurasi agen yang ada ditulis ke file BAK di direktori /etc/google-cloud-workload-agent/ pada instance komputasi masing-masing.

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

1. Siapkan VM Extension Manager:

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

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

     • Membuat kebijakan ekstensi VM
     • Memperbarui kebijakan ekstensi VM
     • Menghapus kebijakan ekstensi VM
     • Mencantumkan dan mendeskripsikan kebijakan ekstensi VM

2. Buat kebijakan ekstensi VM yang menginstal dan mengelola Agen untuk SAP Google Clouddi 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 pengamatan, lihat Contoh konfigurasi agen.

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

Pengelola paket

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

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

2. Pastikan Anda menjalankan Agen untuk SAP versi terbaru.

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

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 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 beban kerja SAP Anda:

   1. Aktifkan fitur pemantauan SAP HANA pada 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 perlu 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 bencana (DR) untuk workload SAP, ulangi prosedur ini untuk semua instance komputasi lain yang menjalankan workload SAP Anda.

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

Memvalidasi penyiapan untuk kemampuan pengamatan Workload Manager

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

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

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

2. Periksa penyiapan Google Cloud untuk kemampuan pengamatan:

   sudo /usr/bin/google_cloud_sap_agent status
   

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

   Agent Status:
       Installed version: 3.10-....
       ...
       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 belum dilakukan, 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 dari Agen Google Clouduntuk SAP yang dikonfigurasi untuk mendukung kemampuan pengamatan untuk beban kerja SAP HANA:

Contoh berikut menggunakan kunci Penyimpanan pengguna yang aman (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 Manager secret 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. 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 berhasil menyelesaikan penyiapan kemampuan pengamatan untuk workload SAP, mungkin diperlukan waktu hingga 15 menit agar workload tersebut muncul di halaman Kemampuan Pengamatan Workload Manager di konsol Google Cloud .

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