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

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

瞭解代理程式生命週期

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

  • 您必須在每個代管 SAP 系統的 Compute Engine VM 執行個體或 Bare Metal 解決方案伺服器上安裝 Google Cloud的 Agent for SAP。代理程式會以 Linux 服務或 Windows 服務執行。
  • 在 Compute Engine VM 執行個體上，代理程式會結合 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 未執行，請重新啟動代理程式。

檢查代理程式版本

安裝或重新啟動 Google Cloud的 SAP 代理程式後，您可以查看代理程式的版本。

如要查看代理程式版本，請完成下列步驟：

Linux

如果是 RHEL，請按照下列步驟操作：

  1. 使用 SSH 連線至主機 Compute Engine 執行個體或 Bare Metal Solution 伺服器。
  2. 請執行下列指令：
    yum info google-cloud-sap-agent

如為 SLES，請按照下列步驟操作：

  1. 使用 SSH 連線至主機 Compute Engine 執行個體或 Bare Metal Solution 伺服器。
  2. 請執行下列指令：
    zypper info google-cloud-sap-agent

Windows

  1. 使用 RDP 連線至主機 Compute Engine 執行個體或裸機解決方案伺服器。
  2. 以管理員身分在 PowerShell 中執行下列指令：
    googet installed google-cloud-sap-agent

確認 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

查看 SAP Host Agent 指標

安裝或更新 Google Cloud的 Agent for SAP 設定後，您就可以查看收集到的 SAP 主機代理程式指標。

如要查看 Google Cloud的 SAP 代理程式收集的 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>

查看其他指標

更新 Google Cloud的 SAP 代理程式設定後，系統會收集程序監控指標、工作負載管理器評估指標或 SAP HANA 監控指標，您應查看這些指標，確認代理程式是否如預期收集指標。

如要在 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. 與主機 VM 執行個體或 Bare Metal 解決方案伺服器建立 SSH 連線。

  2. 請執行下列指令：

    sudo systemctl restart google-cloud-sap-agent

Windows

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

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

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

從其他 Google Cloud 代理程式升級至 Google Cloud的 Agent for SAP

安裝 Google Cloud的 SAP 代理程式時，系統會自動偵測較舊版本的 SAP NetWeaver 監控代理程式 和 SAP HANA 監控代理程式，並將其停用，然後在安裝期間從主機電腦中移除。

如果偵測到這些 Google Cloud 代理程式，則在安裝期間，其設定檔中的設定也會遷移至 Google Cloud的 Agent for SAP。為備份和參考用途，SAP HANA 監控代理程式的設定會複製到下列檔案：

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

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

升級支援安全資料傳輸層 (SSL) 的執行個體

如果您已將 SAP HANA 監控代理程式設定為使用 SSL 憑證與 SAP HANA 執行個體通訊，那麼在您安裝 Google Cloud的 SAP 代理程式時，SSL 設定以外的所有 SAP HANA 監控設定都會遷移至 Google Cloud的 SAP 代理程式。在這種情況下，如要使用 Google Cloud的 Agent for SAP 監控 SAP HANA 執行個體，您必須完成下列步驟：

  1. 與主機 VM 執行個體或 Bare Metal Solution 伺服器建立 SSH 連線。

  2. 開啟 Google Cloud的 Agent for SAP 設定檔：

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

  3. 在 hana_monitoring_configuration 部分中，將 enabled 參數設為 true。

  4. 在 hana_monitoring_configuration.hana_instances 部分，針對每個使用 TLS/SSL 通訊協定進行安全通訊的 SAP HANA 執行個體，執行下列操作：

    1. 指定參數 enable_ssl，並將其值設為 true。

    2. 指定參數 host_name_in_certificate，並將 TLS/SSL 憑證中指定的 SAP HANA 主機名稱設為其值。

    3. 指定 tls_root_ca_file 參數，並將 TLS/SSL 憑證的儲存路徑設為其值。

  5. 儲存設定檔。

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

    sudo systemctl restart google-cloud-sap-agent

  7. 確認代理程式是否正在收集 SAP HANA 監控指標。如需操作說明，請參閱「查看其他指標」一節。

  8. 解除安裝 SAP HANA 的監控代理程式。

