本指南說明在 Compute Engine 執行個體和 Bare Metal 解決方案伺服器上,執行 Google Cloud的 Agent for SAP 3.8 版 (最新版)時的作業考量和程序。
瞭解代理程式生命週期
管理 Google Cloud的 SAP 代理程式作業時,瞭解代理程式的運作方式很有幫助。一般而言,監控代理程式的運作方式如下:
- 您必須在每個代管 SAP 系統的 Compute Engine 執行個體或 Bare Metal 解決方案伺服器上安裝 Google Cloud的 Agent for SAP。代理程式會以 Linux 服務或 Windows 服務執行。
- 在 Compute Engine 執行個體上,代理程式會結合來自 Monitoring 和 Compute Engine API 的監控資料。
- 在 Bare Metal 解決方案伺服器上,如果只收集 SAP Host Agent 指標,代理程式就不會存取 Google Cloud API。
- 透過 HTTP,SAP Host Agent 會輪詢 Google Cloud的 Agent for SAP,取得快取資料。此代理程式會匯總 SAP Host Agent 指標、回報這些指標,並將指標儲存在 SAP NetWeaver 資料庫中。
- SAP 交易
ST06
或saposcol
指令列介面會顯示匯總的 SAP Host Agent 指標。 - 您可以在終端機視窗中執行指令,查看 Google Cloud的 Agent for SAP 中的 SAP Host Agent 指標。
確認代理程式是否正在執行
安裝或重新啟動代理程式後,您可以確認代理程式是否正常運作。
如要確認代理程式是否正在執行,請按照下列步驟操作:
Linux
建立與 Bare Metal 解決方案伺服器或 Compute Engine 執行個體的 SSH 連線。
執行下列指令:
systemctl status google-cloud-sap-agent
如果代理程式運作正常,輸出內容就會包含
active (running)
。例如: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
使用遠端桌面協定連線至 Compute Engine 執行個體。
以管理員身分在 PowerShell 中執行下列指令:
如果代理程式正在執行,狀態會顯示$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
Running
。
如果 Google Cloud的 Agent for SAP 未執行,請重新啟動代理程式。
檢查代理程式版本
安裝或重新啟動 Google Cloud的 SAP 代理程式後,您可以查看代理程式的版本。
如要查看代理程式版本,請完成下列步驟:
Linux
如果是 RHEL,請按照下列步驟操作:
- 使用 SSH 連線至主機 Compute Engine 執行個體或 Bare Metal Solution 伺服器。
- 請執行下列指令:
yum info google-cloud-sap-agent
如為 SLES,請按照下列步驟操作:
- 使用 SSH 連線至主機 Compute Engine 執行個體或 Bare Metal Solution 伺服器。
- 請執行下列指令:
zypper info google-cloud-sap-agent
Windows
- 使用 RDP 連線至主機 Compute Engine 執行個體或裸機解決方案伺服器。
- 以管理員身分在 PowerShell 中執行下列指令:
googet installed google-cloud-sap-agent
列出代理的所有可用版本
如要列出 Google Cloud的 Agent for SAP 的所有可用版本,請按照下列步驟操作:
RHEL
與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器建立 SSH 連線。
執行下列指令:
sudo yum list --showduplicates google-cloud-sap-agent
SLES
與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器建立 SSH 連線。
執行下列指令:
sudo zypper search -s -t package -r google-cloud-sap-agent google-cloud-sap-agent
確認 SAP Host Agent 正在接收指標
如要確認Google Cloud的 Agent for SAP 是否收集基礎架構指標,並正確傳送至 SAP Host Agent,請按照下列步驟操作:
- 在 SAP 系統中輸入交易
ST06
。 在「Overview」(總覽) 窗格中,查看以下欄位的可用性和內容,確認 SAP 和 Google 監控基礎架構已做好正確的端對端設定:
- 雲端服務供應商:
Google Cloud Platform
- Enhanced Monitoring Access (強化版監控功能存取權):
TRUE
- Enhanced Monitoring Details (強化版監控功能詳細資料):
ACTIVE
- 雲端服務供應商:
查看 SAP Host Agent 指標
安裝或更新 Google Cloud的 Agent for SAP 設定後,您就可以查看收集到的 SAP 主機代理程式指標。
如要查看 Google Cloud的 SAP 代理程式收集的 SAP Host Agent 指標,請按照下列步驟操作:
Linux
與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器建立 SSH 連線。
執行下列指令:
curl http://localhost:18181
如果指標可用,您應該會收到 XML 輸出內容,其中包含系統相關資訊。例如:
<?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
使用遠端桌面協定連線至 Compute Engine 執行個體。
以管理員身分在 PowerShell 中執行下列指令:
(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent
如果指標可用,您應該會看到 XML 輸出內容,其中包含系統相關資訊。例如:
<?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>
查看其他指標
更新 Google Cloud的 SAP 代理程式設定以收集 Process Monitoring 指標或 SAP HANA 監控指標後,建議您查看這些指標,確認代理程式是否如預期收集指標。
如要在 Cloud Monitoring 中查看 Google Cloud的 SAP 專用代理程式收集的指標和資訊,請完成下列步驟:
前往 Google Cloud 控制台的「Monitoring Metrics Explorer」頁面。
選取「Configuration」分頁。
展開「Select a metric」選單。
在「Resources」選單中,選取「VM instance」。
在「指標類別」選單中,選取「sap」。
在「指標」選單中,選取
metric: workload.googleapis.com/sap/service/active
或任何要納入圖表的新指標。按一下 [套用]。
您應該會看到含有時間序列指標值的圖表。
重新啟動代理程式
在 3.6 版之前,如果代理程式停止運作或您更新其設定,就必須重新啟動代理程式。
自 3.7 版起,您無須重新啟動代理程式即可更新設定,因為代理程式會在接下來 30 秒內自動挑選變更。
如要手動重新啟動代理程式,請選取作業系統,然後按照下列步驟操作:
Linux
與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器建立 SSH 連線。
請執行下列指令:
sudo systemctl restart google-cloud-sap-agent
Windows
與主機主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器建立 RDP 連線。
以管理員身分在 PowerShell 中執行下列指令:
Restart-Service -Name 'google-cloud-sap-agent' -Force
停用或啟用代理程式
為確保監控功能正常運作,運算執行個體中的 Google Cloud代理程式 (適用於 SAP) 的 systemd
服務必須隨時運作。不過,如果您需要在 Linux 基礎運算執行個體上停用或停止代理程式,請執行下列指令:
sudo /usr/bin/google_cloud_sap_agent service -disable
如要在 Linux 架構的運算子機器執行個體上啟用及啟動代理程式的 systemd
服務,請按照下列步驟操作:
sudo /usr/bin/google_cloud_sap_agent service -enable
在 Linux 上停用或啟用代理程式的 systemd
服務時,系統會將該動作記錄在以下檔案中:/var/log/google-cloud-sap-agent/service.log
。
從其他 Google Cloud 代理程式升級至 Google Cloud的 Agent for SAP
Google Cloud的 Agent for SAP 是其他Google Cloud 代理程式的後繼者。以下各節將說明如何從這些代理程式升級至Google Cloud的 Agent for SAP 3.8 版 (最新版)。
如需安裝及設定 Google Cloud的 Agent for SAP 的操作說明,請參閱「選擇 Google Cloud的 Agent for SAP 安裝和設定指南」。
從 SAP HANA 適用的 Cloud Storage Backint 代理程式升級
如要從 SAP HANA 適用的 Cloud Storage Backint 代理程式升級至 3.8 版 (最新版),請完成下列步驟:
請確認在升級期間,沒有任何資料備份正在進行或排程。
將 SAP HANA 參數
enable_auto_log_backup
設為no
,即可停用自動記錄備份功能。如需操作說明,請參閱 SAP HANA 文件「啟用及停用自動記錄備份功能」。安裝 Google Cloud的 Agent for SAP。如需操作說明,請參閱適用於您情況的安裝指南。
啟用 Google Cloud的 Agent for SAP 的 Backint 功能。如需操作說明,請參閱「設定以 Backint 為基礎的備份與復原功能」。
啟用 Google Cloud的 SAP 代理程式 Backint 功能,會自動偵測主機上的 Backint 代理程式,並在主機機器上停用該代理程式。
如要建立現有 Backint 設定文字檔的 JSON 版本,請針對每個文字檔執行下列指令:
/usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE
將
PATH_TO_PARAMETERS_FILE
替換為PARAMETERS.txt
檔案的路徑。只要 Google Cloud的 SAP 代理程式具備存取這些位置的權限,JSON 檔案就會在檔案系統中與文字檔案相同的位置建立。雖然 Google Cloud的 SAP 服務代理可解讀文字檔案中指定的 Backint 相關參數,但建議您使用 JSON 檔案更新任何設定。
將 SAP HANA 參數
enable_auto_log_backup
參數設為yes
,啟用自動記錄備份功能。如需操作說明,請參閱 SAP HANA 文件「啟用及停用自動記錄備份功能」。
執行這項升級作業時,會發生下列情況:
- 為了備份和參考,Backint 代理程式
backint-gcs
目錄中的所有安裝檔案都會複製到backint-gcs-old-TIMESTAMP/
。萬一您需要改回使用 Backint 代理程式,就必須使用這些值。 - 接著,
backint-gcs
資料夾會清除,只保留執行 Google Cloud的 Agent for SAP 所需的檔案,包括設定檔parameters.json
和PARAMETERS.txt
等 Backint 設定檔。
如要瞭解 Backint 代理程式和 Google Cloud的 Agent for SAP 之間的設定參數對應關係,請展開下列章節。
設定參數對應
Backint 代理程式中的參數名稱 | Google Cloud的 Agent for SAP 中的參數名稱 |
---|---|
BUCKET |
bucket |
DISABLE_COMPRESSION |
compress |
ENCRYPTION_KEY |
encryption_key |
KMS_KEY_NAME |
kms_key |
MAX_GCS_RETRY |
retries |
PARALLEL_FACTOR |
parallel_streams |
PARALLEL_PART_SIZE |
Google Cloud的 Agent for SAP 不支援這項功能。 |
RATE_LIMIT_MB |
rate_limit_mb |
SERVICE_ACCOUNT |
service_account_key |
THREADS |
thread |
READ_IDLE_TIMEOUT |
file_read_timeout_ms |
CHUNK_SIZE_MB |
buffer_size_mb |
HTTP_READ_TIMEOUT |
Google Cloud的 Agent for SAP 不支援這項功能。 |
從 SAP HANA 監控代理程式升級
安裝 Google Cloud的 SAP 代理程式 3.8 版 (最新版) 時,系統會自動偵測 SAP HANA 監控代理程式的版本,並在安裝期間停用及從主機機器中移除這些代理程式。
如果偵測到這個代理程式,系統會在安裝期間將其設定遷移至Google Cloud的 Agent for SAP。為備份和參考用途,SAP HANA 監控代理程式的設定會複製到下列檔案:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
升級支援安全資料傳輸層 (SSL) 的執行個體
如果您已將 SAP HANA 監控代理程式設定為使用 SSL 憑證與 SAP HANA 執行個體通訊,那麼在您安裝 Google Cloud的 SAP 代理程式時,SSL 設定以外的所有 SAP HANA 監控設定都會遷移至 Google Cloud的 SAP 代理程式。在這種情況下,如要使用 Google Cloud的 Agent for SAP 監控 SAP HANA 執行個體,您必須完成下列步驟:
建立與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器的 SSH 連線。
開啟 Google Cloud的 Agent for SAP 設定檔:
/etc/google-cloud-sap-agent/configuration.json
在
hana_monitoring_configuration
部分中,將enabled
參數設為true
。在
hana_monitoring_configuration.hana_instances
部分,針對每個使用 TLS/SSL 通訊協定進行安全通訊的 SAP HANA 執行個體,執行下列操作:指定參數
enable_ssl
,並將其值設為true
。指定參數
host_name_in_certificate
,並將 TLS/SSL 憑證中指定的 SAP HANA 主機名稱設為其值。指定
tls_root_ca_file
參數,並將 TLS/SSL 憑證的儲存路徑設為其值。
儲存設定檔。
重新啟動代理程式,讓新設定生效:
sudo systemctl restart google-cloud-sap-agent
確認代理程式是否正在收集 SAP HANA 監控指標。如需操作說明,請參閱「查看其他指標」一節。
解除安裝 SAP HANA 的監控代理程式。
如果在升級後遇到任何 SAP HANA 執行個體連線問題,您可以在「Logging」中查看代理程式記錄,並使用疑難排解指南解決問題。
從 SAP NetWeaver 監控代理程式升級
安裝 Google Cloud的 Agent for SAP 3.8 版 (最新版) 時,系統會自動偵測 SAP NetWeaver 監控代理程式的版本。
如果偵測到這個代理程式,系統會在安裝期間將其設定遷移至Google Cloud的 Agent for SAP。
更新 Google Cloud的 Agent for SAP
為確保您使用的是 Google Cloud的最新版 SAP 服務代理,請定期檢查更新並更新服務代理。
檢查更新
請選取作業系統,然後按照下列步驟操作:
RHEL
- 建立與執行個體的 SSH 連線。
- 執行下列指令:
sudo yum check-update google-cloud-sap-agent
SLES
- 建立與執行個體的 SSH 連線。
- 執行下列指令:
sudo zypper list-updates -r google-cloud-sap-agent
Windows
- 與主機 Compute Engine 執行個體建立 RDP 連線。
- 以管理員身分在 PowerShell 中執行下列指令:
googet latest google-cloud-sap-agent
安裝更新
請選取作業系統,然後按照步驟操作:
RHEL
- 建立與執行個體的 SSH 連線。
- 更新代理程式執行個體:
- (建議) 如要更新至代理程式的 3.8 版 (最新版):
sudo yum --nogpgcheck update google-cloud-sap-agent
- 如何更新為特定版本的代理程式:
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64
將
VERSION_NUMBER
替換為要安裝的代理程式版本號碼,例如3.1-606637668
。如要瞭解可安裝的代理程式版本,請參閱「列出所有可用的代理程式版本」。
- (建議) 如要更新至代理程式的 3.8 版 (最新版):
SLES
- 建立與執行個體的 SSH 連線。
- 更新代理程式執行個體:
- (建議) 如要更新至代理程式的 3.8 版 (最新版):
sudo zypper --no-gpg-checks update google-cloud-sap-agent
- 如何更新為特定版本的代理程式:
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
將
VERSION_NUMBER
替換為要安裝的代理程式版本號碼,例如3.1-606637668
。如要瞭解可安裝的代理程式版本,請參閱「列出所有可用的代理程式版本」。
- (建議) 如要更新至代理程式的 3.8 版 (最新版):
Windows
- 與主機 Compute Engine 執行個體建立 RDP 連線。
- 如要更新至 3.8 版 (最新版) 的代理程式,請以管理員身分在 PowerShell 中執行下列指令:
googet install google-cloud-sap-agent
降級 Google Cloud的 Agent for SAP
雖然我們建議您一律使用Google Cloud的最新版 SAP 代理程式,但您也可以執行下列指令,將最新版本降級為任何支援的代理程式版本:
RHEL
sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM [google-cloud-sap-agent] name=Google Cloud Agent for SAP baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM sudo yum downgrade google-cloud-sap-agent-VERSION_NUMBER.x86_64
SLES15
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
SLES 12
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
將 VERSION_NUMBER
替換為要安裝的代理程式版本號碼,例如 3.1-606637668
。如要瞭解可安裝的代理程式版本,請參閱「列出所有可用的代理程式版本」。
改回使用其他 Google Cloud 代理程式
本節提供有關從使用 Google Cloud的 Agent for SAP 3.8 版 (最新版) 回溯至使用其前代代理程式相關資訊。
改回使用 Backint 代理程式
如果您想恢復使用 Backint 代理程式,並停止使用 Google Cloud的 Agent for SAP 的 Backint 功能,請按照下列步驟操作:
刪除與 Google Cloud的 SAP 代理程式相關的所有 Backint 功能檔案:
rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
將
SID
替換為 SAP 系統的 SID。將 Backint 代理程式檔案複製到
backint-gcs
目錄,還原在升級至使用 Google Cloud的 SAP 代理程式時儲存為備份的檔案:cp -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs-old-TIMESTAMP /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
更改下列內容:
SID
:SAP 系統的 SIDTIMESTAMP
:從 Backint 代理程式升級至Google Cloud的 Agent for SAP 時,建立的資料夾名稱中的時間戳記值
使用 SAP HANA Studio 或 SAP HANA Cockpit 編輯
global.ini
檔案,並更新.txt
設定檔的路徑。如要瞭解必須指定.txt
檔案路徑的參數,請參閱「為 Backint 功能設定 SAP HANA」。儲存對
global.ini
檔案所做的變更。
改回使用 SAP HANA 監控代理程式
如果您想改回使用 SAP HANA 監控代理程式,並停止使用 Google Cloud的 Agent for SAP 提供的 SAP HANA 監控功能,請按照下列步驟操作:
RHEL
建立與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器的 SSH 連線。
為避免收集重複的指標,請停用Google Cloud的 SAP 代理程式收集 SAP HANA 監控指標的功能:
開啟 Google Cloud的 Agent for SAP 設定檔:
/etc/google-cloud-sap-agent/configuration.json
在
hana_monitoring_configuration
部分,將參數enabled
設為false
。儲存設定檔。
重新啟動代理程式,讓新設定生效:
sudo systemctl restart google-cloud-sap-agent
從下列檔案複製 SAP HANA 監控代理程式的設定:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
安裝 SAP HANA 2 版的監控代理程式。如需安裝操作說明,請參閱 SAP HANA 監控代理程式 V2.0 安裝與操作指南。
在下列檔案中,貼上您在上一個步驟中複製的 SAP HANA 監控代理程式設定:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
重新啟動 SAP HANA 的監控代理程式:
sudo systemctl start google-saphanamonitoring-agent
SLES
建立與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器的 SSH 連線。
為避免收集重複的指標,請停用Google Cloud的 SAP 代理程式收集 SAP HANA 監控指標的功能:
開啟 Google Cloud的 Agent for SAP 設定檔:
/etc/google-cloud-sap-agent/configuration.json
在
hana_monitoring_configuration
部分,將參數enabled
設為false
。儲存設定檔。
重新啟動代理程式,讓新設定生效:
sudo systemctl restart google-cloud-sap-agent
從下列檔案複製 SAP HANA 監控代理程式的設定:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
安裝 SAP HANA 2 版的監控代理程式。如需安裝操作說明,請參閱 SAP HANA 監控代理程式 V2.0 安裝與操作指南。
在下列檔案中,貼上您在上一個步驟中複製的 SAP HANA 監控代理程式設定:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
重新啟動 SAP HANA 的監控代理程式:
sudo systemctl start google-saphanamonitoring-agent
解除安裝代理程式
如要從主機上解除安裝或移除代理程式,請按照下列步驟操作:
RHEL
與主機建立 SSH 連線。
執行下列指令:
sudo yum remove google-cloud-sap-agent
SLES
與主機建立 SSH 連線。
執行下列指令:
sudo zypper remove google-cloud-sap-agent
Windows
與主機 Compute Engine 執行個體建立 RDP 連線。
以管理員身分在 PowerShell 中執行下列指令:
Remove-Service -Name 'google-cloud-sap-agent'
在 Cloud Logging 中查看代理程式記錄
根據預設, Google Cloud的 Agent for SAP 記錄會從 Compute Engine 執行個體和 Bare Metal 解決方案伺服器重新導向至 Cloud Logging。
如要在「記錄」中查看代理程式的記錄,請按照下列步驟操作:
前往 Google Cloud 控制台的「Logs Explorer」頁面。
前往「Query」窗格。
從「Resources」下拉式選單中選取「Global」,然後按一下「Apply」。
在查詢編輯器中輸入
google-cloud-sap-agent
。點選「執行查詢」
您可以查看在所有 Compute Engine 執行個體或裸機解決方案伺服器上執行的代理程式執行個體產生的記錄。如要篩選特定執行個體或伺服器的記錄檔,請使用介面提供的篩選器。
您可以停用與指標收集相關的代理程式記錄的預設重新導向功能。若要這樣做,請完成下列步驟:
建立與主機 Compute Engine 執行個體或 Bare Metal 解決方案伺服器的 SSH 連線。
開啟以下設定檔:
/etc/google-cloud-sap-agent/configuration.json
針對參數
log_to_cloud
,將值更新為false
。儲存設定檔。
重新啟動代理程式,讓這項變更生效。
如要停用Google Cloud的 Agent for SAP 的 Backint 功能相關記錄的預設重新導向,請編輯 Backint 設定檔,並將 log_to_cloud
參數設為 false
。