設定 Agent for SAP 以收集指標

Google Cloud的 SAP 代理程式可協助您監控在 Compute Engine 執行個體上執行的 SAP 工作負載,並在 Google Cloud上有效執行 SAP 系統。您必須在執行任何 SAP 系統的所有 VM 上安裝 Google Cloud的 Agent 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 映像檔一起封裝:
  • RHEL:所有「SAP 專用」映像檔
  • SLES:SLES 15 SP4 for SAP 以上版本

詳情請參閱「在 VM 上安裝及設定 Agent for SAP」。

更新 Agent for SAP
Agent for SAP 的 3.5 版包含設定 SAP 可觀察性的所有必要功能。 如果先前已安裝代理程式,建議您更新至最新版本。

如要查看預先定義 SAP 事件的發生情形註解,您需要使用 3.7 以上版本的代理程式。

詳情請參閱「Update Google Cloud的 SAP 代理程式」。

啟用 Agent for SAP 的系統探索功能
在代理程設定檔中,下列參數必須設為 true。如果您是在 2024 年 2 月 14 日之後安裝代理程式,這些標記預設為 true,因此不需要變更。
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
如果您在 2024 年 2 月 14 日前安裝了這個代理程式,或是已停用系統的探索功能,請執行下列指令:
         sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable 
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_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

詳情請參閱「設定 Process Monitoring 指標收集功能」。

啟用 SAP HANA 監控指標收集功能的代理程式
在 HANA VM 上,您必須啟用 HANA Process Monitoring 指標收集功能。如要啟用這項功能,請執行下列指令:
         sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

編輯代理程式設定檔中的 hana_monitoring_configuration 區段,提供 HANA 執行個體名稱、SID、主機、通訊埠、使用者和密碼 (使用密鑰或 hdbuserstore 金鑰)。

請注意,指定的 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 設定,請完成下列步驟:

  1. 建立與 Compute Engine 執行個體的 SSH 連線。
  2. 執行下列指令:

    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:      5    (default)
            process_metrics_to_skip:        []   (default)
            slow_process_metrics_frequency: 30   (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)
    ...
    
  3. 如果輸出內容指出缺少部分設定,請查看前面各節提供的資訊,執行必要動作,然後重新執行 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"
      },
    ],
   }
  }
  

後續步驟