使用效能評測器

本節描述效能評測器圖形化使用者介面的功能，以及如何使用這些功能。相關資訊編排如下：

• 指定效能評測器選項

• 使用 IDM 效能評測器檢視

• 使用快照檢視

• 使用快顯功能表選項

• 搜尋快照

• 儲存快照

指定效能評測器選項

[效能評測器選項] 對話方塊包含下列標籤：

• 模式

• IDM 物件篩選器

• Java 篩選器

• 其他

使用這些標籤上的選項以指出要評測效能的物件及設定檔中要顯示的元素。

指定效能評測器選項之後，請按一下 [確定] 以啟動效能評測器。效能評測器可根據專案配置執行下列兩項作業其中之一：

• 如果搭配內嵌式 Identity Manager 實例使用一般 Identity Manager 專案，效能評測器會執行完整建置、在 NetBean 的應用程式伺服器中進行部署，以及啟動效能評測器。

• 如果搭配外部 Identity Manager 實例使用一般 Identity Manager 專案或使用遠端 Identity Manager 專案，效能評測器會附加至為此專案配置的 Identity Manager 實例。

您可以選取 [IDM] -> [設定 Identity Manager 實例]，以控制此專案的 Identity Manager 實例動作。

模式

[模式] 標籤提供下列選項：

• 僅限 IDM 物件：選取此選項可評測表單、規則、工作流程與 XPRESS 物件的效能。排除設定檔中的 Java 物件。

• Java 與 IDM 物件：選取此選項可評測表單、Java、規則、工作流程與 XPRESS 物件的效能。

  ---

  備註 –

  • 如果搭配外部 Identity Manager 實例使用一般 Identity Manager 專案或使用遠端 Identity Manager 專案，則無法使用 [Java 與 IDM 物件] 選項。

  • 效能評測器執行時，無法變更 [模式] 選項。您必須停止效能評測器才能變更此選項。

  ---

IDM 物件篩選器

[IDM 物件篩選器] 標籤提供下列選項：

• 顯示 IDM 物件詳細資訊

  • 選取此核取方塊可在快照中包含每個執行的表單、工作流程與 XPRESS 元素。

  • 清除此核取方塊僅會在快照中包含下列元素：

    • <invoke>

    • <new>

    • <Rule>

    • <Form>

    • <WFProcess>

    • <ExScript>

    • <ExDefun>

    • <FieldRef>

    • <Action> (適用於工作流程應用程式圖說文字)

• 包含匿名來源

  ---

  備註 –

  匿名來源是動態產生的表單或表單的一部分 (例如 Login 表單與 MissingFields 表單)，與 Identity Manager 儲存庫中的永久性表單有所不同。

  ---

  • 選取此核取方塊可在快照中包含匿名來源。

  • 清除此核取方塊可排除快照中的匿名來源。

Java 篩選器

選取 [Java 篩選器] 標籤可執行下列作業：

• 包含或排除 Java 篩選器

• 建立新的篩選器

• 刪除現有的篩選器

• 復原預設的篩選器

Java 篩選器會依方法式樣提供，並以包含或排除的式樣來表示 (根據標準方法名稱)。其中標準方法名稱為：

fully-qualified-class-name.method-name( parameter-type-1, parameter-type-2, ... )

若是建構子，則 method-name 為 <init>。

下列是一些範例：

• 若要排除所有建構子，請啟用 [排除] 方塊並增加下列篩選器：

  *.<init>(*)

• 若要排除所有含單一 org.w3c.dom.Element 參數的建構子，請啟用 [排除] 方塊並增加下列篩選器：

  *.<init>(org.w3c.dom.Element)

• 若要排除所有 Identity Manager 類別，請啟用 [排除] 方塊並增加下列篩選器：

  "com.waveset.*"
  "com.sun.idm.*"

• 若僅要執行自訂的程式碼，請啟用 [排除] 方塊，移除初始 * include 篩選器，然後增加下列篩選器：

  "com.yourcompany.*"

由於篩選器僅會套用至自訂類別與 Identity Manager 類別，因此最後兩個範例目前是等同的。

