Agen Google Cloud untuk informasi diagnostik SAP

Untuk masalah yang terkait dengan AgenGoogle Clouduntuk SAP versi 3.8 (terbaru), berikan informasi diagnostik berikut ke Cloud Customer Care sesegera mungkin:

• Deskripsi masalah yang lengkap dan mendetail.
• Paket dukungan untuk agen.
• Data terbaru yang dikumpulkan oleh agen.
• File konfigurasi untuk agen.
• File log untuk agen.

Deskripsi terperinci tentang masalah

Berikan deskripsi masalahnya secara lengkap dan mendetail, termasuk versi agen, serta tanggal dan waktu terjadinya masalah.

Untuk memeriksa versi agen Anda, selesaikan langkah-langkah berikut:

Paket Dukungan

Paket dukungan adalah kumpulan informasi dari Agent for SAP Google Cloud, yang membantu Layanan Pelanggan dalam memberikan dukungan pemecahan masalah kepada Anda. Fitur ini tersedia untuk Agent Google Clouduntuk SAP versi 2.1 atau yang lebih baru.

Dari agen versi 3.4, Anda dapat mengupload output perintah supportbundle menggunakan opsi result-bucket. Untuk melakukannya, Anda perlu memastikan bahwa akun layanan yang digunakan oleh agen memiliki izin IAM berikut: storage.objects.create.

Isi paket dukungan

• File log dan konfigurasi agen.

  Dari agen versi 3.0, ini mencakup log dan file konfigurasi yang terkait dengan fitur Backint dan snapshot disk agen.

• File trace dan topologi SAP HANA untuk nama host dan SID tertentu.

• Agen Backint Cloud Storage untuk log dan file konfigurasi SAP HANA.

• Untuk cluster ketersediaan tinggi (HA) di RHEL, saat Anda menentukan pacemaker-diagnosis="true", output sosreport akan disimpan di direktori berikut: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Jika eksekusi perintah sosreport gagal, output crm_report akan disimpan di direktori yang ditentukan.

• Untuk cluster HA di SUSE, saat Anda menentukan pacemaker-diagnosis=true, output utilitas hb_report dan supportconfig disimpan di direktori berikut: /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP. Jika eksekusi utilitas ini gagal, output hb_report dan crm_report akan disimpan di direktori yang ditentukan.

• File /var/log/messages, yang membantu dengan memberikan informasi berguna tentang operasi sistem Linux Anda.

• Dari agen versi 3.8, file sapdiscovery.json disertakan secara default. File ini berisi informasi tentang produk SAP dan komponen terkait yang berjalan di instance komputasi. Informasi ini memberikan konteks yang lebih baik kepada Layanan Pelanggan tentang peran dan konfigurasi sistem SAP Anda.

  Agar agen dapat mengumpulkan informasi ini, Anda harus memenuhi persyaratan berikut:

  • Tentukan "log_to_cloud": true dalam file konfigurasi agen.
  • Berikan izin IAM logging.logEntries.list ke akun layanan yang digunakan agen.

