Menginstal dan mengonfigurasi Agen Google Cloud untuk SAP di instance Compute Engine

Version 3.6 (latest)

• Versi 3.6 (latest)
• Versi 2
• Versi 1

Agen Google Cloud untuk SAP diperlukan untuk dukungan SAP sistem SAP yang berjalan di Google Cloud, termasuk SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB, dan lainnya.

Saat Anda menginstal Agen Google Cloud untuk SAP di instance Compute Engine, untuk metrik Agen Host SAP, agen tersebut akan menggabungkan data pemantauan dari Cloud Monitoring dan Compute Engine API serta memberikan data tersebut ke Agen Host SAP.

Jika Anda menggunakan OS image RHEL atau SLES "for SAP" berikut yang disediakan Google Cloud, Agen Google Cloud untuk SAP akan dikemas dengan OS image:

• RHEL: semua image "for SAP"
• SLES: SLES 15 SP4 untuk SAP dan versi yang lebih baru

Untuk mengetahui informasi tentang sistem operasi yang didukung oleh Agen Google Cloud untuk SAP, lihat Sistem operasi yang didukung.

Untuk menginstal dan mengonfigurasi Agen Google Cloud untuk SAP versi 3.6 (terbaru) di server Solusi Bare Metal, lihat Menginstal Agen Google Cloud untuk SAP di server Solusi Bare Metal.

Ringkasan penginstalan

Di Linux, Anda dapat menginstal Agen Google Cloud untuk SAP menggunakan perintah pengelolaan paket sistem operasi standar: di RHEL, perintah yum; di SLES, perintah zypper. Perintah pengelolaan paket akan menyelesaikan tugas berikut:

• Download versi terbaru Agen Google Cloud untuk SAP.
• Membuat agen sebagai layanan systemd Linux, yang bernama google-cloud-sap-agent.
• Mengaktifkan dan memulai layanan, google-cloud-sap-agent.

Di Windows, instal Agen Google Cloud untuk SAP menggunakan perintah pengelolaan paket GooGet, googet. Perintah pengelolaan paket akan menyelesaikan tugas-tugas berikut:

• Download versi terbaru Agen Google Cloud untuk SAP.

• Membuat layanan Windows bernama google-cloud-sap-agent dan tugas terjadwal yang berjalan setiap menit untuk memeriksa apakah layanan masih berjalan dan, jika perlu, memulai ulang layanan.

  Peringatan: Jangan menghentikan layanan Windows secara manual atau menghapus tugas terjadwal.

Prasyarat untuk agen

Sebelum menginstal Agen Google Cloud untuk SAP, Anda harus memastikan bahwa prasyarat berikut terpenuhi.

Menetapkan peran IAM yang diperlukan

Setidaknya, akun layanan yang digunakan Agen Google Cloud untuk SAP harus menyertakan peran Compute Viewer (roles/compute.viewer), Monitoring Viewer (roles/monitoring.viewer), dan Workload Manager Insights Writer (roles/workloadmanager.insightWriter).

Untuk menambahkan peran yang diperlukan ke akun layanan Anda, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman IAM.

   Buka IAM

2. Pilih project Google Cloud Anda.

3. Identifikasi akun layanan tempat Anda ingin menambahkan peran.

   • Jika akun layanan belum ada dalam daftar akun utama, akun layanan tidak memiliki peran yang ditetapkan pada akun tersebut. Klik Add, lalu masukkan alamat email akun layanan.
   • Jika akun layanan sudah ada di daftar utama, berarti akun tersebut sudah memiliki peran. Klik tombol Edit untuk akun layanan yang ingin diedit.

4. Pilih peran yang diperlukan dari daftar peran yang tersedia:

   • Compute Engine > Viewer Compute
   • Monitoring > Monitoring Viewer
   • Workload Manager > Workload Manager Insights Writer

5. Klik Add atau Save untuk menerapkan peran ke akun layanan.