請視需要適當修改 build.xml 中的下列各行，以執行其他 JAR。例如，

<instrument todir="${lighthouse-dir-profiler}/WEB-INF" 
verbose="${instrumentor.verbose}" includeMethods="${profiler.includes}" 
excludeMethods="${profiler.excludes}">
           <fileset dir="${lighthouse-dir}/WEB-INF">
               <include name="lib/idm*.jar"/>
               <include name="classes/**/*.class"/>
           </fileset>
</instrument>

依預設，配置會包含所有自訂類別與大部分的 Identity Manager 類別。由於某些 Identity Manager 類別在啟用後會中斷效能評測器，因此會強制排除這些類別。

例如，會排除來源為工作流程、表單與 XPRESS 引擎的類別，否則效能評測器在評測 Java 與 Identity Manager 物件的效能時會產生無法辨識的快照。

請注意，Java 篩選器會提供比 IDM 物件篩選器更仔細的篩選。Java 方法會使執行作業增加大量的經常性耗用時間，從而嚴重影響效能評測結果。由於是對 Identity Manager 物件進行解譯而不是編譯，因此可忽略執行此方法所耗用的時間。因此，基本上排除工作流程 A 而包含工作流程 B 是不必要的，依此類推。

您無法在執行效能評測器時修改 Java 篩選器。您必須停止效能評測器，才能變更 Java 篩選器。

其他

[其他] 標籤提供下列選項：

• 刪除執行時間為 0 的快照節點：

  • 若要快照包含所有執行實體的呼叫資訊，甚至包含執行時間為零的執行實體時，請停用此選項 (預設值)。

    取得呼叫數 (甚至沒有執行時間) 可能很實用。

  • 啟用此選項可移除這些節點，讓您專注在最相關的效能評測資料上。此外，啟用此選項可顯著減小效能評測器快照的大小。

• 在效能評測器啟動時自動開啟瀏覽器：

  • 當您要在啟動效能評測器時自動開啟瀏覽器，並指向要接受效能評測的 Identity Manager 實例時，請啟用此選項 (預設值)。

  • 若不要開啟檔案總管，請停用此選項。

• 在快照中包含 Java 來源：

  • 啟用此選項 (預設值) 可針對快照中效能評測資料參照的所有 Java 方法，包含其 Java 來源。您應該一律在欄位中使用此快照設定。自訂 Java 相對較小，而且在提供支援方面極有價值。

  • 僅在評測 Identity Manager 的效能並具有完整的 Identity Manager 來源時，停用此選項。

    在此情況下，由於 Identity Manager 來源會建立極大的快照，因此請勿包含此來源。(如需更多資訊，請參閱效能評測器查找及管理來源的方式。)

使用 IDM 效能評測器檢視

IDM 效能評測器檢視包含下列區域：

• 目前的專案區域

• 控制區域

• 狀態區域

• 效能評測結果區域

• 已儲存的快照區域

目前的專案區域

[目前的專案] 區域包含列出所有目前專案的下拉式功能表。使用此功能表可選取要評測其效能的專案。

控制區域

[控制] 區域包含四個圖示，如下表所述：

狀態區域

[狀態] 區域會報告是否已連線至主機，並提供效能評測器啟動、執行與停止的狀態資訊。

效能評測結果區域

[效能評測結果] 區域包含兩個圖示，如下表所述：

已儲存的快照區域

[已儲存的快照] 區域提供所有儲存的快照清單。

儲存快照提供儲存快照的說明。

此外，您可以使用下列按鈕管理這些快照：

• 開啟：按一下此按鈕，即可在 [快照檢視] 視窗中開啟已儲存的快照。

  ---

  提示 –

  您也可以在 [已儲存的快照] 清單中的快照上連按兩下，以開啟此快照。

  ---

• 刪除：選取 [已儲存的快照] 清單中的快照，然後按一下此按鈕以刪除選取的快照。

• 另存新檔：選取清單中的快照，然後按一下此按鈕以將此快照儲存至任意的外部位置。

• 載入：按一下此按鈕，即可在 [快照檢視] 視窗中開啟任意位置的快照。

使用快照檢視