• Dari agen versi 3.8, saat Anda menentukan opsi metrics, paket akan menyertakan informasi tentang terjadinya peristiwa SAP standar dan perubahan nilai metrik Pemantauan Proses dan metrik Pemantauan SAP HANA untuk jangka waktu tertentu.

  • Agar agen dapat mengumpulkan informasi tentang terjadinya peristiwa SAP standar dari log Cloud Logging, Anda harus memenuhi persyaratan berikut:
    • Tentukan "log_to_cloud": true dalam file konfigurasi agen.
    • Berikan izin IAM logging.logEntries.list ke akun layanan yang digunakan agen.
  • Agar agen dapat mengumpulkan informasi tentang perubahan nilai metrik dari Cloud Monitoring, Anda harus memenuhi persyaratan berikut:
    • Tentukan "send_metrics_to_monitoring": true dalam file konfigurasi agen.
    • Berikan izin IAM berikut ke akun layanan yang digunakan agen: monitoring.metricDescriptors.get, monitoring.metricDescriptors.list, monitoring.monitoredResourceDescriptors.get, monitoring.monitoredResourceDescriptors.list, dan monitoring.timeSeries.list.
  • Periode waktu yang digunakan agen untuk memfilter log Cloud Logging dan entri Cloud Monitoring ditentukan oleh perilaku opsi berikut:
    • timestamp: stempel waktu, dalam format YYYY-MM-DD HH:MM:SS, yang akan digunakan untuk mengumpulkan informasi tentang terjadinya jenis peristiwa SAP yang telah ditentukan sebelumnya dan perubahan nilai metrik. Nilai defaultnya adalah waktu saat Anda menjalankan perintah supportbundle.
    • before-duration: jumlah detik sebelum timestamp selama agen menelusuri kemunculan peristiwa SAP yang telah ditentukan sebelumnya dan perubahan nilai metrik. Nilai default-nya adalah 3.600 detik.
    • after-duration: jumlah detik setelah timestamp selama agen menelusuri terjadinya peristiwa SAP yang telah ditentukan dan perubahan nilai metrik. Nilai default-nya adalah 1.800 detik.

  • Informasi yang dikumpulkan diatur ke dalam folder yang berisi file JSON untuk setiap jenis peristiwa SAP yang terjadi dan setiap metrik yang mengubah nilainya. Berikut adalah contoh tampilan output:

    supportbundle/
    |--- process_metrics/
      |--- pm_sap_control_cpu_utilization.json
      |--- pm_sap_control_memory_utilization.json
    |--- hana_monitoring_metrics/
      |--- hm_sap_hanamonitoring_disk_readtime.json
      |--- hm_sap_hanamonitoring_disk_writetime.json
    |--- sap_events/
      |--- se_HA_Availability.json
      |--- se_HA_Replication.json

Membuat paket dukungan

Untuk membuat paket dukungan untuk instance agen yang berjalan di Linux, jalankan perintah berikut pada instance komputasi Anda:

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

Ganti kode berikut:

• SID: ID sistem SAP Anda.
• INSTANCE_NUMBERS: nomor instance SAP yang ingin Anda buatkan paket dukungannya.

  Untuk menentukan beberapa nomor instance, pisahkan menggunakan spasi. Contoh: 00 11 22 Saat Anda menentukan dua nomor instance SAP atau lebih, perintah tersebut akan menghasilkan satu paket dukungan gabungan untuk instance yang ditentukan.

• HOST_NAME: nama host tempat Anda menjalankan perintah.
• BOOLEAN_VALUE: nilai true atau false, yang menentukan apakah diagnosis terkait Pacemaker dilakukan atau tidak; nilai defaultnya adalah false.
• BUCKET_NAME: nama bucket Cloud Storage tempat Anda ingin mengupload output perintah supportbundle.
• TIMESTAMP: stempel waktu, dalam format YYYY-MM-DD HH:MM:SS, yang digunakan untuk mengumpulkan informasi tentang kemunculan jenis peristiwa SAP yang telah ditetapkan dan perubahan nilai metrik. Nilai defaultnya adalah waktu saat Anda menjalankan perintah supportbundle.
• BEFORE_DURATION: jumlah detik sebelum nilai opsi timestamp selama agen menelusuri kejadian peristiwa SAP yang telah ditentukan sebelumnya dan perubahan nilai metrik. Nilai default-nya adalah 3.600 detik.
• AFTER_DURATION: jumlah detik setelah nilai opsi timestamp selama agen menelusuri terjadinya peristiwa SAP yang telah ditentukan sebelumnya dan perubahan nilai metrik. Nilai default-nya adalah 1.800 detik.

Data terbaru yang dikumpulkan oleh agen

Berikan data terbaru yang dikumpulkan oleh agen. Simpan data terbaru yang dikumpulkan oleh agen ke file dan lampirkan file tersebut ke kasus dukungan Anda.

Untuk melihat data terbaru yang dikumpulkan oleh agen, selesaikan langkah-langkah berikut:

File konfigurasi

Setelah menghapus kredensial seperti nama pengguna dan sandi database SAP HANA, berikan file konfigurasi untuk Agen Google Clouduntuk SAP.

Untuk menemukan file konfigurasi untuk agen, buka jalur berikut:

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

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

File log

Berikan file log untuk Agen Google Clouduntuk SAP.

Untuk menemukan file log agen, buka jalur berikut:

/var/log/google-cloud-sap-agent.log

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log