版本 1：Google Cloud 的 SAP 作業代理程式指南

本指南將說明在 Compute Engine 虛擬機器執行個體、Compute Engine 裸機執行個體和裸機解決方案伺服器上，執行Google Cloud的 Agent for SAP 1 版的作業考量和程序。

瞭解代理程式生命週期

管理 Google Cloud的 SAP 代理程式作業時，瞭解代理程式的運作方式很有幫助。一般而言，監控代理程式的運作方式如下：

  • 您必須在每個代管 SAP 系統的 Compute Engine 執行個體或 Bare Metal 解決方案伺服器上安裝 Google Cloud的 Agent for SAP。代理程式會以 Linux 服務或 Windows 服務執行。
  • 在 Compute Engine 執行個體上，代理程式會結合來自 Monitoring 和 Compute Engine API 的監控資料。
  • 在 Bare Metal 解決方案伺服器上，如果只收集 SAP Host Agent 指標，代理程式就不會存取 Google Cloud API。
  • 透過 HTTP，SAP Host Agent 會輪詢 Google Cloud的 Agent for SAP，取得快取資料。此代理程式會匯總 SAP Host Agent 指標、回報這些指標，並將指標儲存在 SAP NetWeaver 資料庫中。
  • SAP 的交易 ST06 或 saposcol 指令列介面會顯示匯總的 SAP Host Agent 指標。
  • 您可以在終端機視窗中執行指令，查看 Google Cloud的 Agent for SAP 中的 SAP Host Agent 指標。

確認代理程式是否正在執行

安裝或重新啟動代理程式後，您可以確認代理程式是否正常運作。

如要確認代理程式是否正在執行，請按照下列步驟操作：

Linux

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

  2. 執行下列指令：

    systemctl status google-cloud-sap-agent

    如果代理程式運作正常，輸出內容就會包含 active (running)。例如：

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

  1. 使用遠端桌面協定連線至 Compute Engine 執行個體。

  2. 以管理員身分在 PowerShell 中執行下列指令：

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
     如果代理程式正在執行，狀態會顯示 Running。

如果 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

查看受監控的指標

安裝或更新 Google Cloud的 Agent for SAP 設定後，您就能查看受監控的 SAP Host Agent 指標。

如要查看受控的 SAP Host Agent 指標，請按照下列步驟操作：

