Halaman ini diterjemahkan oleh Cloud Translation API.

Versi 2: Mengonfigurasi pengumpulan metrik Pemantauan SAP HANA

Panduan ini menunjukkan cara mengonfigurasi Agen Google Cloud untuk SAP versi 2 guna mengumpulkan metrik pemantauan SAP HANA dari sistem SAP HANA Anda.

Untuk mengetahui informasi tentang fitur ini, lihat Memantau SAP HANA menggunakan Agen Google Cloud untuk SAP.

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 Pemantauan SAP HANA, Anda harus memastikan bahwa akun layanan yang digunakan oleh instance Compute Engine atau server Solusi Bare Metal menyertakan peran berikut:

Compute Viewer (roles/compute.viewer)
Monitoring Metric Writer (roles/monitoring.metricWriter)
Secret Manager Secret Accessor (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:
- Compute Viewer
- Monitoring > Monitoring Metric Writer
- Secret Manager > Secret Manager Secret Accessor
Klik Add atau Save untuk menerapkan peran ke akun layanan.

Mengaktifkan pengumpulan metrik Pemantauan SAP HANA

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

Buat koneksi SSH dengan instance 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 mengetahui informasi tentang parameter konfigurasi, lihat Parameter konfigurasi.
Secara opsional, di bagian cloud_properties, Anda dapat memperbarui nilai parameter yang ditetapkan secara otomatis. Untuk melakukannya, tambahkan bagian cloud_properties ke file konfigurasi, 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 Compute Engine

Contoh berikut adalah file konfigurasi lengkap dari Agen Google Cloud untuk SAP yang berjalan di instance Compute Engine, tempat pengumpulan metrik pemantauan SAP HANA diaktifkan. 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": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_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 Google Cloud untuk SAP yang berjalan di instance Compute Engineserver Solusi Bare Metal, tempat pengumpulan metrik pemantauan SAP HANA diaktifkan. 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,
    "enable_workload_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 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 Agen Google Cloud untuk SAP secara default, atau kueri kustom yang Anda tentukan, Anda dapat menonaktifkan kueri SQL dengan menyelesaikan langkah-langkah berikut:

Buat koneksi SSH dengan instance 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 khusus untuk pengumpulan metrik Monitoring SAP HANA.

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`.
`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 Compute Engine, secara default, agen akan mendeteksi project ID secara otomatis.
`cloud_properties.instance_name`	`String` Jika sistem SAP Anda berjalan di instance Compute Engine, tentukan nama instance komputasi tersebut. Agen secara otomatis mendeteksi nama instance komputasi saat penginstalan. Jika sistem SAP Anda berjalan di server Solusi Bare Metal, tentukan nama server tersebut. Pada agen versi 2.5 atau sebelumnya, 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 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.
`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`.
`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 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`

Melihat metrik yang dikumpulkan

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

Agent untuk SAP - Ringkasan HANA Mendetail: Dasbor ini menyediakan diagram yang menampilkan ringkasan status untuk metrik berikut: Memori instance, memori layanan yang digunakan, estimasi memori maksimum skema, ukuran total memori rowstore, outlier pembacaan skema, outlier penulisan skema, outlier jumlah kumpulan data yang terakhir dikompresi skema, koneksi sistem, pemberitahuan, persentase CPU untuk 5 instance compute teratas, persentase memori untuk 5 instance compute teratas, dan host menurut region.

File JSON untuk dasbor ini adalah agent-for-sap-hana-detailed-overview.json.
Performa Agent untuk SAP - HANA: Dasbor ini menyediakan diagram yang menampilkan nilai metrik mentah untuk metrik berikut: Memori instance, outlier baca dan tulis skema, performa skema, penggunaan memori, outlier jumlah catatan skema, total memori layanan yang digunakan, ukuran memori rowstore, koneksi sistem yang tidak ada aktivitas dan berjalan, koneksi dan memori rowstore, total catatan skema, dan estimasi total ukuran maksimum skema.

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