如果在升級後遇到任何 SAP HANA 執行個體連線問題，您可以在「Logging」中查看代理程式記錄，並使用疑難排解指南解決問題。

更新 Google Cloud的 Agent for SAP

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

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

檢查更新

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

RHEL

  1. 與主機 VM 執行個體或 Bare Metal Solution 伺服器建立 SSH 連線。

  2. 請執行下列指令：

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

SLES

  1. 與主機 VM 執行個體或 Bare Metal Solution 伺服器建立 SSH 連線。

  2. 請執行下列指令：

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

Windows

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

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

    googet latest google-cloud-sap-agent

安裝更新

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

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

RHEL

  1. 與主機 VM 執行個體或 Bare Metal Solution 伺服器建立 SSH 連線。

  2. 請執行下列指令：

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

SLES

  1. 與主機 VM 執行個體或 Bare Metal Solution 伺服器建立 SSH 連線。

  2. 請執行下列指令：

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

Windows

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

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

    googet install google-cloud-sap-agent

改回使用 SAP HANA 監控代理程式

如果您想改回使用 SAP HANA 監控代理程式，並停止使用 Google Cloud的 Agent for SAP 提供的 SAP HANA 監控功能，請按照下列步驟操作：

RHEL

  1. 與主機 VM 執行個體或 Bare Metal Solution 伺服器建立 SSH 連線。

  2. 為避免收集重複的指標，請停用Google Cloud的 SAP 代理程式收集 SAP HANA 監控指標的功能：

    1. 開啟 Google Cloud的 Agent for SAP 設定檔：

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

    2. 在 hana_monitoring_configuration 部分，將參數 enabled 設為 false。

    3. 儲存設定檔。

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

      sudo systemctl restart google-cloud-sap-agent

  3. 從下列檔案複製 SAP HANA 監控代理程式的設定：

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. 安裝 SAP HANA 2 版的監控代理程式。如需安裝操作說明，請參閱 SAP HANA 監控代理程式 V2.0 安裝與操作指南。

  5. 在下列檔案中，貼上您在上一個步驟中複製的 SAP HANA 監控代理程式設定：

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. 重新啟動 SAP HANA 的監控代理程式：

    sudo systemctl start google-saphanamonitoring-agent

SLES

  1. 與主機 VM 執行個體或 Bare Metal Solution 伺服器建立 SSH 連線。

  2. 為避免收集重複的指標，請停用Google Cloud的 SAP 代理程式收集 SAP HANA 監控指標的功能：

    1. 開啟 Google Cloud的 Agent for SAP 設定檔：

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

    2. 在 hana_monitoring_configuration 部分，將參數 enabled 設為 false。

    3. 儲存設定檔。

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

      sudo systemctl restart google-cloud-sap-agent

  3. 從下列檔案複製 SAP HANA 監控代理程式的設定：

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. 安裝 SAP HANA 2 版的監控代理程式。如需安裝操作說明，請參閱 SAP HANA 監控代理程式 V2.0 安裝與操作指南。

  5. 在下列檔案中，貼上您在上一個步驟中複製的 SAP HANA 監控代理程式設定：

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. 重新啟動 SAP HANA 的監控代理程式：

    sudo systemctl start google-saphanamonitoring-agent

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

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

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

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

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

  2. 前往「Query」窗格。

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

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

  5. 點選「執行查詢」

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

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

  1. 與 Bare Metal Solution 伺服器的 VM 主機執行個體建立 SSH 連線。

  2. 開啟以下設定檔：

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

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

  4. 儲存設定檔。

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