版本 1：在 Compute Engine 執行個體上安裝及設定 Google Cloud 的 Agent for SAP

Google Cloud的 SAP 代理程式是 SAP 支援在 Google Cloud上執行的 SAP 系統所需的工具，包括 SAP NetWeaver、SAP HANA、SAP ASE、SAP MaxDB 等。

在 Compute Engine 執行個體上安裝 Google Cloud的 SAP 代理程式時，代理程式會針對 SAP Host Agent 指標，結合 Cloud Monitoring 和 Compute Engine API 的監控資料，並將資料提供給 SAP Host Agent。

如果您使用 Google Cloud提供的下列 RHEL 或 SLES「for SAP」OS 映像檔， Google Cloud的 SAP 代理程式會與 OS 映像檔一併封裝：

• RHEL：所有「SAP 專用」映像檔
• SLES：SLES 15 SP4 for SAP 以上版本

如要瞭解 Google Cloud的 Agent for SAP 支援的作業系統，請參閱「支援的作業系統」。

如要在 Bare Metal 解決方案伺服器上安裝及設定 Google Cloud的 Agent for SAP 1.0 版，請參閱「在 Bare Metal 解決方案伺服器上安裝 Google Cloud的 Agent for SAP」。

安裝總覽

在 Linux 上，您可以使用標準作業系統套件管理指令安裝 Google Cloud的 SAP 代理程式：在 RHEL 上使用 yum 指令，在 SLES 上使用 zypper 指令。套件管理指令會完成下列工作：

• 下載 Google Cloud的 Agent for SAP。
• 將代理程式設為 Linux systemd 服務，並命名為 google-cloud-sap-agent。
• 啟用並啟動服務 google-cloud-sap-agent。

在 Windows 上，您可以使用 GooGet 套件管理指令 googet 安裝 Google Cloud的 SAP 代理程式。套件管理指令會完成下列工作：

• 下載 Google Cloud的 Agent for SAP。

• 建立名為 google-cloud-sap-agent 的 Windows 服務，以及每分鐘執行一次的排程工作，以便檢查服務是否仍在執行，並視需要重新啟動服務。

代理程式的先決條件

安裝 Google Cloud的 SAP 代理程式前，請務必確認已符合下列先決條件。

設定必要的 IAM 角色

Google Cloud的 SAP 代理程式所使用的服務帳戶至少必須具備Compute 檢視者 (roles/compute.viewer)、監控檢視者 (roles/monitoring.viewer) 和 Workload Manager 深入分析寫入者 (roles/workloadmanager.insightWriter) 角色。

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

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

   前往身分與存取權管理頁面

2. 選取 Google Cloud 專案。

3. 找出您想新增角色的服務帳戶。

   • 如果服務帳戶不在主體清單中，表示尚未獲派任何角色。按一下「Add」，然後輸入服務帳戶的電子郵件地址。
   • 如果服務帳戶已在使用者清單中，表示已獲指派角色。找到要編輯的服務帳戶，然後按一下「編輯」按鈕。

4. 從可用角色清單中選取必要角色：

   • Compute Engine > Compute 檢視器
   • Monitoring > Monitoring Viewer
   • Workload Manager > Workload Manager 深入分析資訊寫入者

5. 按一下 [Add] (新增) 或 [Save] (儲存)，即可將角色套用到服務帳戶。

啟用 Google Cloud API 存取權

Compute Engine 建議您設定運算執行個體，允許所有 Cloud API 的所有存取權範圍，並僅使用執行個體服務帳戶的 IAM 權限來控管資源存取權。 Google Cloud 詳情請參閱「建立使用使用者管理服務帳戶的 VM」。

如果您限制 Cloud API 存取權， Google Cloud的 SAP 代理程式就需要在主機 Compute Engine 執行個體上設定下列最低 Cloud API 存取範圍：

• Cloud Platform：已啟用
• Compute Engine：唯讀
• Stackdriver Monitoring API：唯讀

如果您要在沒有外部 IP 位址的運算執行個體上執行 SAP 應用程式，就必須在運算執行個體的子網路上啟用私人 Google 存取權 ，讓 Google Cloud的 SAP 代理程式可以存取 Google API 和服務。如要在子網路中啟用私人 Google 存取權，請參閱「設定私人 Google 存取權」。

安裝代理程式

建議您安裝 Google Cloud的最新版 SAP 代理程式，以便支援更多功能。如需操作說明，請參閱「在 Compute Engine 執行個體上安裝及設定 Google Cloud的 Agent for SAP」。

如要安裝 Google Cloud的 Agent for SAP 1 版，請洽詢 Cloud 客戶服務團隊。

安裝 Google Cloud的 Agent for SAP 和 SAP Host Agent 後，請按照「驗證代理程式安裝狀態」一節所述，驗證 Google Cloud的 Agent for SAP 安裝作業。

驗證代理程式安裝狀態

如要確認代理程式是否正在執行，請選取您的作業系統，然後按照步驟操作：

