設定 Workload Manager 評估指標收集

本指南說明如何設定 Google Cloud的 Agent for SAP，以便從 SAP 系統收集 Workload Manager 評估指標。

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

事前準備

必要的 IAM 角色

為確保服務帳戶具備必要權限，讓 Google Cloud的 SAP 代理程式收集 Workload Manager 評估指標，請要求管理員將下列 IAM 角色授予服務帳戶：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這些預先定義的角色包含讓 Google Cloud的 SAP 服務代理收集 Workload Manager 評估指標所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要讓 Google Cloud的 SAP 專用代理程式收集 Workload Manager 評估指標，您必須具備下列權限：

  • 如要從主機 Compute Engine 執行個體收集 Workload Manager 評估指標，並將這些指標寫入 Workload Manager 資料倉儲，請按照下列步驟操作：
    • monitoring.timeSeries.create
    • compute.zoneOperations.list
    • compute.disks.list
    • compute.nodeGroups.get
    • workloadmanager.insights.write
  • 如果您使用 Secret Manager 儲存密碼來連線至 SAP HANA 資料庫，請按照下列步驟存取密鑰： secretmanager.versions.access

您的管理員也可能會透過自訂角色或其他預先定義的角色，將這些權限授予服務帳戶。

必要的 SAP HANA 角色

如要讓代理程式從 SAP HANA 資料庫收集指標，請確認您在代理程式設定檔中指定的 SAP HANA 使用者具有 MONITORING 角色。

如要瞭解這個角色，請參閱 SAP 文件「標準資料庫角色」。

驗證代理程式版本

Google Cloud 建議您安裝最新版的 Agent for SAP，以便準確評估 SAP 工作負載，因為 Agent for SAP 的定期版本可能會新增或變更用於評估的指標。

為確保您使用的是 Google Cloud的最新版 SAP 服務代理，請定期檢查更新並更新服務代理。

安裝更新

請選取作業系統，然後按照步驟操作：

RHEL

  1. 建立與執行個體的 SSH 連線。
  2. 更新代理程式執行個體：
    • (建議) 如要更新至代理程式的 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。如要瞭解可安裝的代理程式版本，請參閱「列出所有可用的代理程式版本」。

SLES

  1. 建立與執行個體的 SSH 連線。
  2. 更新代理程式執行個體：
    • (建議) 如要更新至代理程式的 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。如要瞭解可安裝的代理程式版本，請參閱「列出所有可用的代理程式版本」。

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

從 3.2 版開始， Google Cloud的 Agent for SAP 新安裝作業預設會啟用，以便收集 Workload Manager 評估指標。如果您要從先前版本更新至 3.2 版，也可以明確啟用這項功能。若要這樣做，請完成下列步驟：

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

  2. 如要讓代理程式收集 Workload Manager 評估指標，請按照下列步驟操作： 

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

  3. 如要啟用「SAP HANA 深入分析資訊」和「SAP HANA 安全性最佳做法」指標的收集功能，請按照下列步驟操作：

    1. 開啟代理程式的設定檔：

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

      或者，您也可以執行指令來執行這項設定。詳情請參閱「 Google Cloud的 SAP 代理程式設定指令」。

    2. 在 collect_workload_validation_metrics 後方新增 workload_validation_db_metrics_config 部分，然後指定下列參數：

      • hana_db_user：指定用於查詢 SAP HANA 執行個體的 SAP HANA 資料庫使用者帳戶。
      • hostname：指定主機的 ID，該主機可用於代管 SAP HANA 執行個體，可為本機或遠端。
      • port：指定 SAP HANA 執行個體接受查詢的資料庫通訊埠。舉例來說，如果租用戶資料庫正在通訊埠 30015 上接聽，請輸入 30015。
      • sid：指定 SAP HANA 執行個體的 SID

      • hana_db_password_secret_name：指定儲存使用者帳戶密碼的 Secret Manager 中機密的名稱

        您可以使用 hdbuserstore_key 設定參數，做為機密資料的替代方案。

      • hdbuserstore_key：指定用於驗證您為 hana_db_user 指定的使用者的 hdbuserstore 鍵

        如果您指定 hdbuserstore_key，則可略過指定 hostname 和 port 參數。

      如要瞭解這些參數，請參閱「設定參數」。

  4. 您可以選擇在 cloud_properties 部分下方更新自動設定的參數值。如要這樣做，請在設定檔中新增 cloud_properties 部分，然後指定必要參數及其值。

  5. 儲存設定檔。

  6. 重新啟動代理程式，讓新設定生效：

    sudo systemctl restart google-cloud-sap-agent

