本指南說明如何在 Mainframe Connector 中啟用及收集效能計數器追蹤記錄。
總覽
在 Mainframe Connector 作業期間 (例如資料集轉碼、Cloud Storage 上傳和 BigQuery 資料載入)，效能計數器會擷取高解析度的執行指標和執行緒層級的狀態資料。您可以使用計數器追蹤記錄，診斷效能瓶頸、記憶體或佇列回壓、執行緒封鎖、網路或 I/O 限制，以及大型主機系統資源用量。
擷取的主要指標
效能計數器追蹤記錄包含內部指標的高頻率樣本，例如：
- 工作者狀態追蹤：在
active、queue_blocked、io_blocked、compressing和hashing狀態中花費的時間。 - I/O 和處理量：讀取和寫入的位元組數、傳輸處理量，以及區塊轉碼率。
- 佇列動態：執行管道各階段的緩衝區和工作站佇列大小。
- 系統指標：與奈秒精確度時間戳記相關的低階作業時間。
效能計數器追蹤記錄只會收集執行中繼資料和時間統計資料。不會收集資料集內容、顧客記錄或個人識別資訊 (PII)。
啟用效能計數器
效能計數器預設為停用。如要啟用這些功能，請在執行 Mainframe Connector 工作前，將 MFC_PERF_FILE 環境變數設為目標輸出路徑。
Shell 環境
如要在 Linux 或 z/OS UNIX 系統服務的殼層環境中啟用效能計數器，請先匯出 MFC_PERF_FILE，再叫用 Mainframe Connector：
export MFC_PERF_FILE="/tmp/mfc_perf.perf"
copy binary file:/path/to/file gs://bucket/path/to/object
如要停用效能計數器收集功能，請取消設定環境變數：
unset MFC_PERF_FILE
大型主機 JCL 環境
如要為執行 Mainframe Connector 的 JCL 工作啟用效能計數器，請在 Mainframe Connector 程序或工作程序 PARM 中定義 MFC_PERF_FILE。提供自訂 PARM 時，請一併保留預設 PARM (/I+ com.google.bqsh.Bqsh)。
以下範例說明如何為 JCL 工作啟用效能計數器：
//STEP01 EXEC BQSH,PARMDD=MFCPERF
//INFILE DD DSN=HLQ.DATA.FILENAME,DISP=SHR
//COPYBOOK DD DSN=HLQ.COPYBOOK.FILENAME,DISP=SHR
//MFCPERF DD *
ENVAR("MFC_PERF_FILE=/tmp/mfc_perf.perf")/I+
com.google.bqsh.Bqsh
/*
//STDIN DD *
BUCKET=my-target-bucket-1234
gsutil cp --replace gs://$BUCKET/tablename.orc
/*
設定效能計數器
您可以使用下列環境變數，設定效能計數器記錄的取樣頻率和檔案大小上限：
| 環境變數 | 說明 | 預設值 |
|---|---|---|
MFC_PERF_FILE |
寫入效能計數器指標的路徑。 如果未設定或空白，系統會停用效能計數器收集功能。 | 已停用 |
MFC_PREF_COLLECTION_INTERVAL_MS |
取樣頻率 (以毫秒為單位)。指定指標排清至輸出檔案的頻率。 | 100 (0.1 秒) |
MFC_MAX_PERF_MAX_FILE_SIZE_BYTES |
輸出檔案的大小上限 (以位元組為單位)。達到上限後，系統會自動停止寫入，以免磁碟空間用盡。 | 67108864 (64 MiB) |
將計數器檔案傳送給 Google 支援團隊進行分析
效能計數器功能產生的輸出檔案 (例如 /tmp/mfc_performance.perf) 會格式化為二進位資料集，內含結構化指標結構定義和評估記錄。這不是人類可解讀的純文字，無法直接使用標準記錄檢視器評估。
輸出檔案需要使用 Google 內部分析工具和專用指標視覺化工具，才能解碼狀態轉換和佇列深度圖表。如要分析成效資料，請將產生的檔案提交給Google Cloud 支援團隊或技術客戶經理。
如果開啟的客服案件與效能問題、轉碼輸送量緩慢或作業時間超出預期有關，請按照下列步驟操作：
- 將
MFC_PERF_FILE設為有效路徑 (例如/tmp/mfc_perf.perf)。 - 在效能監控下執行作業，重現問題。
- 從指定路徑擷取產生的
.perf檔案。 - 將
.perf檔案和工作記錄附加至Google Cloud 支援案件，交由 Google 工程師評估。