收集 SAP 工作負載效能相關的診斷資訊

本指南說明如何使用 Google Cloud的 Agent for SAP (3.4 以上版本)，收集 SAP 工作負載的效能診斷資訊。

當您向 Cloud 客戶服務團隊尋求協助，排解 SAP 工作負載的效能問題時，請提供工作負載的相關診斷資訊。您可以使用代理程式內建的效能診斷工具，自動收集必要的診斷資訊，進而加快疑難排解作業。

如要瞭解代理程式可為 SAP 工作負載執行的效能診斷，請參閱「工作負載效能診斷」。

事前準備

收集成效診斷資訊

如要收集 SAP 工作負載的效能診斷資訊，請使用 performancediagnostics 指令叫用代理程式工具：

sudo /usr/bin/google_cloud_sap_agent performancediagnostics \
    --type="COMMA_SEPARATED_DIAGNOSTIC_TYPES" \
    --test-bucket=STORAGE_BUCKET_NAME \
    --backint-config-file=BACKINT_CONFIG_FILE_PATH \
    --output-file-name=OUTPUT_FILE_NAME \
    --output-file-path=OUTPUT_FILE_PATH

更改下列內容：

  • COMMA_SEPARATED_DIAGNOSTIC_TYPES：您要執行的診斷類型。
  • STORAGE_BUCKET_NAME：工具必須使用此 Cloud Storage 名稱來執行 backup 診斷。
  • BACKINT_CONFIG_FILE_PATH：所需 Backint 設定檔的路徑。
  • OUTPUT_FILE_NAME：輸出 ZIP 檔案的名稱，其中包含 SAP 工作負載的診斷資訊
  • OUTPUT_FILE_PATH：您希望效能診斷工具儲存輸出 ZIP 檔案的目錄路徑。如果指定的路徑不存在，系統會建立該路徑。

如要瞭解這個指令支援的參數，請參閱「支援的參數」。

支援的參數

下表說明可與 performancediagnostics 指令搭配使用的參數：

參數 說明
type STRING

指定要執行的診斷類型 (以半形逗號分隔)。以下是支援的診斷類型：

  • backup：針對 SAP HANA 工作負載執行 Backint 功能的自我診斷和 gsutil perfdiag 診斷。
  • IO：執行輸入/輸出診斷功能，這項功能會使用彈性 I/O 測試器 (FIO)。這項測試會針對工作負載儲存系統的 I/O 能力執行壓力測試。並執行工作負載模擬，評估工作負載基礎架構 (例如磁碟和網路檔案系統) 的效能。
  • all：執行工具支援的所有按需和預設診斷功能。

    • 如果您要執行 IO 或 all 診斷工具，請務必確保在電腦執行個體上安裝 FIO 工具。您可以在 RHEL 上執行 sudo yum install fio，在 SLES 上執行 sudo zypper install fio，即可安裝這項工具。

如要進一步瞭解支援的診斷功能，請參閱「工作負載效能診斷功能」。
backint-config-file String

如果您要執行 backup 診斷工具，請指定 Backint 設定檔的路徑。例如：/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS.json。

如要執行 backup 診斷工具，您必須至少指定下列其中一個參數：backint-config-file 或 test-bucket。

如果您使用的是資料、記錄或目錄備份的個別設定檔，請指定與您要收集診斷資訊的備份類型相對應的路徑。
test-bucket String

如要執行 backup 診斷，請指定工具必須用來測試上傳及下載 Cloud Storage 檔案的 Cloud Storage 值區名稱。例如：mybucket。確認用於測試的值區未設定保留政策。

如要執行 backup 診斷工具，您必須至少指定下列其中一個參數：backint-config-file 或 test-bucket。如果您為兩個參數都指定值，工具就會使用為 test-bucket 指定的值。
output-bucket String

(非必要) 指定您要上傳成效診斷工具輸出內容的 Cloud Storage 值區名稱。例如：mytestbucket。這個工具會在這個值區中建立名為 `performancediagnostics` 的資料夾，用來儲存輸出檔案。

如果未指定此參數，工具會將輸出內容儲存至目錄，而該目錄的名稱取決於您是否指定 output-file-path 參數。

如要讓工具將輸出內容上傳至 Cloud Storage，代理程式使用的服務帳戶必須指派 Storage 物件使用者 (roles/storage.objectUser) IAM 角色。如果您使用代理程式的 Backint 功能，服務帳戶就會具備基礎權限。
output-file-name String

(非必要) 指定效能診斷工具建立的輸出 ZIP 檔案名稱。

根據預設，ZIP 檔案的名稱為 performance-diagnostics-TIMESTAMP，其中 TIMESTAMP 是工具建立 ZIP 檔案的日期和時間。
output-file-path String

(非必要) 指定效能診斷工具要儲存輸出 ZIP 檔案的目錄路徑。如果指定的路徑不存在，系統會建立該路徑。

根據預設，ZIP 檔案會儲存在 /tmp 目錄中。
hyper-threading String

(非必要) 指定要為 Compute Engine 裸機機器類型 (例如 X4) 設定超執行緒設定。預設值為 on。支援的值為 on 和 off。
log-level String

(非必要) 設定執行效能診斷期間的代理程式記錄層級。預設值為 info。支援的值為 debug、info、warn 和 error。

工具執行的作業會擷取下列檔案中的診斷資訊：/var/log/google-cloud-sap-agent/performancediagnostics.log。

查看記錄

執行 performancediagnostics 指令時，系統會將執行的作業記錄在下列檔案中：/var/log/google-cloud-sap-agent/performancediagnostics.log。

後續步驟

產生效能診斷工具的輸出內容後，請將其傳送給客戶服務團隊。這有助於客戶服務團隊加快排除 SAP 工作負載的效能問題。