設定 Agent for SAP，以便設定可觀測性

本文說明如何設定 Google Cloud的 Agent for SAP，透過 Workload Manager 為 SAP 工作負載設定可觀測性。

Workload Manager 可觀測性服務需要代理程式，才能從 SAP 工作負載和基礎架構收集指標。詳情請參閱 SAP 可觀測性總覽。

事前準備

在執行 SAP 工作負載的所有 Compute Engine 執行個體上，驗證您安裝的 Google CloudAgent for SAP，以便設定可觀測性。

如要瞭解如何驗證代理程式安裝，請參閱「檢查您的代理程式是否正確安裝」。
確認您已完成 SAP 可觀測性功能的前置作業。

為單一可用區工作負載設定代理程式

VM 擴充功能管理工具

如要在 Compute Engine 執行個體群組中設定及管理代理程式，您必須為該群組建立 VM 擴充功能管理工具政策。

如要設定代理程式，為在單一區域中執行的 SAP 工作負載設定可觀測性，請完成下列步驟：

設定 VM 擴充功能管理工具：
- 在 VM 擴充功能管理工具說明文件中，查看「開始前準備」一節。
- 設定建立及管理 VM 擴充功能管理員政策所需的 IAM 角色。如要瞭解詳情，請參考下列資源：
建立 VM 擴充功能政策，在執行 SAP 工作負載的運算執行個體上安裝及管理 Google Cloud的 Agent for SAP：
- 在 SAP 工作負載執行的可用區中，建立 VM 擴充功能政策。如要瞭解如何建立這類 VM 擴充功能政策，請參閱「建立區域 VM 擴充功能政策」。
- 如要查看可觀測性的代理程式設定範例，請參閱「代理程式設定範例」。

套件管理工具

如果您是手動管理代理程式生命週期，而不是使用 VM 擴充功能管理工具，則可使用套件管理工具設定 Google Cloud適用於 SAP 的代理程式：

建立與執行 SAP 工作負載的運算執行個體之間的 SSH 連線。
確認您執行的是最新版本的 Agent for SAP。

如要瞭解如何更新代理程式，請參閱「更新 SAP 專用代理程式 Google Cloud」。

如要讓代理程式查詢 SAP 工作負載的詳細資料，並將這些資料傳送至 Workload Manager，請按照下列步驟操作：

sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

啟用代理程式，從 SAP 工作負載中執行的程序收集指標：
1. 啟用代理程式的程序監控功能：
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
1. 如要讓代理程式收集與 SAP HANA 資料庫執行個體相關的程序指標，您需要在 hana_metrics_config 專區中設定額外參數。
詳情請參閱「設定程序監控指標收集作業」。
啟用代理程式，從 SAP 工作負載中執行的 SAP HANA 執行個體收集指標：
1. 啟用代理程式的 SAP HANA 監控功能：
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
1. 如要讓代理程式連線至 SAP HANA 執行個體並收集指標，您需要設定其他參數。
詳情請參閱「設定 SAP HANA 監控指標收集作業」。
儲存設定檔。

如要查看可觀測性的代理程式設定範例，請參閱「代理程式設定範例」。

為多區域工作負載設定代理程式

VM 擴充功能管理工具

如要在 Compute Engine 執行個體群組中設定及管理代理程式，您必須為該群組建立 VM 擴充功能管理工具政策。

如要設定代理程式，為在兩個以上區域中執行的 SAP 工作負載設定可觀測性，請完成下列步驟：

設定 VM 擴充功能管理工具：
- 在 VM 擴充功能管理工具說明文件中，查看「開始前準備」一節。
- 設定建立及管理 VM 擴充功能管理員政策所需的 IAM 角色。如要瞭解詳情，請參考下列資源：
建立 VM 擴充功能政策，在執行 SAP 工作負載主要網站的運算執行個體上，安裝及管理 Google Cloud的 Agent for SAP：
- 在 SAP 工作負載主要網站執行的可用區中，建立 VM 擴充功能政策。如要瞭解如何建立這類 VM 擴充功能政策，請參閱「建立區域 VM 擴充功能政策」。
- 如要查看可觀測性的代理程式設定範例，請參閱「代理程式設定範例」。
如果您執行高可用性 SAP 工作負載，或有 SAP 工作負載的災難復原 (DR) 網站，請建立 VM 擴充功能政策，在執行 SAP 工作負載次要或 DR 網站的運算執行個體上，安裝及管理 Google Cloud的 Agent for SAP。