設定檔範例

Compute Engine 執行個體

以下範例是Google Cloud的 SAP 服務代理，在Compute Engine 執行個體上執行，並啟用 Workload Manager 評估指標的收集功能。

針對 SAP HANA 驗證，代理程式會使用下列優先順序：如果已指定，hdbuserstore_key 設定參數會優先於 hana_db_password 參數，而 hana_db_password 參數會優先於 hana_db_password_secret_name 參數。建議您在設定檔中只設定一個驗證選項。

  • 以下範例使用 安全使用者儲存庫 (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,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • 以下範例使用使用者名稱和 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,
    "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
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • 以下範例使用使用者名稱和密碼進行 SAP HANA 驗證。建議您改為使用 Secret Manager 密鑰或安全使用者儲存庫 (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,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Bare Metal 解決方案伺服器

以下範例是Google Cloud的 SAP 服務代理，在Bare Metal Solution 伺服器上執行，並啟用 Workload Manager 評估指標的收集功能。

針對 SAP HANA 驗證，代理程式會使用下列優先順序：如果已指定，hdbuserstore_key 設定參數會優先於 hana_db_password 參數，而 hana_db_password 參數會優先於 hana_db_password_secret_name 參數。建議您在設定檔中只設定一個驗證選項。

  • 以下範例使用 安全使用者儲存庫 (hdbuserstore) 金鑰進行 SAP HANA 驗證：
    {
  "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",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
      "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • 以下範例使用使用者名稱和 Secret Manager 密鑰進行 SAP HANA 驗證：
    {
  "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
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
      "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • 以下範例使用使用者名稱和密碼進行 SAP HANA 驗證。建議您改為使用 Secret Manager 密鑰或安全使用者儲存庫 (hdbuserstore) 金鑰進行 SAP HANA 驗證。
    {
  "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": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
      "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "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。
cloud_properties.project_id

String

如果您的 SAP 系統是在 Bare Metal 解決方案伺服器上執行，請指定您在 Bare Metal 解決方案中使用的 Google Cloud 專案 ID。

當代理程式在 Compute Engine 執行個體上執行時，根據預設，代理程式會自動偵測專案 ID。
cloud_properties.instance_name

String

如果您的 SAP 系統是在 Compute Engine 執行個體上執行，請指定該 Compute Engine 執行個體的名稱。代理程式會在安裝時自動偵測運算執行個體名稱。

如果 SAP 系統是在 Bare Metal Solution 伺服器上執行，請指定該伺服器的名稱。
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。

當代理程式在運算執行個體上執行時，根據預設，代理程式會自動偵測專案編號。
discovery_configuration.enable_workload_discovery

Boolean

如要讓代理程式收集主機上執行的 SAP 產品名稱和版本，請指定 true。預設值為 true。

詳情請參閱 google-cloud-sap-agent GitHub 存放區中 GoogleCloudPlatform/sapagent 底下的代理程式程式碼庫。
discovery_configuration.enable_discovery

Boolean

如要將代理程式收集到的關於主機上執行的 SAP 產品資訊傳送至 Cloud Logging，請指定 true。預設值為 true。

如果您指定 false 值，代理程式就會將收集到的資訊儲存在主機上，而不會傳送至 Cloud Logging。
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_collection_definition.fetch_latest_config

Boolean

(選用步驟) 預設值為 true，可讓代理程式收集最新的 Workload Manager 評估指標組合，而不需要更新代理程式。如要關閉這項行為，請在設定檔中指定這個參數，並將其值設為 false。
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 執行個體的使用者帳戶密碼。

針對 SAP HANA 驗證，代理程式會使用下列優先順序：如果已指定，hdbuserstore_key 設定參數會優先於 hana_db_password 參數，而 hana_db_password 參數會優先於 hana_db_password_secret_name 參數。建議您在設定檔中只設定一個驗證選項。
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name

String

在 Secret Manager 中指定儲存使用者帳戶密碼的機密。

或者，您也可以指定 hdbuserstore_key 設定參數，驗證指定的 SAP HANA 使用者。

針對 SAP HANA 驗證，代理程式會使用下列優先順序：如果已指定，hdbuserstore_key 設定參數會優先於 hana_db_password 參數，而 hana_db_password 參數會優先於 hana_db_password_secret_name 參數。建議您在設定檔中只設定一個驗證選項。
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

如要安全地連線至 SAP HANA 系統，請指定您為該系統建立的 安全使用者儲存庫 (hdbuserstore) 金鑰。

如要使用 hdbuserstore 金鑰進行驗證，請確認下列事項：

  • SAP 工具 hdbsql 和 hdbuserstore 會安裝在代管代理程式的運算執行個體上。
  • hdbuserstore 索引鍵對應至一個特定的 SAP HANA 執行個體。您無法使用包含多個 SAP HANA 執行個體主機名稱的金鑰。
  • SIDadm 使用者可以使用這個鍵查詢 SAP HANA 資料庫。此處的 SID 是指您為 sid 參數指定的值。您可以以 SIDadm 使用者身分執行下列指令，確認這項設定：
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

這個設定參數自 3.3 版開始支援。

如果您指定 hdbuserstore_key，則可以略過指定 hostname 和 port 參數。

針對 SAP HANA 驗證，代理程式會使用下列優先順序：如果已指定，hdbuserstore_key 設定參數會優先於 hana_db_password 參數，而 hana_db_password 參數會優先於 hana_db_password_secret_name 參數。建議您在設定檔中只設定一個驗證選項。
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 秒。

驗證 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:
        ...
        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
    ...
    ----------------------------------------------------------------------------
    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)
    ----------------------------------------------------------------------------
    Workload Manager Evaluation: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            collect_workload_validation_metrics:      true       (default)
            config_target_environment:                PRODUCTION (default)
            fetch_latest_config:                      true       (default)
            workload_validation_db_metrics_frequency: 3600       (default)
            workload_validation_metrics_frequency:    300        (default)
    ...
  3. 如果輸出內容顯示缺少部分設定，請查看前面各節提供的資訊，執行必要動作，然後重新執行 status 指令，重新驗證設定。

查看收集的指標

如要查看代理程收集到的 Workload Manager 評估指標，請執行下列操作：

  • 查看代理程式的記錄檔：

    1. 將代理程式記錄層級設為 DEBUG：

      sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug

    2. 代理程式重新啟動以套用新記錄層級後，請查看代理程式的記錄檔案：

      /var/log/google-cloud-sap-agent.log

    3. 在記錄檔案中，尋找包含下列項目的項目：

      workload.googleapis.com/sap/validation/

      以下是顯示 Workload Manager 評估指標的代理程式記錄檔範例：

      {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "metric":"workload.googleapis.com/sap/validation/system","value":1}
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "key":"instance_name","value":"n1-hana-sles15"}
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "key":"os","value":"sles-15-SP4"}
...
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
      "metric":"workload.googleapis.com/sap/validation/corosync","value":0}
...

  • 如果代理程式執行個體已設定為將記錄檔傳送至 Cloud Logging，您就可以在 Cloud Logging 中查看代理程式的記錄檔。

  • 在 Workload Manager 中建立並執行 SAP 工作負載評估作業。詳情請參閱「建立及執行評估作業」。

    如要瞭解 Workload Manager 支援的最佳做法，以便評估在 Google Cloud上執行的 SAP 工作負載，請參閱 Workload Manager 適用於 SAP 的最佳做法。