要求度量效能資料
請利用這個頁面來瞭解如何解釋追蹤記錄格式中的要求度量效能資料。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
plugin_install_root/logs/web_server_name/http_plugin.log 和 install_root/profiles/profile_name/logs/server_name
plugin_install_root/logs/web_server_name/http_plugin.log 和 profile_root/logs/server_name
在 WebSphere Application Server 日誌檔中,追蹤記錄的格式如下:
PMRM0003I: parent:ver=n,ip=n.n.n.n,time=nnnnnnnnnn,pid=nnnn,reqid=nnnnnn,event=nnnn
-
current:ver=n,ip=n.n.n.n,time=nnnnnnnnnn,pid=nnnn,reqid=nnnnnn,event=nnnn
type=TTT detail=some_detail_information elapsed=nnnn
在 Web 伺服器外掛程式日誌檔中,追蹤記錄格式如下:
PLUGIN:
parent:ver=n,ip=n.n.n.n,time=nnnnnnnnnn,pid=nnnn,reqid=nnnnnn,event=nnnn
- current:ver=n,ip=n.n.n.n,time=nnnnnnnnnn,pid=nnnn,reqid=nnnnnn,event=nnnn
type=TTT detail=some_detail_information elapsed=nnnn bytesIn=nnnn
bytesOut=nnnn
追蹤記錄格式由兩個相關性因子組成:母相關性因子和現行相關性因子。 母相關性因子代表上游要求,而現行相關性因子代表現行作業。 如果母相關性因子和現行相關性因子相同,這個記錄便代表它進入 WebSphere Application Server 時發生的作業。
如果要使特定要求的追蹤記錄產生關聯,請從適當的應用程式伺服器日誌檔中收集訊息 ID 為 PMRM0003I 的記錄,從 Web 伺服器外掛程式日誌檔中收集 PLUGIN 追蹤記錄。 記錄是藉由現行相關性因子和母相關性因子的比對而相互關聯。 您可以將母追蹤記錄的現行相關性因子連接到子記錄的母相關性因子來建立邏輯樹狀結構。 這個樹狀結構顯示要求在整個伺服器叢集中的進展。 請參閱為何使用要求度量?,以取得交易流程的範例。
母相關性因子的表示方式是:在 parent: 關鍵字後面,接著以逗點區隔的欄位。 同樣地,現行相關性因子的表示方式是:在 current: 關鍵字後面,接著以逗點區隔的欄位。
母相關性因子和現行相關性因子的欄位如下:
- ver:相關性因子的版本。為了方便,在母相關性因子和現行相關性因子中,它是重複的。
- ip:產生相關性因子的應用程式伺服器節點的 IP 位址。如果系統有多個 IP 位址,要求度量會使用其中一個 IP 位址來識別系統。
- pid:產生相關性因子的應用程式伺服器的程序 ID。
- time:產生相關性因子的應用程式伺服器程序的啟動時間。
- reqid:要求度量指派給要求的 ID,對於應用程式伺服器程序而言,它是唯一的。
- event:指派來區分實際追蹤事件的事件 ID。
遵循母相關性因子和現行相關性因子,計時作業的度量資料如下:
- type:代表計時作業類型的代碼。支援的類型包括 HTTP、URI、EJB、JDBC、JMS、COMMONJ_WORK_POOLED、COMMONJ_TIMER、Web 服務要求者和 Web 服務提供者。
- detail:識別計時作業的名稱(請參閱下列對「通用資源 ID (URI)」、HTTP、EJB、JDBCJ、JMS、非同步 Bean 和 Web 服務的說明)。
- elapsed:這個作業(包括這個作業呼叫的所有子作業)的度量經歷時間,以 <units> 為單位。 經歷時間的單位是毫秒。
- bytesIn:Web 伺服器外掛程式從要求中收到的位元組數。
- bytesOut:從 Web 伺服器外掛程式傳送到用戶端的回覆位元組數。
所說明的 type 和 detail 欄位包括:
- HTTP:Web 伺服器外掛程式產生追蹤記錄。detail 是用來呼叫要求的 URI 名稱。
- URI:追蹤記錄是 Web 元件所產生。URI 是用來呼叫要求的 URI 名稱。
- EJB:Enterprise Bean 的完整套件和方法名稱。
- JDBC:該 JDBC 呼叫的介面名稱和方法名稱。
- JMS:JMS 包括各種 JMS 參數的細目
- 非同步 Bean:detail 指定非同步 Bean 的名稱。非同步 Bean 包括兩種類型:COMMONJ_WORK_POOLED 和 COMMONJ_TIMER。
- Web 服務:Web 服務包括各種 Web 服務參數的細目。Web 服務包括兩種類型:Web 服務要求者和 Web 服務提供者。
- SIB:用來在包含訊息傳送/接收及調解的服務整合匯流排中進行檢測。
- JCA:J2EE 連接器架構。detail 指定在其中發出 JCA 呼叫的類別名稱。
- JNDI:用於 JNDI 命名查閱。detail 指定 JNDI 名稱。
- JMS 傳送和接收:產生 JMS 傳送和接收訊息的追蹤記錄。
- SIB 傳送和接收:產生 SIB 傳送和接收訊息的追蹤記錄。
當應用程式伺服器有多個服務者區域時,會有多個 SystemOut.log 檔,每個服務者區域各一個。
因此,要求度量可能在多個 SystemOut.log 檔中記載追蹤記錄。
處理要求的服務者區域會在其 SystemOut.log 檔中記載相關記錄。
現行要求度量相關性因子中的 PID 是對應的服務者區域的 PID。
如果系統有多個 IP 位址,相關性因子中的 IP 可能是其中之一,但它應將相同 IP 用於相同的服務者區域。
註: 這個主題參照一或多個應用程式伺服器日誌檔。
此外,在分散式和 IBM® i 系統上,另外也建議您可以配置伺服器來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.log、SystemErr.log, trace.log 及 activity.log 檔案。HPEL 與原生 z/OS® 記載機能也可以一起使用。如果您使用 HPEL,則可以從伺服器設定檔 bin 目錄,利用 LogViewer 指令行工具來存取您所有的日誌和追蹤資訊。請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。