使用者定義的異動

「資料收集服務」及「效能探測器」會收集您在應用程式中定義的效能資料。

透過提供的 API,您可以利用「資料收集服務」將異動資料整合到定期排定的取樣資料收集中,並執行「效能探測器」來取得異動的追蹤層次資料。

有關詳細說明及用法注意事項,請參閱下列 API 說明:

註: 只需監控應用程式一次。「資料收集服務」及「效能探測器」就會使用相同的 API 呼叫,收集不同類型的效能資料。

將使用者定義的異動資料整合到資料收集服務中

您可以選取使用者定義的異動作為「資料收集服務」配置中資料收集的種類。 「資料收集服務」會在每個資料資料收集間隔收集異動資料並將該資料儲存於資料收集物件中。「建立效能資料 (CRTPFRDTA)」指令可將此資料匯出至使用者定義的異動效能資料庫檔案 QAPMUSRTNS。「資料收集服務」會依照異動類型來組織 資料。您可以指定所需之任意數目的異動類型;不過,「資料收集服務」僅會報告前 15 個異動類型。其他異動類型的資料會被合併及儲存為 *OTHER 異動類型。在每一個資料收集間隔,「資料收集服務」會對每個唯一工作的每一個異動類型建立一個記錄。 如需詳細說明,請參閱「啟動異動 API」中的用法注意事項。

「資料收集服務」收集一般異動資料,例如異動回應時間。您也可以併入最多 16 個選用性應用程式定義的計數器,來追蹤應用程式特定資料,例如用於異動的 SQL 陳述式數目或其他漸進式測量。您的應用程式應使用「啟動異動 API」來指示新異動的開端,而且應併入對應的「結束異動 API」來將異動資料傳遞至「資料收集服務」。

使用效能探測器收集使用者所定義異動的追蹤資訊

您可以在「效能探測器」階段作業期間使用「啟動、結束及記載異動」API 來建立追蹤記錄。效能探測器將現行執行緒的系統資源使用率(例如 CPU 使用率、I/O 及攫取/鎖定活動)儲存於這些追蹤記錄中。另外,您可以選擇併入應用程式特定的效能資料,然後將它傳送至每一個 API 中的「效能探測器」。您也可以使用「新增追蹤點」API 來識別「效能探測器」應收集追蹤資料的應用程式特定事件。

若要針對您的異動來啟動「效能探測器」階段作業,請對「效能探測器」定義的 (OSEVT) 參數指定 *USRTRNS。輸入 ENDPEX 指令之後,「效能探測器」會將應用程式提供的資料寫入「QAYPEMIUSR 效能探測器」資料庫檔案中的 QMUDTA 欄位。啟動、結束及任何日誌記錄之系統提供的效 能資料儲存於 QAYPEMIUSR 和 QAYPETIDX 資料庫檔案中。