如果代理程式未執行，請重新啟動代理程式。

確認 SAP Host Agent 正在接收指標

如要確認Google Cloud的 Agent for SAP 是否收集基礎架構指標，並正確傳送至 SAP Host Agent，請按照下列步驟操作：

1. 在 SAP 系統中輸入交易 ST06。

2. 在「Overview」(總覽) 窗格中，查看以下欄位的可用性和內容，確認 SAP 和 Google 監控基礎架構已做好正確的端對端設定：

   • 雲端服務供應商：Google Cloud Platform
   • Enhanced Monitoring Access (強化版監控功能存取權)：TRUE
   • Enhanced Monitoring Details (強化版監控功能詳細資料)：ACTIVE

在 Linux 上設定 Google Cloud的 Agent for SAP

安裝 Google Cloud的 SAP 代理程式後，您可以視需要設定代理程式，收集程序監控指標和工作負載管理工具評估指標。根據預設，系統只會收集 SAP Host Agent 指標。

只有 Linux 支援收集程序監控指標和 Workload Manager 評估指標。

如果您啟用程序監控指標和 Workload Manager 評估指標收集功能，主機運算執行個體的服務帳戶必須包含 IAM 監控指標寫入者 (roles/monitoring.metricWriter) 角色。

如果您使用 Secret Manager 來儲存 SAP HANA 資料庫密碼，請確認主機運算執行個體的服務帳戶具有 IAM Secret Manager 密鑰存取者 (roles/secretmanager.secretAccessor) 角色。

主機運算執行個體的存取權範圍必須具備寫入權限，才能將指標資料發布至您的 Google Cloud 專案。建立新的 Compute Engine 運算執行個體時，系統會自動為該執行個體設定寫入存取範圍 https://www.googleapis.com/auth/monitoring.write。

設定必要的 IAM 角色

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

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

   前往身分與存取權管理頁面

2. 選取 Google Cloud 專案。

3. 找出您想新增角色的服務帳戶。

   • 如果服務帳戶不在主體清單中，表示尚未獲派任何角色。按一下「Add」，然後輸入服務帳戶的電子郵件地址。
   • 如果服務帳戶已在使用者清單中，表示已獲指派角色。找到要編輯的服務帳戶，然後按一下「編輯」按鈕。

4. 從可用角色清單中選取必要角色：

   • Monitoring > Monitoring 指標寫入者
   • Secret Manager > Secret Manager 密鑰存取者

5. 按一下 [Add] (新增) 或 [Save] (儲存)，即可將角色套用到服務帳戶。

啟用程序監控指標和 Workload Manager 評估指標收集功能

如要啟用 Process Monitoring 指標和 Workload Manager 評估指標收集作業，請按照下列步驟操作：

1. 建立與主機運算執行個體的 SSH 連線。

2. 開啟以下設定檔：

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

3. 在 collection_configuration 部分中，將下列參數設為 true：

   • collect_process_metrics：讓代理程式收集 Process Monitoring 指標。如要收集 SAP HANA 資料庫指標，您需要在 hana_metrics_config 部分設定其他參數，才能存取及查詢 SAP HANA 資料庫。
   • collect_workload_validation_metrics：讓代理程式收集 Workload Manager 評估指標。

   如要進一步瞭解參數，請參閱下表。

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

5. 儲存設定檔。

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

   sudo systemctl restart google-cloud-sap-agent

設定參數

下表說明 Google Cloud的 Agent for SAP 1.0 版的設定參數。

預設設定

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

範例設定

如要在 Compute Engine 執行個體上安裝代理程式，所有設定參數和值皆為選用項目。如果未修改設定檔，系統會使用預設設定。以下範例顯示在運算執行個體上安裝代理程式的完整設定檔。

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
      }
    }
}

查看收集的指標

如要以視覺化方式呈現代理程式收集的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。

安裝資訊主頁

如要安裝自訂資訊主頁，請完成下列步驟：

查看已安裝的資訊主頁

如要查看已安裝的資訊主頁，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Monitoring」頁面：

   前往「Monitoring」頁面

2. 在 Monitoring 導覽面板中，按一下「Dashboards」。

3. 按一下清單中的資訊主頁名稱。

如果您有許多資訊主頁，可以篩選自訂資訊主頁或新資訊主頁的名稱。如要進一步瞭解如何篩選這份名單，請參閱「查看自訂資訊主頁」一文。

以下圖片為範例，顯示 Monitoring 中 SAP HANA 指標的自訂資訊主頁部分。

疑難排解

如要進一步瞭解如何診斷及解決安裝及設定 Google Cloud的 Agent for SAP 時可能遇到的問題，請參閱 Google Cloud的 Agent for SAP 疑難排解指南。

取得支援

如果您需要協助解決Google Cloud的 Agent for SAP 相關問題，請收集所有可用的診斷資訊，然後與 Cloud Customer Care 團隊聯絡。如要瞭解如何與 Customer Care 聯絡，請參閱「取得 SAP 支援 Google Cloud」一文。