Google Cloud 的 Agent for SAP 診斷資訊

如果問題與Google Cloud的 Agent for SAP 3.8 版 (最新版)有關，請盡快向 Cloud Customer Care 提供下列診斷資訊：

• 問題的完整詳細說明。
• 代理人的支援套件。
• 代理程式收集的最新資料。
• 代理程式的設定檔。
• 代理程式的記錄檔。

問題的詳細說明

提供完整且詳細的問題說明，包括代理程式版本，以及問題發生的日期和時間。

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

支援套件

支援套件是 Google Cloud的 SAP 服務專員提供的資訊集合，可協助客戶服務團隊為您提供疑難排解支援服務。這項功能適用於 Google Cloud的 SAP Agent 2.1 以上版本。

從代理程式 3.4 版開始，您可以使用 result-bucket 選項上傳 supportbundle 指令的輸出內容。為此，您必須確保服務帳戶具備下列 IAM 權限：storage.objects.create。

支援套件內含的內容

• 代理程式的記錄和設定檔。

  從代理程式 3.0 版開始，這包括與代理程式的 Backint 和磁碟快照 功能相關的記錄和設定檔。

• 指定主機名稱和 SID 的 SAP HANA 追蹤記錄和拓樸檔案。

• SAP HANA 設定檔和記錄的 Cloud Storage Backint 代理程式。

• 針對 RHEL 上的高可用性 (HA) 叢集，當您指定 pacemaker-diagnosis="true" 時，sosreport 的輸出內容會儲存在以下目錄中：/tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP。如果 sosreport 指令執行失敗，crm_report 的輸出內容會儲存在指定的目錄中。

• 針對 SUSE 上的 HA 叢集，當您指定 pacemaker-diagnosis=true 時，hb_report 和 supportconfig 公用程式的輸出內容會儲存在以下目錄：/tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP。如果執行這些公用程式失敗，hb_report 和 crm_report 的輸出內容會儲存在指定的目錄中。

• /var/log/messages 檔案，可提供有關 Linux 系統作業的實用資訊。

• 從代理程式 3.8 版開始，預設會納入 sapdiscovery.json 檔案。這個檔案包含在運算執行個體上執行的 SAP 產品和相關元件相關資訊。這項資訊可讓客戶服務團隊更瞭解 SAP 系統的角色和設定。

  如要讓服務專員收集這項資訊，您必須符合下列規定：

  • 在代理程式設定檔中指定 "log_to_cloud": true。
  • 將 logging.logEntries.list IAM 權限授予服務帳戶 (由代理程式使用)。

• 從代理程式 3.8 版開始，當您指定 metrics 選項時，套件會包含預先定義 SAP 事件發生的次數，以及Process Monitoring 指標和 SAP HANA Monitoring 指標在特定時間範圍內的值變化。

  • 如要讓代理程式從 Cloud Logging 記錄中收集預先定義的 SAP 事件發生情形相關資訊，您必須滿足下列要求：
    • 在代理程式設定檔中指定 "log_to_cloud": true。
    • 將 logging.logEntries.list IAM 權限授予服務帳戶 (由代理程式使用)。
  • 如要讓代理程收集 Cloud Monitoring 中指標值變更的相關資訊，您必須符合下列條件：
    • 在代理程式設定檔中指定 "send_metrics_to_monitoring": true。
    • 將下列 IAM 權限授予服務帳戶 (代理程式使用)：monitoring.metricDescriptors.get、monitoring.metricDescriptors.list、monitoring.monitoredResourceDescriptors.get、monitoring.monitoredResourceDescriptors.list 和 monitoring.timeSeries.list。
  • 代理程式篩選 Cloud Logging 記錄和 Cloud Monitoring 項目的時間範圍，取決於下列選項的行為：
    • timestamp：時間戳記，格式為 YYYY-MM-DD HH:MM:SS，用於收集關於預先定義 SAP 事件類型發生情形和指標值變更的資訊。預設值為執行 supportbundle 指令的時間。
    • before-duration：在 timestamp 之前的秒數，在此期間，代理程式會搜尋預先定義的 SAP 事件發生情形，以及指標值的變更。預設值為 3600 秒。
    • after-duration：在 timestamp 後的秒數，在此期間，代理程式會搜尋預先定義的 SAP 事件發生情形，以及指標值的變更。預設值為 1800 秒。

  • 收集到的資訊會分門別類，放入各個資料夾中，每個資料夾都包含 JSON 檔案，分別對應到發生的每個 SAP 事件類型，以及變更其值的每個指標。以下是輸出內容的範例：

    supportbundle/
    |--- process_metrics/
      |--- pm_sap_control_cpu_utilization.json
      |--- pm_sap_control_memory_utilization.json
    |--- hana_monitoring_metrics/
      |--- hm_sap_hanamonitoring_disk_readtime.json
      |--- hm_sap_hanamonitoring_disk_writetime.json
    |--- sap_events/
      |--- se_HA_Availability.json
      |--- se_HA_Replication.json

產生支援軟體包

如要為在 Linux 上執行的代理程式執行個體產生支援套件，請在運算執行個體上執行下列指令：

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

更改下列內容：

• SID：您的 SAP 系統 ID。
• INSTANCE_NUMBERS：您要為其產生支援套件的 SAP 執行個體編號。

  如要指定多個例項編號，請使用空格分隔。例如：00 11 22。如果您指定兩個以上的 SAP 例項編號，指令會為指定的例項產生一個結合的支援套件。

• HOST_NAME：執行指令的主機名稱。
• BOOLEAN_VALUE：值 true 或 false，用於決定是否執行心律調節器相關診斷；預設值為 false。
• BUCKET_NAME：您要上傳 supportbundle 指令輸出的 Cloud Storage 值區名稱。
• TIMESTAMP：時間戳記，以 YYYY-MM-DD HH:MM:SS 格式表示，您可以使用這個時間戳記收集關於預先定義 SAP 事件類型發生情形和指標值變更的資訊。預設值為執行 supportbundle 指令的時間。
• BEFORE_DURATION：在 timestamp 選項值之前的秒數，代理程式會在這個時間內搜尋預先定義的 SAP 事件發生情形，以及指標值的變更。預設值為 3600 秒。
• AFTER_DURATION：在 timestamp 選項值後的秒數，在此期間內，代理程式會搜尋預先定義的 SAP 事件發生次數和指標值變更。預設值為 1800 秒。

代理程式最近收集的資料

請提供代理程式收集的最新資料。將客服專員收集到的最新資料儲存到檔案中，然後將檔案附加到支援案件。

如要查看代理程式收集的最新資料，請完成下列步驟：

設定檔

移除 SAP HANA 資料庫使用者名稱和密碼等憑證後，請提供 Google Cloud的 SAP 代理程式設定檔。

如要找出代理程式的設定檔，請前往以下路徑：

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

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

記錄檔

提供 Google Cloud的 Agent for SAP 記錄檔。

如要找出代理程式的記錄檔，請前往以下路徑：

/var/log/google-cloud-sap-agent.log

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