本頁面由 Cloud Translation API 翻譯而成。

版本 2：設定 Workload Manager 評估指標收集

本指南說明如何設定Google Cloud的 SAP 專用代理程式第 2 版，以便從 SAP 系統收集 Workload Manager 評估指標。

如要瞭解這項功能，請參閱「使用 Google Cloud的 SAP 代理程式進行 Workload Manager 評估」。

事前準備

驗證 Google Cloud的 Agent for SAP 安裝作業。如需操作說明，請參閱適用於您情況的安裝指南。
如果您已在 Bare Metal 解決方案伺服器上安裝代理程式，請確認您已完成必要的先決條件，並設定服務帳戶。如需操作說明，請參閱「在 Linux 上設定 Google Cloud的 Agent for SAP」。

設定 IAM 角色

如要讓 Google Cloud的 SAP 代理程式收集 Workload Manager 評估指標，您必須確保 Compute Engine 執行個體或裸機解決方案伺服器使用的服務帳戶包含下列角色：

Compute Viewer (roles/compute.viewer)
監控指標寫入器 (roles/monitoring.metricWriter)
Secret Manager 密鑰存取者 (roles/secretmanager.secretAccessor)：如果您使用 Secret Manager 儲存 SAP HANA 資料庫密碼。

如要將這些必要角色新增至服務帳戶，請按照下列步驟操作：

前往 Google Cloud 控制台的「IAM」頁面。

前往身分與存取權管理頁面
選取 Google Cloud 專案。
找出您想新增角色的服務帳戶。
- 如果服務帳戶不在主體清單中，表示尚未獲派任何角色。按一下「Add」，然後輸入服務帳戶的電子郵件地址。
- 如果服務帳戶已在使用者清單中，表示已獲指派角色。找到要編輯的服務帳戶，然後按一下「編輯」按鈕。
從可用角色清單中選取必要角色：
- Compute 檢視器
- Monitoring > Monitoring 指標寫入者
- Secret Manager > Secret Manager 密鑰存取者
按一下 [Add] (新增) 或 [Save] (儲存)，即可將角色套用到服務帳戶。

啟用 Workload Manager 評估指標收集功能

如要使用 Google Cloud的 SAP 專用代理程式收集工作負載管理工具評估指標，請按照下列步驟操作：

與 Compute Engine 執行個體或 Bare Metal 解決方案伺服器建立 SSH 連線。

開啟代理程設定檔：

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

在 collection_configuration 部分中，針對 collect_workload_validation_metrics 參數設定 true 值。
如要啟用 workload.googleapis.com/sap/validation/hanasecurity 指標的收集作業，以便在 Workload Manager 中啟用安全性評估規則，請在 collect_workload_validation_metrics 後方新增 workload_validation_db_metrics_config 區段，然後指定下列參數：
- hana_db_user：指定用於查詢 SAP HANA 執行個體的使用者帳戶。
- hana_db_password_secret_name：指定儲存使用者帳戶密碼的 Secret Manager 中機密的名稱。
- hostname：指定主機的 ID，該主機可代管 SAP HANA 執行個體，可為本機或遠端。
- port：指定 SAP HANA 執行個體接受查詢的通訊埠。
如要瞭解這些參數，請參閱「設定參數」。
您可以選擇在 cloud_properties 部分下方更新自動設定的參數值。如要這樣做，請將 cloud_properties 部分新增至設定檔，然後指定必要參數及其值。
儲存設定檔。
重新啟動代理程式，讓新設定生效：
```
sudo systemctl restart google-cloud-sap-agent
```

設定檔範例

Compute Engine 執行個體

以下範例是Google Cloud的 Agent for SAP 2 版設定檔，在Compute Engine 執行個體上執行，其中啟用了 Workload Manager 評估指標的收集功能：

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Bare Metal 解決方案伺服器

以下範例是Google Cloud的 Agent for SAP 2 版設定檔，在Bare Metal Solution 伺服器上執行，其中啟用了 Workload Manager 評估指標的收集功能：

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

設定參數

下表說明Google Cloud的 SAP 服務代理設定參數，這些參數適用於收集 Workload Manager 評估指標。