套件管理工具

如果您是手動管理代理程式生命週期，而不是使用 VM 擴充功能管理工具，則可使用套件管理工具設定 Google Cloud適用於 SAP 的代理程式：

建立與執行 SAP 工作負載的運算執行個體之間的 SSH 連線。
確認您執行的是最新版本的 Agent for SAP。

如要瞭解如何更新代理程式，請參閱「更新 SAP 專用代理程式 Google Cloud」。

如要讓代理程式收集 SAP 工作負載的詳細資料，並傳送至 Workload Manager，請按照下列步驟操作：

sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

啟用代理程式，從 SAP 工作負載中執行的程序收集指標：
1. 啟用代理程式的程序監控功能：
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
1. 如要讓代理程式收集與 SAP HANA 資料庫執行個體相關的程序指標，您需要在 hana_metrics_config 專區中設定額外參數。
詳情請參閱「設定程序監控指標收集作業」。
啟用代理程式，從 SAP 工作負載中執行的 SAP HANA 執行個體收集指標：
1. 啟用代理程式的 SAP HANA 監控功能：
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
1. 如要讓代理程式連線至 SAP HANA 執行個體並收集指標，您需要設定其他參數。
詳情請參閱「設定 SAP HANA 監控指標收集作業」。
儲存設定檔。
如果您執行的是高可用性 SAP 工作負載，或是 SAP 工作負載的災難復原 (DR) 網站，請針對執行 SAP 工作負載的所有其他運算執行個體重複此程序。

如要查看可觀測性的代理程式設定範例，請參閱「代理程式設定範例」。

驗證 Workload Manager 可觀測性設定

如要驗證您是否已正確 Google Cloud 設定，可使用 Workload Manager 可觀測性服務，請執行代理程式的 status 指令。

如要驗證 Google Cloud 設定，請完成下列步驟：

建立與執行 SAP 工作負載的 Compute Engine 執行個體之間的 SSH 連線。

檢查可觀測性的 Google Cloud 設定：

sudo /usr/bin/google_cloud_sap_agent status

如果 Google Cloud 使用 Workload Manager 可觀測性服務的設定正確，輸出內容會包含下列項目。您的設定可能會有 default 以外的值。

Agent Status:
    Installed version: 3.10-....
    ...
    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 指令，重新驗證設定。
如果您使用多個運算執行個體執行工作負載，請為執行工作負載的所有其他運算執行個體重複執行這個程序。

虛擬服務專員設定範例

以下範例是完成的 Google Cloud's Agent for SAP 設定檔，可支援 SAP HANA 工作負載的可觀測性：

下列範例使用安全使用者存放區 (hdbuserstore) 金鑰進行 SAP HANA 驗證：

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

以下範例使用使用者名稱和 Secret Manager 密鑰進行 SAP HANA 驗證：

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "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": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

以下範例使用使用者名稱和密碼進行 SAP HANA 驗證。建議您改用安全使用者儲存區 (hdbuserstore) 金鑰或 Secret Manager 密鑰進行 SAP HANA 驗證。

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "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": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

如要瞭解代理程式支援的設定參數，請參閱「設定參數」。

後續步驟

成功完成 SAP 工作負載的可觀測性設定後，該工作負載最多需要 15 分鐘，才會顯示在 Google Cloud 控制台的 Workload Manager「可觀測性」頁面中。

如要瞭解如何觀察 SAP 工作負載，請參閱「查看 SAP 的可觀測性指標」。

設定 Agent for SAP，以便設定可觀測性 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

為單一可用區工作負載設定代理程式

VM 擴充功能管理工具

套件管理工具

為多區域工作負載設定代理程式

VM 擴充功能管理工具

套件管理工具

驗證 Workload Manager 可觀測性設定

虛擬服務專員設定範例

後續步驟

設定 Agent for SAP，以便設定可觀測性