Mengonfigurasi Agen untuk SAP guna menyiapkan kemampuan observasi

Dokumen ini menjelaskan cara mengonfigurasi Google Cloud's Agen untuk SAP guna menyiapkan observabilitas untuk workload SAP Anda menggunakan Workload Manager.

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

Sebelum memulai

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

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

• Pastikan Anda telah menyelesaikan Prasyarat untuk observabilitas SAP.

Mengonfigurasi agen untuk workload satu 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 fleet instance Compute Engine, Anda harus membuat kebijakan VM Extension Manager untuknya.

Perhatian: Jika Anda membuat kebijakan VM Extension Manager untuk menargetkan instance komputasi yang sudah menjalankan Agen untuk SAP, kebijakan tersebut akan mengganti versi dan konfigurasi agen yang ada dengan apa 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 observabilitas untuk workload SAP yang berjalan dalam 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 observabilitas, 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 observabilitas, 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 fleet instance Compute Engine, Anda harus membuat kebijakan VM Extension Manager untuknya.

Perhatian: Jika Anda membuat kebijakan VM Extension Manager untuk menargetkan instance komputasi yang sudah menjalankan Agen untuk SAP, kebijakan tersebut akan mengganti versi dan konfigurasi agen yang ada dengan apa 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 observabilitas untuk workload SAP yang sedang 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 observabilitas, 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 observabilitas, lihat Contoh konfigurasi agen.

Memvalidasi penyiapan untuk observabilitas Workload Manager

Anda dapat memvalidasi apakah Anda memiliki penyiapan yang benar untuk menggunakan layanan observabilitas Workload Manager dengan menjalankan perintah agen. Google Cloud 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 observabilitas:

   sudo /usr/bin/google_cloud_sap_agent status
   

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

   Agent Status:
       Installed version: 3.13-....
       ...
       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 dari Google Cloud's Agen untuk SAP yang dikonfigurasi untuk mendukung observabilitas untuk 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 observabilitas untuk workload SAP, workload tersebut mungkin memerlukan waktu hingga 15 menit untuk muncul di halaman Observabilitas Workload Manager di Google Cloud konsol.

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