Mengaktifkan akses ke Google Cloud API

Compute Engine merekomendasikan konfigurasi instance komputasi Anda untuk mengizinkan semua cakupan akses ke semua Cloud API dan hanya menggunakan izin IAM dari akun layanan instance untuk mengontrol akses ke resource Google Cloud. Untuk mengetahui informasi selengkapnya, lihat Membuat VM yang menggunakan akun layanan yang dikelola pengguna.

Jika Anda membatasi akses ke Cloud API, Agen Google Cloud untuk SAP memerlukan cakupan akses Cloud API minimum berikut pada instance Compute Engine host:

• Cloud Platform: Diaktifkan
• Compute Engine: Hanya Baca
• Stackdriver Monitoring API: Hanya Baca

Jika Anda menjalankan aplikasi SAP pada instance komputasi yang tidak memiliki alamat IP eksternal, Anda harus mengaktifkan Akses Google Pribadi pada subnet instance komputasi agar Agen Google Cloud untuk SAP dapat mengakses Google API dan layanan Google. Untuk mengaktifkan Akses Google Pribadi di subnet, lihat Mengonfigurasi Akses Google Pribadi.

Menginstal agen

Untuk menginstal Agen Google Cloud untuk SAP di instance Compute Engine, pilih sistem operasi Anda, lalu selesaikan langkah-langkah berikut.

Catatan: Untuk menginstal agen di beberapa instance komputasi, download file YAML untuk kebijakan OS yang diperlukan dari Kebijakan Agen untuk SAP VM Manager, lalu gunakan untuk membuat dan meluncurkan penetapan kebijakan OS.

Linux

Untuk menginstal agen pada instance Compute Engine, ikuti langkah-langkah berikut:

1. Buat koneksi SSH ke instance komputasi Anda.
2. Di terminal, instal agen dengan menjalankan perintah khusus untuk sistem operasi Anda:
   • (Direkomendasikan) Untuk menginstal agen versi 3.6 (terbaru):

     RHEL

     sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
     [google-cloud-sap-agent]
     name=Google Cloud Agent for SAP
     baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=0
     gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
     EOM
     sudo yum install google-cloud-sap-agent

     SLES15

     sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
     sudo zypper install google-cloud-sap-agent

     SLES 12

     sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
     sudo zypper install google-cloud-sap-agent

   • Untuk menginstal versi agen tertentu:

     RHEL

     sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
     [google-cloud-sap-agent]
     name=Google Cloud Agent for SAP
     baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=0
     gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
     EOM
     sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

     SLES15

     sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
     sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

     SLES 12

     sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
     sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

     Ganti VERSION_NUMBER dengan nomor versi agen yang ingin Anda instal, seperti 3.1-606637668. Untuk informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.

     Untuk informasi tentang cara mendowngrade agen ke versi tertentu, lihat Mendowngrade Agen Google Cloud untuk SAP.

Windows

Untuk menginstal agen pada instance Compute Engine, ikuti langkah-langkah berikut:

1. Gunakan RDP untuk terhubung ke instance komputasi.
2. Sebagai administrator, jalankan perintah berikut dari PowerShell:

   googet addrepo google-cloud-sap-agent https://packages.cloud.google.com/yuck/repos/google-cloud-sap-agent-windows
   googet install google-cloud-sap-agent

Setelah menginstal Agen Google Cloud untuk SAP dan Agen Host SAP, validasikan penginstalan Agen Google Cloud untuk SAP, sebagaimana dijelaskan dalam Memvalidasi penginstalan agen.

Memvalidasi penginstalan agen Anda

Untuk memverifikasi bahwa agen sedang berjalan, pilih sistem operasi Anda, lalu ikuti langkah-langkah berikut:

Linux

1. Buat koneksi SSH dengan instance Compute Engine Anda.

