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

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:

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

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

  1. Di konsol Google Cloud, buka halaman Monitoring:

    Buka Monitoring

  2. Di panel navigasi Monitoring, klik Dasbor.

  3. Klik tab Sample library.

    Tampilan tab library contoh yang dipilih.

  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.

Screenshot menampilkan dasbor kustom untuk metrik SAP HANA di Monitoring