Google Cloud's Agent for SAP 可監控在 Compute Engine 執行個體上執行的 SAP 工作負載，並協助您在 Google Cloud上有效率地執行 SAP 系統。您必須在執行任何 SAP 系統的所有 VM 上安裝 Google CloudAgent for SAP。這個代理程式會收集 SAP 規定的所有必要資訊，並傳送至 SAP Host Agent。詳情請參閱 SAP 注意事項 2469354。
如要收集用於可觀測性的基礎架構和應用程式指標，您必須為 SAP 代理程式啟用其他功能。
本文說明如何在 Agent for SAP 中啟用這些功能。
Agent for SAP 檢查清單
以下檢查清單列出您需要執行的工作，確保 Agent for SAP 已正確設定可觀測性：
| 安裝及設定 Agent for SAP | 在要監控的每個 Compute Engine VM 上，安裝及設定 Google Cloud的 Agent for SAP。 Agent for SAP 隨附於下列「SAP 專用」公開 OS 映像檔：
詳情請參閱「在 VM 上安裝及設定 Agent for SAP」。 |
| 更新 Agent for SAP | Agent for SAP 3.5 版包含設定 SAP 可觀測性所需的所有功能。
如果先前已安裝代理程式，建議更新至最新版本。 如要查看預先定義的 SAP 事件例項註解，您必須使用 3.7 以上版本的代理程式。 |
| 啟用 Agent for SAP 的系統探索功能 | 在代理程式的設定檔中，下列參數必須設為 true。
如果您在 2024 年 2 月 14 日後安裝代理程式，這些標記預設會設為 true，因此不需要變更。
如果您在 2024 年 2 月 14 日前安裝代理程式，或已停用系統的探索功能，請執行下列指令：
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable 詳情請參閱「設定 Google Cloud的 Agent for SAP」。 |
| 啟用 Agent for SAP 的程序監控指標收集功能 | 在代理程式的設定檔中，collection_configuration.collect_process_metrics 參數必須設為 true。如要啟用這項功能，請執行下列指令：
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable 詳情請參閱「設定程序監控指標收集作業」。 |
| 啟用 SAP HANA 監控指標收集代理程式 | 在 HANA VM 上，您必須啟用 HANA 程序監控指標收集功能。如要啟用這項功能，請執行下列指令：
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable 編輯代理程式設定檔中的 請注意，指定的 HANA 使用者必須具有預設查詢所查詢資料表的讀取權限。 詳情請參閱「設定 SAP HANA 監控指標收集作業」。 |
| 驗證代理程式設定和設定 Google Cloud | 執行下列指令，確認代理程式設定正確無誤：sudo /usr/bin/google_cloud_sap_agent status 詳情請參閱「驗證 Workload Manager 可觀測性的設定」。 |
| 重新啟動 Agent for SAP | 執行下列指令，重新啟動代理程式，讓變更生效：
sudo systemctl restart google-cloud-sap-agent 詳情請參閱「重新啟動代理程式」。 |
驗證 Workload Manager 可觀測性設定
您可以執行代理程式的 status 指令，驗證您是否已正確 Google Cloud 設定，以便使用 Workload Manager 可觀測性服務。代理程式 3.7 以上版本支援這項指令。
如要驗證 Google Cloud 設定，請完成下列步驟：
- 建立與 Compute Engine 執行個體的 SSH 連線。
執行下列指令：
sudo /usr/bin/google_cloud_sap_agent status如果 Google Cloud 使用 Workload Manager 可觀測性服務的設定正確，輸出內容會包含下列項目。 您的設定可能會有
default以外的值。Agent Status: Installed version: 3.7-.... ... Systemd Service Enabled: True Systemd Service Running: True Cloud API Full Scopes: True Configuration File: /etc/google-cloud-sap-agent/configuration.json Configuration Valid: True ... ---------------------------------------------------------------------------- Process Metrics: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: collect_process_metrics: true (configuration file) process_metrics_frequency: 30 (default) process_metrics_to_skip: [] (default) slow_process_metrics_frequency: 120 (default) ... ---------------------------------------------------------------------------- HANA Monitoring Metrics: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: connection_timeout: 120 (default) enabled: true (configuration file) execution_threads: 10 (default) max_connect_retries: 1 (default) query_timeout_sec: 300 (default) sample_interval_sec: 300 (default) send_query_response_time: false (default) ... ---------------------------------------------------------------------------- System Discovery: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: enable_discovery: true (default) enable_workload_discovery: true (default) sap_instances_update_frequency: 60 (default) system_discovery_update_frequency: 14400 (default) ...如果輸出內容顯示缺少部分設定，請查看前幾節提供的資訊，執行必要動作，然後重新執行
status指令，重新驗證設定。
設定檔範例
啟用可觀測性功能後，Agent for SAP 的設定檔看起來會類似下列內容：
{ "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": true }, "discovery_configuration": { "enable_workload_discovery": true, "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": true, "hana_instances": [ { "name": "local", "sid": "DEH", "host": "localhost", "port": "30015", "user": "system", "secret_name": "password-secret-name" } ] } }
後續步驟
- 瞭解如何監控 SAP 工作負載。