Mengonfigurasi pengumpulan metrik SAP HANA Monitoring

Version 3.2 (latest)

• Versi 3.2 (latest)
• Versi 2
• Versi 1

Panduan ini menunjukkan cara mengonfigurasi Agent for SAP Google Cloud untuk mengumpulkan metrik pemantauan SAP HANA dari sistem SAP HANA Anda.

Untuk mengetahui informasi tentang fitur ini, lihat Memantau SAP HANA menggunakan Agent for SAP dari Google Cloud.

Catatan: Pengumpulan metrik pemantauan SAP HANA hanya didukung di Linux. Fitur ini tidak didukung di Windows.

Sebelum memulai

• Validasi penginstalan Agen Google Cloud untuk SAP. Untuk mengetahui petunjuknya, lihat panduan penginstalan untuk skenario Anda.
• Jika Anda telah menginstal agen di server Solusi Bare Metal, pastikan Anda telah menyelesaikan prasyarat yang diperlukan dan menyiapkan akun layanan. Untuk mengetahui petunjuknya, lihat Mengonfigurasi Agen Google Cloud untuk SAP di Linux.

Menetapkan peran IAM

Agar Agen Google Cloud untuk SAP dapat mengumpulkan metrik SAP HANA Monitoring, Anda harus memastikan bahwa akun layanan yang digunakan oleh instance VM Compute Engine atau server Solusi Bare Metal mencakup peran berikut:

• Compute Viewer (roles/compute.viewer)
• Monitoring Metric Writer (roles/monitoring.metricWriter)
• Aksesor Rahasia Secret Manager (roles/secretmanager.secretAccessor), jika Anda menggunakan Secret Manager untuk menyimpan sandi database SAP HANA.

Untuk menambahkan peran yang diperlukan ini 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:

   • Viewer Komputasi
   • Monitoring > Monitoring Metric Writer
   • Secret Manager > Secret Manager Secret Accessor

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

Aktifkan pengumpulan metrik SAP HANA Monitoring

Untuk mengaktifkan pengumpulan metrik Pemantauan SAP HANA menggunakan Agent for SAP Google Cloud, ikuti langkah-langkah berikut:

1. Buat koneksi SSH dengan instance VM Compute Engine atau server Solusi Bare Metal.

2. Buka file konfigurasi agen:

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

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

3. Di bagian hana_monitoring_configuration, lakukan hal berikut:

   • Untuk parameter enabled, tetapkan nilai true.
   • Di bagian hana_instances, tentukan instance SAP HANA yang Anda ingin dipantau oleh agen.
   • (Opsional) Tentukan kueri kustom. Untuk informasi tentang cara menentukan kueri kustom dan melihat contohnya, lihat Menentukan kueri kustom.

   • (Opsional) Nonaktifkan kueri bawaan atau default. Untuk mengetahui petunjuknya, lihat Menonaktifkan kueri SQL.

     Untuk informasi tentang parameter konfigurasi, lihat Parameter konfigurasi.

4. Secara opsional, di bagian cloud_properties, Anda dapat memperbarui parameter value yang ditetapkan secara otomatis. Untuk melakukannya, tambahkan bagian cloud_properties ke file konfigurasi Anda, lalu tentukan parameter yang diperlukan dan nilainya.

5. Simpan file konfigurasi.

6. Mulai ulang agen agar setelan baru diterapkan:

   sudo systemctl restart google-cloud-sap-agent

Contoh file konfigurasi

Instance VM Compute Engine

Contoh berikut adalah file konfigurasi lengkap dari Agen untuk SAP Google Cloud yang berjalan di instance VM Compute Engine, yang mengaktifkan pengumpulan metrik pemantauan SAP HANA. Perhatikan bahwa kueri kustom yang disertakan dalam contoh ini, yang bernama custom_query, mengikuti panduan definisi kueri kustom yang ditentukan dalam Menentukan kueri kustom.

{
  "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
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": true,
    "sample_interval_sec": 60,
    "query_timeout_sec": 30,
    "execution_threads": 20,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "host": "10.123.0.12",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      }
    ],
    "queries": [
      {
        "name": "custom_query",
        "enabled": true,
        "sql": "SELECT * FROM MyTable;",
        "columns": [
          {
            "name": "string",
            "metric_type": "METRIC_LABEL",
            "value_type": "VALUE_STRING"
          },
          {
            "name": "bool",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_BOOL"
          },
          {
            "name": "int",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_INT64"
          },
          {
            "name": "double",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_DOUBLE"
          }
        ]
      },
      {
        "name": "default_host_queries",
        "enabled": false
      }
    ]
  }
}

