Versi 2: Mengonfigurasi kumpulan metrik Monitoring SAP HANA

Panduan ini menunjukkan cara mengonfigurasi versi 2 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.

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:

Di konsol Google Cloud, buka halaman IAM.

Buka IAM
Pilih project Google Cloud Anda.
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.
Pilih peran yang diperlukan dari daftar peran yang tersedia:
- Viewer Komputasi
- Monitoring > Monitoring Metric Writer
- Secret Manager > Secret Manager Secret Accessor
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:

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

Buka file konfigurasi agen:

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

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.
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.
Simpan file konfigurasi.
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:

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

Buka file konfigurasi agen:

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

Di bagian hana_monitoring_configuration.queries, tentukan kueri kustom Anda.

Untuk informasi tentang cara menentukan kueri kustom dan melihat contohnya, lihat Menentukan kueri kustom.
Untuk mengaktifkan kueri kustom, tetapkan parameter enabled ke true.
Simpan file konfigurasi.
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:

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

Buka file konfigurasi agen:

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

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.
Untuk menonaktifkan kueri kustom, tetapkan parameter enabled ke false untuk kueri kustom tersebut.
Simpan file konfigurasi.
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`.
`sap_system_discovery`	`Boolean` Untuk mengaktifkan penemuan sistem SAP, tentukan `true`. Default-nya 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. Pada agen versi 2.5 atau yang lebih lama, tentukan nama server Solusi Bare Metal untuk properti `instance_id`.
`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.
`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

Di konsol Google Cloud, buka halaman Monitoring:

Buka Monitoring
Di panel navigasi Monitoring, klik Dasbor.
Klik tab Sample library.
Untuk memfilter dasbor kustom khusus agen, di kolom Filter, ketik Agent for SAP.
(Opsional) Untuk melihat detail tentang dasbor atau mempratinjau kontennya, klik Pratinjau.
Pilih dasbor yang ingin Anda instal.
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

Buka Cloud Shell:

Buka Cloud Shell

Di Cloud Shell, clone atau download repositori:

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

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:

Di konsol Google Cloud, buka halaman Monitoring:

Buka Monitoring
Di panel navigasi Monitoring, klik Dasbor.
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.

Screenshot menampilkan dasbor kustom untuk metrik SAP HANA
di Monitoring