當您開啟快照時，Identity Manager IDE 右上方的 [快照檢視] 視窗會顯示結果。

快照提供數種資料的檢視，以下各節將對此進行描述：

• 呼叫樹狀結構檢視

• Hotspots 檢視

• Back Traces 檢視

• 被呼叫端檢視

呼叫樹狀結構檢視

[呼叫樹狀結構檢視] 包含樹狀結構表格，顯示整個系統的呼叫計時及呼叫計數。

此樹狀結構表格包含三欄：

• [Call Tree] 欄：列出所有節點。

  頂層節點為下列其中之一：

  • 系統中各種背景執行緒的 Thread.run() 方法

    例如，若啟用 Java 效能評測，將會看到 ReconTask.WorkerThread.run() 方法。

  • 請求計時

    例如，若檢視 idm/login.jsp URL，將會看到 idm/login.jsp 的頂層項目。針對此項目，[Time] 欄中所顯示的資料表示請求的總時間。[Invocations] 欄中顯示的資料表示呼叫此頁面的總次數。您可以接著進一步研究此資料，以找出造成耗用這些時間的呼叫項目。

  ---

  備註 –

  [呼叫樹狀結構] 也包含 [Self Time] 節點。[Self Time] 值表示節點本身會耗用的時間。(如需更多資訊，請參閱統計注意事項。)

  ---

• [Time] 欄：列出從父系節點呼叫每個節點所耗用的時間，並指出與父系時間相較的百分比。

• [Invocations] 欄：列出父系節點呼叫每個節點的次數。

Hotspots 檢視

[Hotspots 檢視] 提供直列式節點清單，顯示所有父系節點的集合呼叫計時。

此檢視包含下列欄：

• Self Time：列出每個節點所耗用的總時間。

• Invocations：列出父系節點呼叫每個節點的總次數。

• Time：列出每個節點及其所有子節點所耗用的總時間。

Back Traces 檢視

[Back Traces 檢視] 提供顛倒的呼叫堆疊，顯示呼叫每個節點的所有來源呼叫鏈。

您可以使用這些統計回答以下問題：如果我省略此節點發出的此特定呼叫鏈，可以節省多少時間？

您可以在節點 (稱為根節點) 上按一下滑鼠右鍵，並從快顯功能表中選取 [顯示 Back Traces]，以從任何其他快照檢視存取 [Back Traces] 檢視。

[Time] 與 [Invocations] 資料值在 [Back Traces] 檢視中有不同的含義：

• Time：此欄中的值表示從指定呼叫鏈呼叫根節點時，在根節點中所費的時間。

• Invocations：此欄中的值表示從指定呼叫鏈呼叫根節點的次數。

被呼叫端檢視

[被呼叫端檢視] 提供節點 (稱為根節點) 的彙總呼叫樹狀結構，而不考慮其父鏈為何。

如果從主要呼叫樹狀結構的許多位置呼叫的區域有問題，而您想檢視節點的整體設定檔，這些統計會很有幫助。

您可以在節點 (稱為根節點) 上按一下滑鼠右鍵，並從快顯功能表中選取 [顯示被呼叫端]，以從任何其他快照檢視存取 [被呼叫端檢視]。

[被呼叫端檢視] 中所使用的 [Time] 與 [Invocations] 資料值，和 [呼叫樹狀結構] 檢視中所使用的資料值有相同含義。

使用快顯功能表選項

在 [呼叫樹狀結構檢視] 或 [Hotspots 檢視] 中任何的節點上按一下滑鼠右鍵，會隨即顯示快顯功能表，內含下表所述的選項：

搜尋快照

使用 [快照檢視] 視窗頂端的 [搜尋] 圖示 ，在呼叫樹狀結構檢視或 Hotspots 樹狀結構中依名稱搜尋節點。

或者，在 [呼叫樹狀結構檢視] 或 [Hotspots 檢視] 中的任何節點上按一下滑鼠右鍵，然後從快顯功能表中分別選取 [在呼叫樹狀結構中尋找] 或 [在 Hotspots 中尋找] 以搜尋節點。

儲存快照

效能評測器提供數個儲存快照的選項。如需這些選項的描述，請參閱下表：