Server Solusi Bare Metal

Contoh berikut adalah file konfigurasi lengkap dari Agen untuk SAP Google Cloud yang berjalan di server Solusi Bare Metal, yang mengaktifkan pengumpulan metrik pemantauan SAP HANA. Perhatikan bahwa kueri kustom yang disertakan dalam contoh ini, yang bernama custom_query, mengikuti panduan definisi kueri kustom yang ditentukan dalam Menentukan kueri kustom.

{
  "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
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": true,
    "sample_interval_sec": 60,
    "query_timeout_sec": 30,
    "execution_threads": 20,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
      {
        "name": "remote",
        "sid": "DEH",
        "host": "10.123.0.12",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      }
    ],
    "queries": [
      {
        "name": "custom_query",
        "enabled": true,
        "sql": "SELECT * FROM MyTable;",
        "columns": [
          {
            "name": "string",
            "metric_type": "METRIC_LABEL",
            "value_type": "VALUE_STRING"
          },
          {
            "name": "bool",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_BOOL"
          },
          {
            "name": "int",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_INT64"
          },
          {
            "name": "double",
            "metric_type": "METRIC_GAUGE",
            "value_type": "VALUE_DOUBLE"
          }
        ]
      },
      {
        "name": "default_host_queries",
        "enabled": false
      }
    ]
  }
}

Menentukan kueri SQL kustom

Agent for SAP Google Cloud mengumpulkan metrik pemantauan SAP HANA dengan menjalankan kueri SQL di instance SAP HANA Anda. Selain kueri default ini, Anda dapat menentukan dan menjalankan kueri SQL kustom dengan menyelesaikan langkah-langkah berikut:

1. Buat koneksi SSH dengan instance VM Compute Engine atau server Solusi Bare Metal.

2. Buka file konfigurasi agen:

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

3. Di bagian hana_monitoring_configuration.queries, tentukan kueri kustom Anda.

   Untuk informasi tentang cara menentukan kueri kustom dan melihat contohnya, lihat Menentukan kueri kustom.

4. Untuk mengaktifkan kueri kustom, tetapkan parameter enabled ke true.

5. Simpan file konfigurasi.

6. Mulai ulang agen agar setelan baru diterapkan:

   sudo systemctl restart google-cloud-sap-agent

Menonaktifkan kueri SQL

Jika tidak ingin menjalankan kueri SQL bawaan yang disediakan oleh Agent for SAP Google Cloud secara default, atau kueri kustom apa pun yang Anda tentukan, Anda dapat menonaktifkan kueri SQL dengan menyelesaikan langkah-langkah berikut:

1. Buat koneksi SSH dengan instance VM Compute Engine atau server Solusi Bare Metal.

2. Buka file konfigurasi agen:

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

3. Untuk menonaktifkan kueri bawaan atau default, sertakan baris berikut di bagian hana_monitoring_configuration.queries:

   {
   "name": "default_QUERY_NAME",
   "enabled": false
   }

   Ganti QUERY_NAME dengan nama kueri default. Untuk mengetahui informasi tentang kueri default, lihat Referensi kueri default.

4. Untuk menonaktifkan kueri kustom, tetapkan parameter enabled ke false untuk kueri kustom tersebut.

5. Simpan file konfigurasi.

6. Mulai ulang agen agar setelan baru diterapkan:

   sudo systemctl restart google-cloud-sap-agent

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agent for SAP Google Cloud yang spesifik untuk pengumpulan metrik SAP HANA Monitoring.

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 tingkat logging agen, tetapkan nilai yang diperlukan. Tingkat 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 VM, secara default, agen akan mendeteksi project ID secara otomatis.
cloud_properties.instance_name	String Jika sistem SAP Anda berjalan pada instance VM Compute Engine, tentukan nama instance VM tersebut. Agen secara otomatis mendeteksi nama instance VM saat penginstalan. Jika sistem SAP Anda berjalan di server Solusi Bare Metal, tentukan nama server tersebut.
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 Agar agen dapat mengumpulkan nama dan versi produk SAP yang berjalan di host, tentukan true. Nilai defaultnya adalah true. Untuk informasi selengkapnya, lihat codebase agen di repositori GitHub google-cloud-sap-agent di bagian GoogleCloudPlatform/sapagent.
discovery_configuration.enable_discovery	Boolean Untuk mengirimkan 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.
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 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 mesin 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.
hana_monitoring_configuration.hana_instances.password	String Opsional. Tentukan sandi, sebagai teks biasa, yang mengautentikasi akun pengguna untuk mengkueri instance SAP HANA. Untuk mengaktifkan autentikasi, Anda harus menentukan salah satu hal berikut: Sandi teks biasa untuk parameter password. (Direkomendasikan) Jika menggunakan Secret Manager untuk menyimpan sandi sebagai rahasia, Anda harus menetapkan nama secret yang sesuai dengan parameter secret_name. Jika Anda menggunakan kedua parameter tersebut, parameter password akan digunakan.
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.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 menentukan enable_ssl: true untuk instance SAP HANA, Anda harus menentukan nama host yang ditetapkan di 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. Agar dapat 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 menangani melalui Monitoring, tentukan jalur yang ingin ditampilkan 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

