本指南說明如何設定Google Cloud的 SAP 專用代理程式第 2 版，以便從 SAP 系統收集程序監控指標。
如要瞭解這項功能，請參閱「使用 Google Cloud的 SAP 代理程式進行程序監控」。
事前準備
- 驗證 Google Cloud的 Agent for SAP 安裝作業。如需操作說明，請參閱適用於您情況的安裝指南。
- 如果您已在 Bare Metal 解決方案伺服器上安裝代理程式，請確認您已完成必要的先決條件，並設定服務帳戶。如需操作說明，請參閱「在 Linux 上設定 Google Cloud的 Agent for SAP」。
設定 IAM 角色
如要讓 Google Cloud的 SAP 代理程式收集程序監控指標，您必須確保 Compute Engine 執行個體或裸機解決方案伺服器使用的服務帳戶包含下列角色：
- Compute Viewer (
roles/compute.viewer) - Monitoring 指標寫入者 (
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] (儲存)，即可將角色套用到服務帳戶。
啟用 Process Monitoring 指標收集功能
如要啟用使用Google Cloud適用於 SAP 的代理程式收集程序監控指標的功能，請按照下列步驟操作：
與主機 Compute Engine 執行個體建立 SSH 連線。
開啟代理程設定檔：
/etc/google-cloud-sap-agent/configuration.json
在
collection_configuration部分中，執行以下操作：- 針對參數
collect_process_metrics，指定true值。 - 如要啟用與 SAP HANA 資料庫執行個體相關的程序監控指標收集功能，您必須在
hana_metrics_config部分設定其他參數。如要瞭解這些參數，請參閱「設定參數」。
- 針對參數
您可以選擇在
cloud_properties部分下方更新自動設定的參數值。如要這樣做，請將cloud_properties部分新增至設定檔，然後指定必要參數及其值。儲存設定檔。
重新啟動代理程式，讓新設定生效：
sudo systemctl restart google-cloud-sap-agent
設定檔範例
Compute Engine 執行個體
以下範例是Google Cloud的 SAP 代理程式設定檔，在 Compute Engine 執行個體上執行，並啟用 Process Monitoring 指標收集功能：{ "provide_sap_host_agent_metrics": true, "bare_metal": false, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "sap_system_discovery": true, "collect_workload_validation_metrics": true, "collect_process_metrics": true, "process_metrics_frequency": 5, "slow_process_metrics_frequency": 30, "hana_metrics_config": { "hana_db_user": "db_user_name", "sid": "DEH", "hana_db_password_secret_name": "db_pwd_secret_name" } }, "hana_monitoring_configuration": { "enabled": false } }
Bare Metal 解決方案伺服器
以下範例是Google Cloud的 SAP 代理程式設定檔，在 Bare Metal 解決方案伺服器上執行，並啟用 Process Monitoring 指標集合：{ "provide_sap_host_agent_metrics": true, "bare_metal": true, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "sap_system_discovery": true, "collect_workload_validation_metrics": true, "collect_process_metrics": true, "process_metrics_frequency": 5, "slow_process_metrics_frequency": 30, "hana_metrics_config": { "hana_db_user": "db_user_name", "sid": "DEH", "hana_db_password_secret_name": "db_pwd_secret_name" } }, "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 專用代理程式設定參數，這些參數與程序監控指標的收集作業相關。
| 參數 | |
|---|---|
provide_sap_host_agent_metrics |
如要啟用 SAP Host Agent 所需的指標收集功能，請指定 |
bare_metal |
將代理程式安裝在 Bare Metal 解決方案伺服器上時，請指定 |
log_level |
如要設定代理程式的記錄等級，請設定必要值。可用的記錄層級如下：
預設為 |
log_to_cloud |
如要將代理程式的記錄重新導向至 Cloud Logging，請指定 |
sap_system_discovery |
如要啟用 SAP 系統探索功能，請指定 |
cloud_properties.project_id |
如果您的 SAP 系統是在 Bare Metal 解決方案伺服器上執行，請指定您在 Bare Metal 解決方案中使用的 Google Cloud 專案 ID。 |
cloud_properties.instance_name
|
如果您的 SAP 系統是在 Compute Engine 執行個體上執行，請指定該運算執行個體的名稱。代理程式會在安裝時自動偵測運算執行個體名稱。 如果 SAP 系統是在 Bare Metal Solution 伺服器上執行，請指定該伺服器的名稱。在代理程式 2.5 以下版本中，請為屬性 |
cloud_properties.region |
如果 SAP 系統是在 Bare Metal 解決方案伺服器上執行，請指定 Bare Metal 解決方案伺服器的區域。 |
cloud_properties.zone |
代理程式在運算執行個體上執行時，預設會使用運算執行個體部署所在的區域。 |
cloud_properties.image |
指定執行個體的 OS 映像檔名稱。 |
cloud_properties.numeric_project_id |
指定執行 SAP 系統的 Google Cloud 專案的數字 ID。 |
collection_configuration.collect_process_metrics |
如要啟用 Process Monitoring 指標收集功能，請指定 |
collection_configuration.process_metrics_frequency |
自 2.6 版起，這個參數會以秒為單位，決定快速變動的程序監控指標的收集頻率。變化快速的 Process Monitoring 指標為： 這個參數的預設值為 所有其他 (變動緩慢) 的 Process Monitoring 指標，會以 30 秒的預設頻率收集。如要變更變化緩慢的 Process Monitoring 指標的收集頻率，請使用 |
collection_configuration.slow_process_metrics_frequency |
指定變動緩慢的程序監控指標的收集頻率 (以秒為單位)。 這個參數的預設值為 |
collection_configuration.process_metrics_to_skip |
指定不想讓代理程式收集的Process Monitoring 指標。這個參數接受以逗號分隔的 Process Monitoring 指標名稱值。例如： |
collection_configuration.hana_metrics_config.hana_db_user |
指定代理程式用來查詢 SAP HANA 的資料庫使用者帳戶。預設值為 |
collection_configuration.hana_metrics_config.hana_db_password |
為資料庫使用者帳戶指定純文字密碼，代理程式會使用這組密碼查詢 SAP HANA。 建議您改用下列任一選項，而非指定純文字密碼：
|
collection_configuration.hana_metrics_config.hana_db_password_secret_name |
如要安全地提供資料庫使用者帳戶的密碼，以便代理程式用於查詢 SAP HANA，請指定包含資料庫使用者帳戶安全性憑證的機密資料名稱。 只有在您指定 |
collection_configuration.hana_metrics_config.sid |
指定 SAP HANA 執行個體的 SID。 |
查看收集的指標
如要以視覺化方式呈現代理程式收集的Process Monitoring 指標，您可以使用Google Cloud 提供的下列自訂資訊主頁：
SAP 專用代理程式 - HANA 總覽：此資訊主頁提供圖表，顯示下列指標的狀態總覽：SAP HANA 可用性、SAP HANA HA 可用性、SAP HANA HA 複製、SAP HANA 服務狀態、HA 叢集 - 節點狀態，以及 HA 叢集 - SAP 執行個體的資源狀態。
這個資訊主頁的 JSON 檔案為
sap-agent-status-overview.json。SAP 專用代理程式 - HANA 原始指標：這個資訊主頁提供圖表，顯示下列指標的原始指標值：SAP HANA 可用性、SAP HANA HA 可用性、SAP HANA HA 複寫、SAP HANA 服務狀態、HA 叢集 - 節點狀態，以及 HA 叢集 - SAP 執行個體的資源狀態。
這個資訊主頁的 JSON 檔案為
sap-agent-raw-metrics.json。
安裝資訊主頁
如要安裝自訂資訊主頁，請完成下列步驟：
Google Cloud 控制台
在 Google Cloud 控制台中，前往「Monitoring」頁面：
在 Monitoring 導覽面板中，按一下「Dashboards」。
按一下「Sample library」分頁標籤。
如要篩選特定服務專員的自訂資訊主頁，請在「Filter」欄位中輸入
Agent for SAP。(選用) 如要查看資訊主頁的詳細資料或預覽內容，請按一下「預覽」。
選取要安裝的資訊主頁。
依序按一下「匯入」和「確認」。
資訊主頁會新增至Google Cloud 專案中可用的資訊主頁。如要查看資訊主頁，請按照「查看已安裝的資訊主頁」中的操作說明進行。
Google Cloud CLI
開啟 Cloud Shell：
在 Cloud Shell 中複製或下載存放區：
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/
在 Cloud Shell 中，使用對應的 JSON 檔案安裝必要的資訊主頁：
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
將
CONFIG_FROM_FILE改為指向含有資訊主頁設定的 JSON 檔案路徑。資訊主頁設定檔位於路徑：monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap。資訊主頁會新增至 Google Cloud 專案中可用的資訊主頁。如要查看資訊主頁，請按照「查看已安裝的資訊主頁」中的指示操作。
查看已安裝的資訊主頁
如要查看已安裝的資訊主頁，請按照下列步驟操作：
在 Google Cloud 控制台中，前往「Monitoring」頁面：
在 Monitoring 導覽面板中，按一下「Dashboards」。
按一下清單中的資訊主頁名稱。
如果您有許多資訊主頁，可以篩選自訂資訊主頁或新資訊主頁的名稱。如要進一步瞭解如何篩選這份名單，請參閱「查看自訂資訊主頁」一文。
以下圖片為範例，顯示 Monitoring 中 SAP HANA 指標的自訂資訊主頁部分。