Linux

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

  2. 執行下列指令：

    curl http://localhost:18181

    如果指標可用，您應該會收到 XML 輸出內容，其中包含系統相關資訊。例如：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

  1. 使用遠端桌面協定連線至 Compute Engine 執行個體。

  2. 以管理員身分在 PowerShell 中執行下列指令：

    (Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

    如果指標可用，您應該會看到 XML 輸出內容，其中包含系統相關資訊。例如：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

驗證程序監控指標和 Workload Manager 評估指標

更新設定後，請確認是否可使用 Process Monitoring 指標和 Workload Manager 評估指標。您可以在 Cloud Monitoring 中存取 Google Cloud的 SAP 代理程式所收集的指標和資訊。

如要驗證監控中的指標，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Monitoring Metrics Explorer」頁面。

    前往「Metrics Explorer」頁面

  2. 選取「Configuration」分頁。

  3. 展開「Select a metric」選單。

  4. 在「Resources」選單中，選取「VM instance」。

  5. 在「指標類別」選單中，選取「sap」。

  6. 在「指標」選單中，選取 metric: workload.googleapis.com/sap/service/active 或任何要納入圖表的新指標。

  7. 按一下 [套用]。

您應該會看到含有時間序列指標值的圖表。

重新啟動代理程式

如果 Google Cloud的 Agent for SAP 停止運作，或您更新了相關設定，請重新啟動代理程式。

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

Linux

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

  2. 請執行下列指令：

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. 與主機運算執行個體建立遠端桌面通訊協定連線。

  2. 以管理員身分在 PowerShell 中執行下列指令：

    Restart-Service -Name 'google-cloud-sap-agent' -Force

從 SAP NetWeaver 監控代理程式升級至 Google Cloud的 Agent for SAP

安裝 Google Cloud的 SAP 代理程式會自動偵測 SAP NetWeaver 監控代理程式的舊版，並在安裝期間停用代理程式，然後從主機伺服器中移除代理程式。

如果在安裝期間偵測到 SAP NetWeaver 的監控代理程式，並找到現有的設定檔，安裝程序就會自動將現有設定遷移至 Google Cloud的 Agent for SAP。

如需安裝及設定 Google Cloud的 Agent for SAP 的操作說明，請參閱「選擇 Google Cloud的 Agent for SAP 安裝和設定指南」。

更新 Google Cloud的 Agent for SAP

本節提供檢查Google Cloud的 Agent for SAP 是否有更新版本，以及如何更新至 Google Cloud的 Agent for SAP 3.8 版 (最新版)的步驟。

如果您需要更新至非最新的代理程式版本，請與 Cloud Customer Care 團隊聯絡。

檢查更新

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

RHEL

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

  2. 請執行下列指令：

    sudo yum check-update google-cloud-sap-agent

SLES

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

  2. 請執行下列指令：

    sudo zypper list-updates -r google-cloud-sap-agent

Windows

  1. 與主機運算執行個體建立遠端桌面通訊協定連線。

  2. 以管理員身分在 PowerShell 中執行下列指令：

    googet latest google-cloud-sap-agent

安裝更新

如要將 Google Cloud的 Agent for SAP 例項更新至3.8 版 (最新版)，請選取作業系統，然後按照步驟操作。

如果您需要安裝非最新版本的代理程式，請與 Cloud Customer Care 團隊聯絡。

RHEL

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

  2. 請執行下列指令：

    sudo yum --nogpgcheck update google-cloud-sap-agent

SLES

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

  2. 請執行下列指令：

    sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

  1. 與主機運算執行個體建立遠端桌面通訊協定連線。

  2. 以管理員身分在 PowerShell 中執行下列指令：

    googet install google-cloud-sap-agent

復原至先前版本

如有需要，您可以將 Google Cloud的 Agent for SAP 1.0 版本回溯至監控代理程式 SAP NetWeaver 2.0 版本。

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

RHEL

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

  2. 請執行下列指令：

    sudo yum remove google-cloud-sap-agent

  3. 安裝 SAP NetWeaver 2 版的監控代理程式。如需安裝 SAP NetWeaver 監控代理程式的操作說明，請參閱「選擇 SAP NetWeaver 監控代理程式安裝指南」。

SLES

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

  2. 請執行下列指令：

    sudo zypper remove google-cloud-sap-agent

  3. 安裝 SAP NetWeaver 2 版的監控代理程式。如需安裝 SAP NetWeaver 監控代理程式的操作說明，請參閱「選擇 SAP NetWeaver 監控代理程式安裝指南」。

Windows

  1. 與主機運算執行個體建立遠端桌面通訊協定連線。

  2. 以管理員身分在 PowerShell 中執行下列指令：

    googet remove google-cloud-sap-agent

  3. 安裝 SAP NetWeaver 2 版的監控代理程式。如需安裝 SAP NetWeaver 監控代理程式的操作說明，請參閱「選擇 SAP NetWeaver 監控代理程式安裝指南」。

在 Cloud Logging 中查看代理程式記錄

根據預設， Google Cloud的 Agent for SAP 記錄會從 Compute Engine 執行個體和 Bare Metal 解決方案伺服器重新導向至 Cloud Logging。

如要在「記錄」中查看代理程式的記錄，請按照下列步驟操作：

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

    前往「Logs Explorer」(記錄檔探索工具)

  2. 前往「Query」窗格。

  3. 從「Resources」下拉式選單中選取「Global」，然後按一下「Apply」。

  4. 在查詢編輯器中輸入 google-cloud-sap-agent。

  5. 點選「執行查詢」

您會看到在所有 Compute Engine 執行個體或 Bare Metal 解決方案伺服器上執行的代理程式執行個體產生的記錄。如要篩選特定機器的記錄，請使用介面提供的篩選器。

您可以停用代理程式記錄的預設重新導向功能。步驟如下：

  1. 與 Bare Metal Solution 伺服器的代管 Compute Engine 執行個體建立 SSH 連線。

  2. 開啟以下設定檔：

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

  3. 針對參數 log_to_cloud，將值更新為 false。

  4. 儲存設定檔。

  5. 重新啟動代理程式，讓這項變更生效。