參數
`provide_sap_host_agent_metrics`	`Boolean` 如要啟用 SAP Host Agent 所需的指標收集功能，請指定 `true`。預設值為 `true`。除非 Cloud Customer Care 或 SAP 支援團隊另有指示，否則請勿將 `provide_sap_host_agent_metrics` 設為 `false`。
`bare_metal`	`Boolean` 將代理程式安裝在 Bare Metal 解決方案伺服器上時，請指定 `true`。預設值為 `false`。
`log_level`	`String` 如要設定代理程式的記錄等級，請設定必要值。可用的記錄層級如下： `DEBUG` `INFO` `WARNING` `ERROR` 預設為 `INFO` 步。除非 Cloud Customer Care 指示，否則請勿變更記錄層級。
`log_to_cloud`	`Boolean` 如要將代理程式的記錄重新導向至 Cloud Logging，請指定 `true`。預設值為 `true`。
`sap_system_discovery`	`Boolean` 如要啟用 SAP 系統探索功能，請指定 `true`。預設值為 `true`。
`cloud_properties.project_id`	`String` 如果您的 SAP 系統是在 Bare Metal 解決方案伺服器上執行，請指定您在 Bare Metal 解決方案中使用的 Google Cloud 專案 ID。當代理程式在 Compute Engine 執行個體上執行時，根據預設，代理程式會自動偵測專案 ID。
`cloud_properties.instance_name`	`String` 如果您的 SAP 系統是在 Compute Engine 執行個體上執行，請指定該運算執行個體的名稱。代理程式會在安裝時自動偵測運算執行個體名稱。如果 SAP 系統是在 Bare Metal Solution 伺服器上執行，請指定該伺服器的名稱。在代理程式 2.5 以下版本中，請為屬性 `instance_id` 指定 Bare Metal 解決方案伺服器名稱。
`cloud_properties.region`	`String` 如果 SAP 系統是在 Bare Metal 解決方案伺服器上執行，請指定 Bare Metal 解決方案伺服器的區域。當代理程式在運算執行個體上執行時，根據預設，代理程式會使用運算執行個體部署的區域。
`cloud_properties.zone`	`String` 代理程式在運算執行個體上執行時，預設會使用運算執行個體部署所在的區域。
`cloud_properties.image`	`String` 指定執行個體的 OS 映像檔名稱。當代理程式在運算執行個體上執行時，根據預設，代理程式會自動偵測運算執行個體使用的 OS 映像檔。
`cloud_properties.numeric_project_id`	`String` 指定執行 SAP 系統的 Google Cloud 專案的數字 ID。當代理程式在運算執行個體上執行時，根據預設，代理程式會自動偵測專案編號。
`collection_configuration.collect_workload_validation_metrics`	`Boolean` 如要啟用 Workload Manager 評估指標收集功能，請指定 `true`。自 3.2 版起，預設值為 `true`。這個參數僅適用於 Linux。
`collection_configuration.workload_validation_metrics_frequency`	`Int` Workload Manager 評估指標的收集頻率 (以秒為單位)。預設值為 `300` 秒。建議您不要修改預設收集頻率，因為這可能會影響整個功能本身。如果您需要修改工作負載管理工具指標的收集頻率，請在 `collection_configuration` 部分下方新增 `workload_validation_metrics_frequency` 參數，並提供必要的值。
`collection_configuration.workload_validation_db_metrics_config.hana_db_user`	`String` 指定用於查詢 SAP HANA 執行個體的使用者帳戶。使用者帳戶必須具備 SAP HANA 資料庫的讀取權限。
`collection_configuration.workload_validation_db_metrics_config.hana_db_password`	`String` 指定用來查詢 SAP HANA 執行個體的使用者帳戶密碼。
`collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name`	`String` 在 Secret Manager 中指定儲存使用者帳戶密碼的機密。
`collection_configuration.workload_validation_db_metrics_config.sid`	`String` 指定 SAP HANA 例項的 SID。
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` 指定主機的 ID，該主機可用於代管 SAP HANA 例項，可為本機或遠端。支援的值如下：如果主機是本機電腦，請指定字串 `localhost` 或本機電腦迴送 IP 位址，例如 `127.0.0.1`。如果主機是遠端機器，請指定其內部或外部 IP 位址。
`collection_configuration.workload_validation_db_metrics_config.port`	`String` 指定 SAP HANA 執行個體接受查詢的通訊埠。第一個或唯一租用戶資料庫執行個體的通訊埠為 `3NN15`，其中 `NN` 是 SAP HANA 執行個體的執行個體編號。
`collection_configuration.workload_validation_db_metrics_frequency`	`Int` 收集 SAP HANA 資料庫指標的頻率 (以秒為單位)，用於 Workload Manager 評估。預設值為 `3600` 秒。雖然您可以更新 SAP HANA 資料庫指標的收集頻率，但建議您使用預設值。如果您需要修改預設值，請在 `collection_configuration` 區段下方新增 `workload_validation_db_metrics_frequency` 參數，並提供必要的值。請確認您設定的收集頻率不會超過 `3600` 秒。