2. Jalankan perintah berikut:

   systemctl status google-cloud-sap-agent

   Jika agen berfungsi dengan baik, output akan berisi active (running). Contoh:

   google-cloud-sap-agent.service - Google Cloud Agent for SAP
   Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
   Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
   Main PID: 1337673 (google-cloud-sa)
   Tasks: 9 (limit: 100427)
   Memory: 22.4 M (max: 1.0G limit: 1.0G)
   CGroup: /system.slice/google-cloud-sap-agent.service
          └─1337673 /usr/bin/google-cloud-sap-agent
   

3. Pada image SLES, untuk memastikan Anda menggunakan Agen Google Cloud untuk SAP versi terbaru, jalankan perintah berikut.

   Catatan: Agen Google Cloud untuk SAP dipaketkan dengan semua image "for SAP" RHEL, dan SLES versi 15 SP4 dan yang lebih baru. Karena image SLES untuk SAP diupdate setiap kuartal, ada kemungkinan versi agen yang dipaketkan dengan image OS tersebut bukan yang terbaru. Perintah berikut akan mengupdate instance agen Anda ke versi terbaru yang disediakan oleh Google Cloud.

   sudo zypper remove google-cloud-sap-agent
   sudo zypper addrepo -p 98 --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\$basearch google-cloud-sap-agent
   sudo zypper install google-cloud-sap-agent

Windows

1. Gunakan RDP untuk terhubung ke instance Compute Engine.

2. Sebagai administrator, jalankan perintah berikut dari PowerShell:

   $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status

   Jika agen berjalan, statusnya akan menampilkan Running.

Jika agen tidak berjalan, mulai ulang agen.

Memverifikasi bahwa Agen Host SAP menerima metrik

Untuk memverifikasi bahwa metrik infrastruktur dikumpulkan oleh Agen Google Cloud untuk SAP dan dikirim dengan benar ke Agen Host SAP, ikuti langkah-langkah berikut:

1. Di sistem SAP, masukkan transaksi ST06.

2. Di panel ringkasan, periksa ketersediaan dan konten kolom berikut untuk penyiapan infrastruktur pemantauan SAP dan Google yang menyeluruh dan benar:

   • Penyedia Cloud: Google Cloud Platform
   • Akses Pemantauan yang Ditingkatkan: TRUE
   • Detail Pemantauan yang Ditingkatkan: ACTIVE

Mengonfigurasi Agen Google Cloud untuk SAP di Linux

Setelah menginstal Agen Google Cloud untuk SAP, Anda dapat mengaktifkan fitur lainnya dari agen secara opsional dengan melakukan konfigurasi berikut. Secara default, pengumpulan metrik Agen Host SAP dan metrik evaluasi Workload Manager diaktifkan.

Fitur berikut hanya didukung di Linux. Fitur ini tidak didukung di Windows.

• Mengonfigurasi pengumpulan metrik Process Monitoring
• Mengonfigurasi pengumpulan metrik evaluasi Workload Manager
• Konfigurasi pengumpulan metrik pemantauan SAP HANA.
• Mengonfigurasi pencadangan dan pemulihan berbasis Backint untuk SAP HANA.
• Cadangkan dan pulihkan SAP HANA menggunakan snapshot disk.

File konfigurasi default

Cuplikan berikut adalah contoh konfigurasi default Agent for SAP Google Cloud versi 3.6 (terbaru):

