Menginstal dan mengonfigurasi Agen Google Cloud untuk SAP di server Solusi Bare Metal

Agen Google Cloud untuk SAP diperlukan untuk dukungan SAP bagi sistem SAP yang berjalan di server Solusi Bare Metal.

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 informasi tentang sistem operasi yang tersedia untuk menjalankan SAP pada server Solusi Bare Metal, lihat artikel berikut:

Untuk menginstal dan mengonfigurasi aplikasi versi 3.5 (terbaru) Agen Google Cloud untuk SAP di Compute Engine instance VM, lihat Menginstal Agen Google Cloud untuk SAP di instance VM Compute Engine.

Ringkasan penginstalan

Anda 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.

Menginstal agen

Untuk menginstal Agen Google Cloud untuk SAP di server Solusi Bare Metal, ikuti langkah-langkah berikut:

  1. Bangun koneksi SSH ke server Solusi Bare Metal Anda.

  2. Di terminal, instal agen dengan menjalankan perintah khusus untuk sistem operasi Anda:

    • (Direkomendasikan) Untuk menginstal agen versi 3.5 (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 versi agen nomor yang ingin Anda instal, seperti 3.1-606637668. Untuk informasi tentang versi agen yang dapat Anda instal, lihat Cantumkan semua versi agen yang tersedia.

  3. Buka file konfigurasi berikut:

    /etc/google-cloud-sap-agent/configuration.json

    Atau, Anda juga dapat melakukan konfigurasi ini dengan menjalankan perintah. Untuk informasi selengkapnya, lihat Perintah konfigurasi untuk Agen Google Cloud untuk SAP.

  4. Ubah atau tambahkan parameter berikut ke file konfigurasi:

    • Di bagian pertama:
      • bare_metal: tetapkan ke true.
    • Tambahkan bagian cloud_properties dan tentukan parameter berikut:
      • project_id: menentukan project Google Cloud Anda
      • instance_name: menentukan nama server Solusi Bare Metal
      • region: menentukan region server Solusi Bare Metal

  5. Simpan file konfigurasi.

  6. Mulai ulang agen:

    sudo systemctl restart google-cloud-sap-agent
Untuk informasi selengkapnya tentang parameter konfigurasi, lihat Parameter konfigurasi dan contoh konfigurasi.

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

  1. Buat koneksi SSH dengan Server Solusi Bare Metal.

  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

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, secara opsional, Anda dapat mengaktifkan agen dengan menjalankan konfigurasi berikut. Secara {i>default<i}, kumpulan dari Metrik Agen Host SAP dan metrik evaluasi Workload Manager diaktifkan.

Prasyarat

Untuk memungkinkan agen mengakses resource Google Cloud dari Lingkungan Solusi Bare Metal, Anda harus menyelesaikan prasyarat berikut:

Menyiapkan akun layanan

Agar agen dapat mengakses resource Google Cloud dari lingkungan Solusi Bare Metal, Anda harus menyiapkan akun layanan IAM.

Setidaknya, akun layanan yang digunakan agen harus menyertakan peran Workload Manager Insights Writer (roles/workloadmanager.insightWriter).

Untuk membuat akun layanan, ikuti langkah-langkah berikut:

  1. Buat akun layanan:

    1. Di konsol Google Cloud, buka halaman Buat akun layanan.

      Buka Create service account
    2. Pilih project Anda.

    3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.

      Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

    4. Klik Buat dan lanjutkan.

    5. Berikan peran Workload Manager > Workload Manager Insights Writer ke akun layanan.

      Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Workload Manager > Workload Manager Insights Writer.

    6. Klik Lanjutkan.

    7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

      Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.

  2. Membuat kunci akun layanan:

    1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
    2. Klik Kunci.
    3. Klik Tambahkan kunci, lalu klik Buat kunci baru.
    4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
    5. Klik Close.

Setelah membuat akun layanan, pastikan untuk mengupload file kunci JSON-nya ke lokasi yang aman di server Solusi Bare Metal yang dapat diakses oleh agen keamanan.

Aktifkan fitur

Setelah Anda menyiapkan akun layanan untuk Solusi Bare Metal dan memberikan peran yang diperlukan, Anda dapat mengaktifkan fitur lain dari Agen Google Cloud untuk SAP dengan menjalankan konfigurasi berikut:

File konfigurasi default

Cuplikan berikut adalah contoh konfigurasi default Versi 3.5 (terbaru) Agent Google Cloud untuk SAP:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "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 konfigurasi kami untuk fitur tersebut.

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agen Google Cloud untuk SAP yang berjalan di server Solusi Bare Metal, termasuk parameter yang terkait dengan kumpulan 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 menyetel tingkat logging agen, setel nilai yang diperlukan. Level log yang tersedia adalah sebagai berikut:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

Default-nya adalah INFO. Jangan mengubah level {i>logging<i} kecuali 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 VM, secara default, agen akan mendeteksi project ID secara otomatis.
cloud_properties.instance_name

String

Tentukan nama server Solusi Bare Metal yang Anda miliki menginstal agen.
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 VM, secara default, agen menggunakan region instance VM tempat agen diinstal.
cloud_properties.zone

String

Ketika agen berjalan di instance VM, secara default, agen menggunakan zona instance VM tempat agen diinstal.
cloud_properties.image

String

Tentukan nama OS image instance.

Saat agen berjalan di instance VM, secara default, agen mendeteksi OS image dari instance VM tempat agen diinstal.
cloud_properties.numeric_project_id

String

Tentukan ID numerik project Google Cloud tempat sistem SAP berjalan.

Saat agen berjalan di instance VM, secara default, agen mendeteksi project ID numerik secara otomatis.
discovery_configuration.enable_workload_discovery

Boolean

Mengizinkan agen mengumpulkan nama dan versi produk SAP yang berjalan pada host, tentukan true. Nilai defaultnya adalah true.

Untuk informasi selengkapnya, lihat codebase agen di google-cloud-sap-agent repositori GitHub di GoogleCloudPlatform/sapagent.

discovery_configuration.enable_discovery

Boolean

Untuk mengirimkan informasi yang dikumpulkan ke Cloud Logging oleh agen produk SAP yang berjalan di host, tentukan true. Tujuan nilai defaultnya adalah true.

Jika Anda menentukan nilai false, agen akan menyimpan mengumpulkan informasi tentang 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 Anda mengaktifkan pengumpulan metrik Proses untuk SAP HANA, Anda harus siapkan parameter tambahan yang tercantum di hana_metrics_config.
collection_configuration.process_metrics_frequency

Int

Dari versi 2.6, parameter ini menentukan frekuensi pengumpulan metrik Pemantauan Proses 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 yang dipisahkan koma untuk 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.

Alih-alih menentukan {i>password<i} teks biasa, sebaiknya Anda menggunakan salah satu opsi berikut:
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.

Agen mengumpulkan metrik terkait SAP HANA hanya jika Anda menentukan baik hana_db_password_secret_name ,hdbuserstore_key, atau hana_db_password.
collection_configuration.hana_metrics_config.hdbuserstore_key

String

Untuk terhubung ke sistem SAP HANA dengan aman, tentukan Kunci penyimpanan pengguna yang aman (hdbuserstore) yang Anda buat untuk kunci tersebut sistem file.

Untuk menggunakan kunci hdbuserstore untuk autentikasi, pastikan hal berikut:

  • Alat SAP hdbsql dan hdbuserstore diinstal di komputasi yang menghosting agen.
  • Kunci hdbuserstore sesuai dengan satu instance SAP HANA tertentu. Anda tidak dapat menggunakan kunci yang berisi nama {i>host<i} dari beberapa instance SAP HANA.
  • Pengguna SIDadm dapat membuat kueri SAP HANA {i>database <i}menggunakan kunci ini. Di sini SID mengacu pada yang telah Anda tentukan untuk parameter sid. Anda dapat verifikasi dengan menjalankan perintah berikut sebagai SIDadm pengguna: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Parameter konfigurasi ini didukung dari agen versi 3.3.
collection_configuration.hana_metrics_config.sid

String

Tentukan SID instance SAP HANA Anda. Jika menggunakan kunci HANA Userstore, lihat bagian hdbuserstore_key.
collection_configuration.collect_workload_validation_metrics

Boolean

Untuk mengaktifkan pengumpulan metrik evaluasi Workload Manager, menentukan true. Dari versi 3.2, nilai defaultnya adalah true.
Parameter ini hanya berlaku untuk Linux.
collection_configuration.workload_validation_metrics_frequency

Int

Frekuensi pengumpulan Workload Manager metrik evaluasi dalam hitungan detik. Nilai defaultnya adalah 300 detik.

Jika Anda perlu mengubah frekuensi pengumpulan Metrik Workload Manager, lalu tambahkan workload_validation_metrics_frequency di bawah bagian collection_configuration dan berikan nilai yang dibutuhkan.
collection_configuration.workload_validation_collection_definition.fetch_latest_config

Boolean

Opsional. Nilai defaultnya adalah true, yang mengaktifkan agen untuk mengumpulkan rangkaian evaluasi Workload Manager terbaru metrik ini tanpa mengharuskan Anda memperbarui agen. Jika Anda ingin menonaktifkan perilaku ini, kemudian tentukan parameter ini dalam file konfigurasi Anda 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_secret_name

String

Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna.

Atau, Anda dapat menentukan hdbuserstore_key parameter konfigurasi untuk mengotentikasi pengguna SAP HANA yang ditentukan.
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

Untuk terhubung ke sistem SAP HANA dengan aman, tentukan Kunci penyimpanan pengguna yang aman (hdbuserstore) yang Anda buat untuk kunci tersebut sistem file.

Untuk menggunakan kunci hdbuserstore untuk autentikasi, pastikan hal berikut:

  • Alat SAP hdbsql dan hdbuserstore diinstal di komputasi yang menghosting agen.
  • Kunci hdbuserstore sesuai dengan satu instance SAP HANA tertentu. Anda tidak dapat menggunakan kunci yang berisi nama {i>host<i} dari beberapa instance SAP HANA.
  • Pengguna SIDadm dapat membuat kueri SAP HANA {i>database <i}menggunakan kunci ini. Di sini SID mengacu pada yang telah Anda tentukan untuk parameter sid. Anda dapat verifikasi dengan menjalankan perintah berikut sebagai SIDadm pengguna: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Parameter konfigurasi ini didukung dari agen versi 3.3.

Jika Anda menentukan hdbuserstore_key, Anda tidak perlu menetapkan parameter hostname dan port.
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 {i>host<i} adalah komputer jarak jauh, maka tentukan {i>host<i} internal atau alamat IP eksternal.
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 hitungan 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 workload_validation_db_metrics_frequency parameter di bagian collection_configuration dan berikan informasi dengan sejumlah nilai. 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 dalam file konfigurasi dari Agen Google Cloud untuk SAP, 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 proses kueri 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 {i>host<i} adalah komputer jarak jauh, maka tentukan {i>host<i} internal atau alamat IP eksternal.
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 dalam {i>database<i} SAP HANA Anda. Jika hak istimewa ini tidak diberikan, maka SAP Metrik pemantauan HANA yang terkait dengan tampilan pemantauan tidak 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 Anda menggunakan Secret Manager untuk menyimpan {i>password<i} sebagai rahasia, maka Anda harus menentukan nama secret yang sesuai dengan parameter secret_name.
  • (Direkomendasikan) Kunci hdbuserstore ke parameter hdbuserstore_key.
hana_monitoring_configuration.hana_instances.secret_name

String

Opsional. Tentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna.
hana_monitoring_configuration.hana_instances.hdbuserstore_key

String

Untuk terhubung ke sistem SAP HANA dengan aman, tentukan Kunci penyimpanan pengguna yang aman (hdbuserstore) yang Anda buat untuk kunci tersebut sistem file.

Untuk menggunakan kunci hdbuserstore untuk autentikasi, pastikan hal berikut:

  • Alat SAP hdbsql dan hdbuserstore diinstal di komputasi yang menghosting agen.
  • Kunci hdbuserstore sesuai dengan satu instance SAP HANA tertentu. Anda tidak dapat menggunakan kunci yang berisi nama {i>host<i} dari beberapa instance SAP HANA.
  • Pengguna SIDadm dapat membuat kueri SAP HANA {i>database <i}menggunakan kunci ini. Di sini SID mengacu pada yang telah Anda tentukan untuk parameter sid. Anda dapat verifikasi dengan menjalankan perintah berikut sebagai SIDadm pengguna: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Parameter konfigurasi ini didukung dari agen versi 3.3.

Jika menentukan hdbuserstore_key, Anda dapat melewati yang 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 SAP HANA maka Anda harus menentukan nama {i>host<i} yang telah disetel di CA {i>root<i}.
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. Untuk mengaktifkan kueri SQL untuk semua instance SAP HANA Anda, 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 atribut jalur yang ingin ditampilkan dalam URL metrik, bukan nama kolom dan kueri. 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.