Melihat metrik yang dikumpulkan

Untuk memvisualisasikan metrik Monitoring SAP HANA yang dikumpulkan agen, Anda dapat menggunakan dasbor kustom berikut yang disediakan Google Cloud:

• Agent for SAP - Ringkasan HANA Mendetail: Dasbor ini menyediakan diagram yang menampilkan ringkasan status untuk metrik berikut: Memori instance, memori layanan yang digunakan, perkiraan memori maksimum skema, ukuran total memori rowstore, pencilan pembacaan skema, pencilan penulisan skema, pencilan jumlah catatan terkompresi skema terakhir, koneksi sistem, pemberitahuan, persentase CPU untuk 5 VM teratas, persentase memori untuk 5 VM teratas, dan host.

  File JSON untuk dasbor ini adalah agent-for-sap-hana-detailed-overview.json.

• Agent for SAP - HANA performance: Dasbor ini menyediakan diagram yang menampilkan nilai metrik mentah untuk metrik berikut: Memori instance, pencilan pembacaan dan penulisan skema, performa skema, penggunaan memori, pencilan jumlah catatan skema, total memori layanan yang digunakan, ukuran memori rowstore, koneksi tidak ada aktivitas dan berjalan, memori koneksi dan rowstore, catatan total skema, dan estimasi total ukuran total maksimum.

  File JSON untuk dasbor ini adalah agent-for-sap-hana-performance.json.

Menginstal dasbor

Untuk menginstal dasbor kustom, selesaikan langkah-langkah berikut:

Konsol Google Cloud

1. Di konsol Google Cloud, buka halaman Monitoring:

   Buka Monitoring

2. Di panel navigasi Monitoring, klik Dasbor.

3. Klik tab Sample library.

   

4. Untuk memfilter dasbor kustom khusus agen, di kolom Filter, ketik Agent for SAP.

5. (Opsional) Untuk melihat detail tentang dasbor atau mempratinjau kontennya, klik Pratinjau.

6. Pilih dasbor yang ingin Anda instal.

7. Klik Impor, lalu klik Konfirmasi.

   Dasbor akan ditambahkan ke dasbor yang tersedia di project Google Cloud Anda. Untuk melihat dasbor Anda, ikuti petunjuk dalam artikel Melihat dasbor yang terinstal.

Google Cloud CLI

1. Buka Cloud Shell:

   Buka Cloud Shell

2. Di Cloud Shell, clone atau download repositori:

   git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

3. Di Cloud Shell, instal dasbor yang diperlukan menggunakan file JSON yang sesuai:

   gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

   Ganti CONFIG_FROM_FILE dengan jalur ke file JSON yang berisi konfigurasi dasbor. File konfigurasi dasbor dapat ditemukan di jalur: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

   Dasbor akan ditambahkan ke dasbor yang tersedia di project Google Cloud Anda. Untuk melihat dasbor Anda, ikuti petunjuk di Melihat dasbor yang terinstal.

Melihat dasbor yang terinstal

Untuk melihat dasbor yang terinstal, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Monitoring:

   Buka Monitoring

2. Di panel navigasi Monitoring, klik Dasbor.

3. Klik nama dasbor dalam daftar.

Jika memiliki banyak dasbor, Anda dapat memfilter dasbor kustom atau untuk nama dasbor baru. Untuk informasi tentang cara memfilter daftar ini, lihat Melihat dasbor kustom.

Gambar berikut adalah contoh yang menunjukkan bagian dasbor kustom untuk metrik SAP HANA dalam Monitoring.