{
  "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": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Untuk melihat contoh file konfigurasi khusus fitur, lihat panduan konfigurasi untuk fitur tersebut.

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agent for SAP Google Cloud yang berjalan di instance Compute Engine, termasuk parameter yang terkait dengan pengumpulan metrik. Untuk informasi tentang parameter konfigurasi yang terkait dengan fitur Backint agen, lihat Parameter konfigurasi.

Parameter
provide_sap_host_agent_metrics	Boolean Untuk mengaktifkan pengumpulan metrik yang diperlukan oleh Agen Host SAP, tentukan true. Default-nya adalah true. Jangan tetapkan provide_sap_host_agent_metrics ke false kecuali jika Anda diarahkan oleh Cloud Customer Care atau Dukungan SAP.
bare_metal	Boolean Saat agen diinstal di server Solusi Bare Metal, tentukan true. Default-nya adalah false.
log_level	String Untuk menetapkan level logging agen, tetapkan nilai yang diperlukan. Level log yang tersedia adalah sebagai berikut: DEBUG INFO WARNING ERROR Default-nya adalah INFO. Jangan ubah level logging kecuali jika Anda diarahkan oleh Cloud Customer Care.
log_to_cloud	Boolean Untuk mengalihkan log agen ke Cloud Logging, tentukan true. Defaultnya adalah true.
cloud_properties.project_id	String Jika sistem SAP Anda berjalan pada server Solusi Bare Metal, tentukan project ID dari project Google Cloud yang Anda gunakan dengan Solusi Bare Metal. Saat agen berjalan di instance Compute Engine, secara default, agen akan mendeteksi project ID secara otomatis.
cloud_properties.instance_name	String Tentukan nama instance Compute Engine Anda. Agen akan otomatis mendeteksinya saat penginstalan.
cloud_properties.region	String Jika sistem SAP Anda berjalan di server Solusi Bare Metal, tentukan region server Solusi Bare Metal. Ketika agen berjalan di instance komputasi, secara default, agen menggunakan region tempat instance komputasi di-deploy.
cloud_properties.zone	String Saat agen berjalan di instance komputasi, secara default, agen menggunakan zona tempat instance komputasi di-deploy.
cloud_properties.image	String Tentukan nama OS image instance. Saat agen berjalan di instance komputasi, secara default, agen akan otomatis mendeteksi OS image yang digunakan oleh instance komputasi.
cloud_properties.numeric_project_id	String Tentukan ID numerik project Google Cloud tempat sistem SAP berjalan. Saat agen berjalan di instance komputasi, secara default, agen akan otomatis mendeteksi nomor project.
discovery_configuration.enable_workload_discovery	Boolean Agar agen dapat mengumpulkan nama dan versi produk SAP yang berjalan di host, tentukan true. Nilai defaultnya adalah true. Untuk mengetahui informasi selengkapnya, lihat codebase agen di repositori GitHub google-cloud-sap-agent di bagian GoogleCloudPlatform/sapagent.
discovery_configuration.enable_discovery	Boolean Untuk mengirim informasi yang dikumpulkan agen tentang produk SAP yang berjalan di host ke Cloud Logging, tentukan true. Nilai defaultnya adalah true. Jika Anda menentukan nilai false, agen akan menyimpan informasi yang dikumpulkan di host dan tidak mengirimkannya ke Cloud Logging.
collection_configuration.collect_process_metrics	Boolean Untuk mengaktifkan pengumpulan metrik Process Monitoring, tentukan true. Default-nya adalah false. Parameter ini hanya berlaku untuk Linux. Jika mengaktifkan pengumpulan metrik Process untuk SAP HANA, Anda harus menyiapkan parameter tambahan yang tercantum di bagian hana_metrics_config.
collection_configuration.process_metrics_frequency	Int Dari versi 2.6, parameter ini menentukan frekuensi pengumpulan metrik Process Monitoring yang berubah cepat, dalam hitungan detik. Metrik Pemantauan Proses yang cepat berubah adalah: sap/hana/availability, sap/hana/ha/availability, dan sap/nw/availability. Nilai default untuk parameter ini adalah 5 detik. Sebaiknya gunakan nilai default ini. Semua metrik Process Monitoring lainnya (berubah lambat) dikumpulkan pada frekuensi default 30 detik. Untuk mengubah frekuensi pengumpulan metrik Pemantauan Proses yang berubah lambat, gunakan parameter slow_process_metrics_frequency.
collection_configuration.slow_process_metrics_frequency	Int Tentukan frekuensi pengumpulan metrik Pemantauan Proses yang lambat, dalam hitungan detik. Nilai default untuk parameter ini adalah 30 detik.
collection_configuration.process_metrics_to_skip	Array Tentukan metrik Process Monitoring yang Anda tidak ingin dikumpulkan oleh agen. Parameter ini menerima nilai yang dipisahkan koma dari nama metrik Pemantauan Proses. Contoh: "process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"].
collection_configuration.hana_metrics_config.hana_db_user	String Tentukan akun pengguna database yang digunakan agen untuk membuat kueri SAP HANA. Default-nya adalah SYSTEM.
collection_configuration.hana_metrics_config.hana_db_password	String Tentukan sandi teks biasa untuk akun pengguna database yang digunakan agen untuk mengkueri SAP HANA. Daripada menentukan sandi teks biasa, sebaiknya gunakan salah satu opsi berikut: hana_db_password_secret_name, yang Anda tentukan secret-nya yang disimpan di Secret Manager. hdbuserstore_key, yang Anda tentukan untuk kunci hdbuserstore. Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.
collection_configuration.hana_metrics_config.hana_db_password_secret_name	String Untuk memberikan sandi dengan aman bagi akun pengguna database yang digunakan agen untuk mengkueri SAP HANA, tentukan nama secret yang berisi kredensial keamanan untuk akun pengguna database. Penting: Secret dan instance Compute Engine host harus ada di project Google Cloud yang sama. Agen mengumpulkan metrik terkait SAP HANA hanya jika Anda menentukan hana_db_password_secret_name, hdbuserstore_key, atau hana_db_password. Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.
collection_configuration.hana_metrics_config.hdbuserstore_key	String Untuk terhubung dengan aman ke sistem SAP HANA, tentukan kunci Secure user store (hdbuserstore) yang telah Anda buat untuk sistem tersebut. Untuk menggunakan kunci hdbuserstore untuk autentikasi, pastikan hal berikut: Alat SAP hdbsql dan hdbuserstore diinstal di instance compute yang menghosting agen. Kunci hdbuserstore sesuai dengan satu instance SAP HANA tertentu. Anda tidak dapat menggunakan kunci yang berisi nama host beberapa instance SAP HANA. Pengguna SIDadm dapat membuat kueri database SAP HANA menggunakan kunci ini. Di sini, SID mengacu pada nilai yang telah Anda tentukan untuk parameter sid. Anda dapat memverifikasinya dengan menjalankan perintah berikut sebagai pengguna SIDadm: hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY" Parameter konfigurasi ini didukung mulai agen versi 3.3. Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.
collection_configuration.hana_metrics_config.sid	String Tentukan SID instance SAP HANA Anda. Jika Anda menggunakan kunci hdbuserstore untuk mengautentikasi ke SAP HANA, lihat bagian hdbuserstore_key.
collection_configuration.collect_workload_validation_metrics	Boolean Untuk mengaktifkan pengumpulan metrik evaluasi Workload Manager, tentukan true. Mulai versi 3.2, nilai defaultnya adalah true. Parameter ini hanya berlaku untuk Linux.
collection_configuration.workload_validation_metrics_frequency	Int Frekuensi pengumpulan metrik evaluasi Workload Manager dalam hitungan detik. Nilai default-nya adalah 300 detik. Sebaiknya jangan ubah frekuensi pengumpulan default karena dapat memengaruhi seluruh fitur itu sendiri. Jika Anda perlu mengubah frekuensi pengumpulan metrik Workload Manager, tambahkan parameter workload_validation_metrics_frequency di bagian collection_configuration dan berikan nilai yang diperlukan.
collection_configuration.workload_validation_collection_definition.fetch_latest_config	Boolean Opsional. Nilai defaultnya adalah true, yang memungkinkan agen mengumpulkan kumpulan metrik evaluasi Workload Manager terbaru tanpa mengharuskan Anda mengupdate agen. Jika Anda ingin menonaktifkan perilaku ini, tentukan parameter ini dalam file konfigurasi dan tetapkan nilainya ke false.
collection_configuration.workload_validation_db_metrics_config.hana_db_user	String Tentukan akun pengguna yang digunakan untuk membuat kueri instance SAP HANA. Akun pengguna harus memiliki izin baca ke database SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hana_db_password	String Tentukan sandi untuk akun pengguna yang digunakan untuk membuat kueri instance SAP HANA. Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name	String Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna. Atau, Anda dapat menentukan parameter konfigurasi hdbuserstore_key untuk mengautentikasi pengguna SAP HANA yang ditentukan. Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key	String Untuk terhubung dengan aman ke sistem SAP HANA, tentukan kunci Secure user store (hdbuserstore) yang telah Anda buat untuk sistem tersebut. Untuk menggunakan kunci hdbuserstore untuk autentikasi, pastikan hal berikut: Alat SAP hdbsql dan hdbuserstore diinstal di instance compute yang menghosting agen. Kunci hdbuserstore sesuai dengan satu instance SAP HANA tertentu. Anda tidak dapat menggunakan kunci yang berisi nama host beberapa instance SAP HANA. Pengguna SIDadm dapat membuat kueri database SAP HANA menggunakan kunci ini. Di sini, SID mengacu pada nilai yang telah Anda tentukan untuk parameter sid. Anda dapat memverifikasinya dengan menjalankan perintah berikut sebagai pengguna SIDadm: hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY" Parameter konfigurasi ini didukung mulai agen versi 3.3. Jika menentukan hdbuserstore_key, Anda dapat melewati penentuan parameter hostname dan port. Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter hana_db_password, yang lebih disukai daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.
collection_configuration.workload_validation_db_metrics_config.sid	String Tentukan SID instance SAP HANA Anda.
collection_configuration.workload_validation_db_metrics_config.hostname	String Tentukan ID untuk mesin, baik lokal maupun jarak jauh, yang menghosting instance SAP HANA Anda. Berikut ini adalah nilai yang didukung: Jika host adalah komputer lokal, tentukan string localhost atau alamat IP loopback localhost, seperti 127.0.0.1. Jika host adalah komputer jarak jauh, tentukan alamat IP internal atau eksternalnya.
collection_configuration.workload_validation_db_metrics_config.port	String Tentukan port tempat instance SAP HANA Anda menerima kueri. Untuk instance database tenant pertama atau satu-satunya, port-nya adalah 3NN15, dengan NN sebagai nomor instance dari instance SAP HANA.
collection_configuration.workload_validation_db_metrics_frequency	Int Frekuensi pengumpulan metrik database SAP HANA, dalam detik, untuk evaluasi Workload Manager. Defaultnya adalah 3600 detik. Meskipun Anda dapat memperbarui frekuensi pengumpulan metrik database SAP HANA, sebaiknya gunakan nilai default. Jika Anda perlu mengubah nilai default, tambahkan parameter workload_validation_db_metrics_frequency di bagian collection_configuration dan berikan nilai yang diperlukan. Pastikan Anda tidak menetapkan frekuensi pengumpulan yang lebih besar dari 3600 detik.
hana_monitoring_configuration.enabled	Boolean Opsional. Agar dapat mengaktifkan Agen Google Cloud untuk SAP untuk mengumpulkan metrik pemantauan SAP HANA, tentukan true. Nilai defaultnya adalah false. Parameter turunan berikut hanya berlaku jika Anda menentukan hana_monitoring_configuration.enabled: true.
hana_monitoring_configuration.sample_interval_sec	Int Opsional. Tentukan interval sampel, dalam detik, yang menentukan frekuensi saat Agen Google Cloud untuk SAP mengkueri instance SAP HANA Anda guna mengumpulkan metrik pemantauan SAP HANA. Nilai default-nya adalah 300 detik. Untuk setiap kueri yang ditentukan di file konfigurasi Agent for SAP Google Cloud, Anda dapat menimpa interval sampel global dengan menentukan interval yang diperlukan ke parameter sample_interval_sec. Interval sampel harus 5 detik atau lebih lama.
hana_monitoring_configuration.query_timeout_sec	Int Opsional. Tentukan waktu tunggu untuk setiap kueri yang diajukan ke instance SAP HANA. Nilai default-nya adalah 300 detik.
hana_monitoring_configuration.execution_threads	Int Opsional. Tentukan jumlah thread yang digunakan untuk mengirim kueri ke instance SAP HANA. Setiap kueri berjalan di threadnya sendiri. Nilai defaultnya adalah 10.
hana_monitoring_configuration.hana_instances.name	String Tentukan ID nama untuk instance SAP HANA Anda.
hana_monitoring_configuration.hana_instances.sid	String Tentukan SID instance SAP HANA Anda. String ini ditambahkan sebagai label ke semua metrik yang dihasilkan dari mengkueri instance SAP HANA Anda.
hana_monitoring_configuration.hana_instances.host	String Tentukan ID untuk mesin, baik lokal maupun jarak jauh, yang menghosting instance SAP HANA Anda. Berikut ini adalah nilai yang didukung: Jika host adalah komputer lokal, tentukan string localhost atau alamat IP loopback localhost, seperti 127.0.0.1. Jika host adalah komputer jarak jauh, tentukan alamat IP internal atau eksternalnya.
hana_monitoring_configuration.hana_instances.port	String Tentukan port tempat instance SAP HANA Anda menerima kueri. Untuk instance database tenant pertama atau satu-satunya, port-nya adalah 3NN15, dengan NN sebagai nomor instance dari instance SAP HANA.
hana_monitoring_configuration.hana_instances.user	String Tentukan akun pengguna yang digunakan untuk membuat kueri instance SAP HANA. Pastikan pengguna ini memiliki hak istimewa untuk membaca tampilan pemantauan di database SAP HANA Anda. Jika hak istimewa ini tidak diberikan, metrik pemantauan SAP HANA yang terkait dengan tampilan pemantauan tidak akan berisi data.
hana_monitoring_configuration.hana_instances.password	String Opsional. Tentukan sandi, sebagai teks biasa, yang mengautentikasi akun pengguna untuk mengkueri instance SAP HANA. Untuk autentikasi, Anda harus menentukan salah satu hal berikut: Sandi teks biasa untuk parameter password. (Direkomendasikan) Jika menggunakan Secret Manager untuk menyimpan sandi sebagai secret, Anda harus menentukan nama secret yang sesuai pada parameter secret_name. (Direkomendasikan) Kunci hdbuserstore ke parameter hdbuserstore_key. Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter password, yang lebih disukai daripada parameter secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.
hana_monitoring_configuration.hana_instances.secret_name	String Opsional. Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna. Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih disukai daripada parameter password, yang lebih disukai daripada parameter secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.
hana_monitoring_configuration.hana_instances.hdbuserstore_key	String Untuk terhubung dengan aman ke sistem SAP HANA, tentukan kunci Secure user store (hdbuserstore) yang telah Anda buat untuk sistem tersebut. Untuk menggunakan kunci hdbuserstore untuk autentikasi, pastikan hal berikut: Alat SAP hdbsql dan hdbuserstore diinstal di instance compute yang menghosting agen. Kunci hdbuserstore sesuai dengan satu instance SAP HANA tertentu. Anda tidak dapat menggunakan kunci yang berisi nama host beberapa instance SAP HANA. Pengguna SIDadm dapat membuat kueri database SAP HANA menggunakan kunci ini. Di sini, SID mengacu pada nilai yang telah Anda tentukan untuk parameter sid. Anda dapat memverifikasinya dengan menjalankan perintah berikut sebagai pengguna SIDadm: hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY" Parameter konfigurasi ini didukung mulai agen versi 3.3. Jika menentukan hdbuserstore_key, Anda dapat melewati menentukan parameter host dan port.
hana_monitoring_configuration.hana_instances.enable_ssl	Boolean Opsional. Menentukan apakah SSL diaktifkan atau tidak di instance SAP HANA. Nilai defaultnya adalah false.
hana_monitoring_configuration.hana_instances.host_name_in_certificate	String Jika Anda menentukan enable_ssl: true untuk instance SAP HANA, Anda harus menentukan nama host yang ditetapkan dalam sertifikat SSL.
hana_monitoring_configuration.hana_instances.tls_root_ca_file	String Jika Anda menentukan enable_ssl: true untuk instance SAP HANA, Anda harus menentukan jalur untuk sertifikat keamanan Anda.
hana_monitoring_configuration.queries.enabled	Boolean Opsional. Guna mengaktifkan kueri SQL untuk semua instance SAP HANA, tentukan nilai true untuk parameter enabled untuk kueri SQL tersebut.
hana_monitoring_configuration.queries.name	String Jika telah menentukan kueri kustom di file konfigurasi, Anda harus menentukan nama unik untuk setiap kueri kustom. Nama kueri harus unik karena digunakan untuk membuat URL default metrik di Monitoring.
hana_monitoring_configuration.queries.sql	String Tentukan pernyataan SQL yang dikeluarkan agen ke instance SAP HANA Anda. Pernyataan SQL harus sesuai dengan sintaksis SQL yang ditentukan oleh SAP dalam Referensi SQL dan Tampilan Sistem SAP HANA.
hana_monitoring_configuration.queries.sample_interval_sec	Int Opsional. Tentukan interval sampel untuk kueri SQL. Ini akan mengganti interval sampel global. Nilainya harus 5 detik atau lebih lama.
hana_monitoring_configuration.queries.columns.name	String Tentukan nama yang secara unik mengidentifikasi setiap kolom. Nama kolom harus unik karena digunakan untuk membuat URL default metrik di Monitoring.
hana_monitoring_configuration.queries.columns.metric_type	String Untuk penanganan oleh Monitoring, tentukan salah satu jenis metrik berikut: METRIC_LABEL, METRIC_GAUGE, atau METRIC_CUMULATIVE. Metrik jenis METRIC_LABEL ditambahkan sebagai label ke semua metrik METRIC_GAUGE dan METRIC_CUMULATIVE yang dikirim ke Monitoring.
hana_monitoring_configuration.queries.columns.value_type	String Untuk penanganan oleh Monitoring, tentukan jenis data yang didukung oleh jenis metrik. Jenis data yang didukung adalah sebagai berikut: VALUE_BOOL, VALUE_INT64, VALUE_STRING, atau VALUE_DOUBLE. Untuk mengetahui informasi selengkapnya, lihat Kombinasi yang didukung.
hana_monitoring_configuration.queries.columns.name_override	String Opsional. Untuk penanganan oleh Monitoring, tentukan jalur yang Anda ingin tampilkan di URL metrik, bukan nama kueri dan kolom. Contoh: URL default metrik: workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME URL metrik yang menggunakan jalur kustom: workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH

Pemecahan masalah

Untuk mengetahui informasi tentang cara mendiagnosis dan menyelesaikan masalah yang mungkin Anda alami saat menginstal dan mengonfigurasi Agen Google Cloud untuk SAP, lihat Panduan pemecahan masalah Agen Google Cloud untuk SAP.

Mendapatkan dukungan

Jika Anda memerlukan bantuan untuk menyelesaikan masalah dengan Agen Google Cloud untuk SAP, kumpulkan semua informasi diagnostik yang tersedia dan hubungi Cloud Customer Care. Untuk mengetahui informasi tentang cara menghubungi Layanan Pelanggan, lihat Mendapatkan bantuan untuk SAP di Google Cloud.