Google Cloud 的 SAP NetWeaver 監控代理程式疑難排解指南

本指南說明當 SAP NetWeaver 的監控代理程式無法運作時,您可以調查的常見問題。

檢查記錄

您可以查看代理程式的記錄,開始排解 SAP NetWeaver 相關問題的監控代理程式。

請查看作業系統專屬目錄中的記錄:

Linux

/var/log/google-sapnetweavermonitoring-agent.log

Windows

C:\Program Files\Google\google-sapnetweavermonitoring-agent\logs\google-sapnetweavermonitoring-agent.log

身分與存取權管理權限不足

在 Google Cloud 控制台的 VM 執行個體詳細資料頁面中,記下 VM 服務帳戶名稱。例如:sap-example@example-project-123456.。在「IAM 與管理」首頁上,確認服務帳戶包含具備 monitoring.timeSeries.list 權限的 IAM 角色。

如果您安裝 Cloud Monitoring 代理程式 (而非 SAP NetWeaver 的監控代理程式),可能需要為 VM 服務帳戶授予其他 IAM 權限,例如預先定義的「監控指標寫入者」角色。如要確認監控代理程式所需的權限,請參閱 Cloud Monitoring 說明文件:

VM 服務帳戶的存取權範圍不正確

存取權範圍是為執行個體指定權限的傳統方法。

最佳做法是在執行個體上設定完整的 cloud-platform 存取範圍,然後透過 IAM 角色安全地限制服務帳戶的 API 存取權。例如:

  • https://www.googleapis.com/auth/cloud-platform

如果您限制 VM 的存取權範圍,則必須確保主機 VM 具有下列存取權範圍:

  • https://www.googleapis.com/auth/source.read_write
  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/servicecontrol
  • https://www.googleapis.com/auth/service.management.readonly
  • https://www.googleapis.com/auth/logging.admin
  • https://www.googleapis.com/auth/monitoring
  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/devstorage.full_control

如要變更存取權範圍,您需要停止 VM 執行個體、進行變更,然後重新啟動執行個體。如需操作說明,請參閱 Compute Engine 說明文件。在此情況下,您無須針對身分與存取權管理角色的權限進行任何變更。

SAP Host Agent 遺失或不正確

為了讓監控系統正常運作,SAP NetWeaver 系統必須安裝 SAP Host Agent,且具備 Host Agent 所需的最低修補程式等級。如需安裝 SAP Host Agent 的操作說明,請參閱 SAP 說明文件

如需 SAP Host Agent 的版本必要條件,請參閱下列 SAP 注意事項:

下載失敗

如果執行 SAP NetWeaver 監控代理程式的主機伺服器是在沒有公開 IP 位址的情況下建立,就無法下載監控代理程式。如需如何設定 NAT 閘道以提供主機伺服器網際網路傳出存取權的說明,請參閱您作業系統適用的部署指南:

無法使用通訊埠

SAP NetWeaver 的監控代理程式會在通訊埠 18181 上監聽要求。此通訊埠必須為可用狀態,否則無法啟動監控代理程式。如果不是,SAP Host Agent 記錄會顯示 Connection Refused 錯誤。請確認 SAP NetWeaver 的監控代理程式可使用通訊埠 18181。如果其他服務正在使用通訊埠 18181,您可能需要重新啟動該服務,或重新設定該服務,以便使用其他通訊埠。

缺少設定檔 ( 僅限 Bare Metal 解決方案)

主機伺服器上必須有 configuration.yaml 檔案,才能在 Bare Metal 解決方案環境中啟用 SAP NetWeaver 的監控代理程式。如果您需要在安裝 SAP NetWeaver 的監控代理程式後建立 configuration.yaml 檔案,請按照下列步驟操作:

  1. 在下列作業系統專屬目錄中建立 configuration.yaml 檔案:

    Linux

    /usr/sap/google-sapnetweavermonitoring-agent/configuration.yaml

    Windows

    C:\Program Files\Google\google-sapnetweavermonitoring-agent\configuration.yaml

  2. configuration.yaml 檔案中加入以下行:

    bare_metal: true

  3. 重新啟動 SAP NetWeaver 的監控代理程式。詳情請參閱「重新啟動 SAP NetWeaver 的監控代理程式」。

取得 SAP NetWeaver 監控代理程式的支援

如果您需要協助解決 SAP NetWeaver 監控代理程式的問題,請收集必要的診斷資訊,然後與 Cloud Customer Care 團隊聯絡。詳情請參閱「監控代理程式,用於 SAP NetWeaver 的診斷資訊」。