Versi 1: Panduan operasi Agen untuk SAP dari Google Cloud

Panduan ini membahas pertimbangan dan prosedur operasional untuk menjalankan versi 1 Agen Google Cloud untuk SAP pada instance VM Compute Engine dan server Solusi Bare Metal.

Memahami siklus proses agen

Saat mengelola operasi Agen Google Cloud untuk SAP, sebaiknya pahami dengan baik apa yang dilakukan agen tersebut. Secara umum, berikut cara kerjanya:

Anda harus menginstal Agen Google Cloud untuk SAP di setiap instance VM Compute Engine atau server Solusi Bare Metal yang menghosting sistem SAP. Agen dijalankan sebagai layanan Linux atau layanan Windows.
Pada instance VM Compute Engine, agen menggabungkan data pemantauan dari Monitoring dan Compute Engine API.
Pada server Solusi Bare Metal, hanya untuk pengumpulan metrik Agen Host SAP, agen tersebut tidak mengakses Google Cloud API.
Agen Host SAP melakukan polling Agen Google Cloud untuk SAP atas data yang di-cache, melalui HTTP. Cloud Console menggabungkan metrik Agen Host SAP, melaporkannya, dan menyimpannya di database SAP NetWeaver.
Transaksi SAP ST06 atau antarmuka command line saposcol menampilkan metrik Agen Host SAP gabungan.
Anda dapat melihat metrik Agen Google Cloud untuk SAP untuk SAP dengan menjalankan perintah di jendela terminal.

Pastikan agen sedang berjalan

Setelah menginstal agen atau memulai ulang agen, Anda dapat memverifikasi bahwa agen berjalan seperti yang diharapkan.

Untuk memeriksa apakah agen sedang berjalan, ikuti langkah-langkah berikut:

Linux

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

Jalankan perintah berikut:

systemctl status google-cloud-sap-agent

Jika agen berfungsi dengan baik, output akan berisi active (running). Contoh:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

Gunakan RDP untuk terhubung ke instance VM.
Sebagai administrator, jalankan perintah berikut dari PowerShell:
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
Jika agen berjalan, statusnya akan menampilkan Running.

Jika Agen Google Cloud untuk SAP tidak berjalan, mulai ulang agen.

Memverifikasi bahwa Agen Host SAP menerima metrik

Untuk memverifikasi bahwa metrik infrastruktur dikumpulkan oleh Agen Google Cloud untuk SAP dan dikirim dengan benar ke Agen Host SAP, ikuti langkah-langkah berikut:

Di sistem SAP, masukkan transaksi ST06.
Di panel ringkasan, periksa ketersediaan dan konten kolom berikut untuk penyiapan infrastruktur pemantauan SAP dan Google yang menyeluruh dan benar:
- Penyedia Cloud: Google Cloud Platform
- Akses Pemantauan yang Ditingkatkan: TRUE
- Detail Enhanced Monitoring: ACTIVE

Melihat metrik yang dipantau

Setelah menginstal atau mengupdate konfigurasi Agent for SAP Google Cloud, Anda dapat melihat metrik Agen Host SAP yang dipantau.

Untuk melihat metrik Agen Host SAP yang dipantau, ikuti langkah-langkah berikut:

Linux

Buat koneksi SSH dengan instance VM host Anda dari server Solusi Bare Metal.

Jalankan perintah berikut:

curl http://localhost:18181

Jika metrik tersedia, Anda akan menerima output XML yang berisi informasi tentang sistem Anda. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

Gunakan RDP untuk terhubung ke instance VM.

Sebagai administrator, jalankan perintah berikut dari PowerShell:

(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

Jika metrik tersedia, Anda akan melihat output XML yang berisi informasi tentang sistem Anda. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

Memverifikasi metrik Pemantauan Proses dan metrik evaluasi Workload Manager

Setelah memperbarui konfigurasi, Anda harus memastikan bahwa metrik Pemantauan Proses dan metrik evaluasi Workload Manager tersedia. Anda dapat mengakses metrik dan informasi yang dikumpulkan oleh Agent for SAP Google Cloud di Cloud Monitoring.

Untuk memverifikasi metrik di Monitoring, ikuti langkah-langkah berikut:

Di Konsol Google Cloud, buka halaman Monitoring Metrics Explorer.

Buka Metrics Explorer
Pilih tab Configuration
Luaskan menu Select a metric.
Di menu Resources, pilih VM instance.
Di menu Metric category, pilih sap.
Di menu Metric, pilih metric: workload.googleapis.com/sap/service/active atau salah satu metrik baru yang akan dibuat diagramnya.
Klik Apply.

Anda akan melihat diagram dengan nilai metrik deret waktu.

Memulai ulang agen

Jika Agen Google Cloud untuk SAP berhenti berfungsi atau Anda memperbarui konfigurasinya, mulai ulang agen.

Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:

Linux

Buat koneksi SSH dengan instance VM host Anda.

Jalankan perintah berikut:

sudo systemctl restart google-cloud-sap-agent

Windows

Buat koneksi RDP dengan instance VM host Anda.
Sebagai administrator, jalankan perintah berikut dari PowerShell:
```
Restart-Service -Name 'google-cloud-sap-agent' -Force
```

Upgrade ke Agent for SAP Google Cloud dari agen pemantauan untuk SAP NetWeaver

Menginstal Agent for SAP Google Cloud akan otomatis mendeteksi versi lama agen pemantauan untuk SAP NetWeaver, menonaktifkan agen, lalu menghapus agen tersebut dari server host Anda selama penginstalan.

Jika agen pemantauan untuk SAP NetWeaver terdeteksi dan file konfigurasi yang ada ditemukan selama penginstalan, proses penginstalan akan otomatis memigrasikan konfigurasi yang ada ke Agent for SAP Google Cloud.

Untuk mendapatkan petunjuk cara menginstal dan mengonfigurasi Agent for SAP Google Cloud, baca artikel Memilih panduan penginstalan dan konfigurasi Agent for SAP Google Cloud.

Mengupdate Agen Google Cloud untuk SAP

Bagian ini menjelaskan langkah-langkah untuk memeriksa apakah versi terbaru Agent for SAP Google Cloud tersedia, dan cara mengupdate ke versi 3.2 (terbaru) Agen untuk SAP Google Cloud.

Jika Anda perlu mengupdate ke versi agen yang bukan yang terbaru, hubungi Cloud Customer Care.

Memeriksa update

Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:

RHEL

Buat koneksi SSH dengan instance VM host Anda.

Jalankan perintah berikut:

sudo yum check-update google-cloud-sap-agent

SLES

Buat koneksi SSH dengan instance VM host Anda.

Jalankan perintah berikut:

sudo zypper list-updates -r google-cloud-sap-agent

Windows

Buat koneksi RDP dengan instance VM host Anda.
Sebagai administrator, jalankan perintah berikut dari PowerShell:
```
googet latest google-cloud-sap-agent
```

Menginstal update

Untuk mengupdate instance Agent for SAP Google Cloud ke versi 3.2 (terbaru), pilih sistem operasi Anda, lalu ikuti langkah-langkahnya.

Jika Anda perlu menginstal versi agen yang bukan yang terbaru, hubungi Cloud Customer Care.

RHEL

Buat koneksi SSH dengan instance VM host Anda.

Jalankan perintah berikut:

sudo yum --nogpgcheck update google-cloud-sap-agent

SLES

Buat koneksi SSH dengan instance VM host Anda.

Jalankan perintah berikut:

sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

Buat koneksi RDP dengan instance VM host Anda.
Sebagai administrator, jalankan perintah berikut dari PowerShell:
```
googet install google-cloud-sap-agent
```

Melakukan roll back ke versi sebelumnya

Jika diperlukan, Anda dapat me-roll back Agent for SAP Google Cloud untuk SAP versi 1 ke agen pemantauan untuk SAP NetWeaver versi 2.

Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:

RHEL

Buat koneksi SSH dengan instance VM host Anda.
Jalankan perintah berikut:
```
sudo yum remove google-cloud-sap-agent
```
Instal agen pemantauan untuk SAP NetWeaver versi 2. Untuk mengetahui petunjuk cara menginstal agen pemantauan untuk SAP NetWeaver, lihat Memilih agen pemantauan untuk panduan penginstalan SAP NetWeaver.

SLES

Buat koneksi SSH dengan instance VM host Anda.

Jalankan perintah berikut:

sudo zypper remove google-cloud-sap-agent

Instal agen pemantauan untuk SAP NetWeaver versi 2. Untuk mengetahui petunjuk cara menginstal agen pemantauan untuk SAP NetWeaver, lihat Panduan memilih agen pemantauan untuk SAP NetWeaver.

Windows

Buat koneksi RDP dengan instance VM host Anda.
Sebagai administrator, jalankan perintah berikut dari PowerShell:
```
googet remove google-cloud-sap-agent
```
Instal agen pemantauan untuk SAP NetWeaver versi 2. Untuk mengetahui petunjuk cara menginstal agen pemantauan untuk SAP NetWeaver, lihat Memilih agen pemantauan untuk panduan penginstalan SAP NetWeaver.

Lihat log agen di Cloud Logging

Secara default, log untuk Agen Google Cloud untuk SAP dialihkan dari instance VM dan server Solusi Bare Metal Anda ke Cloud Logging.

Untuk melihat log agen di Logging, ikuti langkah-langkah berikut:

Di Konsol Google Cloud, buka halaman Logs Explorer.

Buka Logs Explorer
Buka panel Query.
Dari menu drop-down Resources, pilih Global, lalu klik Apply.
Di editor kueri, masukkan google-cloud-sap-agent.
Klik Run query.

Anda akan melihat log yang dihasilkan oleh instance agen yang berjalan di semua instance VM atau server Solusi Bare Metal Anda. Untuk memfilter log dari mesin tertentu, gunakan filter yang tersedia di antarmuka.

Anda dapat menonaktifkan pengalihan default log agen ini. Untuk melakukannya, ikuti langkah-langkah berikut:

Buat koneksi SSH dengan instance VM host server Solusi Bare Metal.

Buka file konfigurasi berikut:

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

Untuk parameter log_to_cloud, perbarui nilai menjadi false.
Simpan file konfigurasi.
Mulai ulang agen agar perubahan ini diterapkan.