7.4.3 Performance Analysis Trace
The performance analysis trace (PRF trace) is trace information used to analyze the performance of the Service platform system. The performance analysis trace file is a text file in which the performance analysis trace is edited and output in the CSV format. The information that is output as the performance analysis trace is used to analyze performance bottlenecks throughout the system, including J2EE applications. It is used to troubleshoot and prevent such bottlenecks. For details on performance analysis trace functionality, see "7. Performance Analysis by Using Trace Based Performance Analysis" in "Application Server Maintenance and Migration Guide".
This section describes how to view the performance analysis traces that have been collected. For details about how to collect performance analysis traces, see 7.3.2(3) Collecting performance analysis traces and 7.3 Collecting the trace based performance analysis file by using Management Server in the Application Server Maintenance and Migration Guide.
- Organization of this subsection
(1) Output destination of performance analysis traces
For the output destination of performance analysis traces, see 7.3 Collecting the trace based performance analysis file by using Management Server in the Application Server Maintenance and Migration Guide.
(2) Output format and output contents of the performance analysis trace file
(a) Output format
The format that is output in the performance analysis trace file is same as that of the performance analysis trace of the J2EE server. For details about the performance analysis trace file, see "7.3 Collecting the trace based performance analysis file by using Management Server" in "Application Server Maintenance and Migration Guide".
(b) Output contents
- For HCSC server (Messaging infrastructure)
-
The following table lists and describes the content that is output to the performance analysis trace file:
Table 7‒24: Contents output to the performance analysis trace file (messaging infrastructure) Item
Content
Event ID
The Event ID of the collection point is output.
For details, see the applicable performance analysis trace collection point table in 7.4.3(3)(a) For HCSC server (Messaging infrastructure).
Return code
The type of collection point is output.
-
0:Normal end
-
1:Abnormal end
Interface name
Class name is output.
Operation name
Method name is output.
Option information
Message common ID
The request identification information (parent ID) is output.
Service request ID
The request identification information (child ID) is output.
Additional information
The additional information specific to the output destination is output.
-
- For HCSC server (business process infrastructure)
-
The following table lists and describes the content that is output to the performance analysis trace file:
Table 7‒25: Content output to the performance analysis trace file (business process infrastructure) Item
Content
Event ID
The Event ID of the collection point is output.
For details, see the applicable performance analysis trace collection point table in 7.4.3(3)(b) For HCSC server (Business process infrastructure).
Return code
The type of the collection point is output.
-
0:Normal end
-
1:Abnormal end
Interface name
Any of the following names is displayed:
-
Business process definition name
-
Java class name
-
Data Transform
-
Service name
For details, see the applicable performance analysis trace collection point table in 7.4.3(3)(b) For HCSC server (Business process infrastructure).
Operation name
Is not output.
Option information
Option information is output.
For details, see the applicable performance analysis trace collection point table in 7.4.3(3)(b) For HCSC server (Business process infrastructure).
-
- For HCSC server (Database adapter)
-
The following table lists and describes contents output to the performance analysis trace file:
Table 7‒26: Contents output to the performance analysis trace file (Database adapter) Item
Content
Event ID
The Event ID of the collection point is output.
For details, see the applicable performance analysis trace collection point table in 7.4.3(3)(c) For HCSC server (Database adapter).
Return code
The type of the collection point is output.
-
0:Normal end
-
1:Abnormal end
Interface name
Class name is output.
Package name is not displayed.
Operation name
Method name is output.
Option information
Message common ID
The request identification information (parent ID) is output.
Value becomes null when the information is not set.
Service request ID
The request identification information (child ID) is output.
Value becomes null when the information is not set.
Additional information
Individual information is output.
-
- For HCSC server (data transformation infrastructure)
-
The following table lists and describes contents output to the performance analysis trace file:
Table 7‒27: Content output to the performance analysis trace file (Data transformation infrastructure) Item
Content
Event ID
The Event ID of the collection point is output.
For details, see the applicable performance analysis trace collection point table in 7.4.3(3)(d) In HCSC server (data transformation infrastructure).
Return code
The type of the collection point is output.
-
0:Normal end
-
1:Abnormal end
Interface name
Class name is output.
Operation name
Method name is output.
Option information
Message common ID
The request identification information (parent ID) is output.
Service request ID
The request identification information (child ID) is output.
Additional information
The additional information specific to the output destination is output.
-
- For HCSC server (component-common UOC)
-
The following table lists and describes contents output to the performance analysis trace file.
Table 7‒28: Content output to the performance analysis trace file (component-common UOC) Item
Content
Event ID
The Event ID of the collection point is output.
For details, see the applicable performance analysis trace collection point table in 7.4.3(3)(e) For HCSC server (component-common UOC).
Return code
The type of the collection point is output.
-
0:Normal end
-
1:Abnormal end
Interface name
Class name of UOC class is output.
Operation name
Method name of UOC class is output.
Option information
Message common ID
The request identification information (parent ID) is output.
Service request ID
The request identification information (child ID) is output.
Additional information
Option information is output.
For details, see "7.4.3(3)(e) For HCSC server (component-common UOC)".
-
(3) Collection point of the performance analysis trace
(a) For HCSC server (Messaging infrastructure)
Performance analysis trace files are output at the following times, and the trace collection point for each time is different:
-
When executing individual services (without JSON-XML transformation)
-
When executing individual services (with JSON-XML transformation)
-
When executing business process services
-
When executing database access
-
When executing file access
-
When using user-defined receptions (custom receptions)#
- #
-
For details about the collection points when using user-defined receptions (custom receptions), see A.8 Acquiring the failure information (Custom reception) in the Service Platform Reception and Adapter Definition Guide.
The following describes collection points:
- When executing individual services (without JSON-XML transformation)
-
The following figure shows the trace collection point of the performance analysis trace when executing individual services:
Figure 7‒11: Trace collection point of the performance analysis trace (when executing individual services (without JSON-XML transformation)) The following table lists the event ID, trace collection point, and performance analysis trace collection level. The numbers in the Number in figure column of the following table correspond to the circled numbers in the preceding figure.
Table 7‒29: Performance analysis trace collection point (when executing individual services (without JSON-XML transformation)) Event ID
Number in figure
Trace collection point
Level
0x9800
1
Entry to standard reception (Web Services)
A
0x9801
2
Exit from standard reception (Web Services)
A
0x9802
1
Entry to standard reception (SessionBean)
A
0x9803
2
Exit from standard reception (SessionBean)
A
0x9804
1
Entry to standard reception (MDB(WS-R))
A
0x9805
2
Exit from standard reception (MDB(WS-R))
A
0x9806
1
Entry to standard reception (MDB(DB queue))
A
0x9807
2
Exit from standard reception (MDB(DB queue))
A
0x9810
3
Invocation of service components of SOAP adapter
A
0x9811
4
Point for receiving response from service components of SOAP adapter
A
0x9812
3
Invocation of service components of SessionBean adapter
A
0x9813
4
Point for receiving response from service components of SessionBean adapter
A
0x9814
3
Invocation of service components of MDB (WS-R) adapter
A
0x9815
4
Point for receiving response from service components of MDB (WS-R) adapter
A
0x9816
3
Invocation of service components of MDB (DB queue) adapter
A
0x9817
4
Point for receiving response from service components of MDB (DB queue) adapter
A
0x9818
3
Invocation of service components of service adapters(CUSTOM) other than those mentioned above
A
0x9819
4
Point for receiving response from service components of service adapters(CUSTOM) other than those mentioned above
A
- Legend:
-
A: Indicates the "Standard" level.
- When executing individual services (with JSON-XML transformation)
-
The following figure shows the trace collection point of the performance analysis trace when executing individual services:
Figure 7‒12: Trace collection point of the performance analysis trace (when executing individual services (with JSON-XML transformation)) The following table lists the event ID, trace collection point, and performance analysis trace collection level. The numbers in the Number in figure column of the following table correspond to the circled numbers in the preceding figure.
Table 7‒30: Performance analysis trace collection point (when executing individual services (with JSON-XML transformation)) Event ID
Number in figure
Trace collection point
Level
0x9800
1
Entry to standard reception (Web Services)
A
0x9801
2
Exit from standard reception (Web Services)
A
0x9802
1
Entry to standard reception (SessionBean)
A
0x9803
2
Exit from standard reception (SessionBean)
A
0x9804
1
Entry to standard reception (MDB(WS-R))
A
0x9805
2
Exit from standard reception (MDB(WS-R))
A
0x9806
1
Entry to standard reception (MDB(DB queue))
A
0x9807
2
Exit from standard reception (MDB(DB queue))
A
0x9810
3
Invocation of service components of SOAP adapter
A
0x9811
4
Point for receiving response from service components of SOAP adapter
A
0x9812
3
Invocation of service components of SessionBean adapter
A
0x9813
4
Point for receiving response from service components of SessionBean adapter
A
0x9814
3
Invocation of service components of MDB (WS-R) adapter
A
0x9815
4
Point for receiving response from service components of MDB (WS-R) adapter
A
0x9816
3
Invocation of service components of MDB (DB queue) adapter
A
0x9817
4
Point for receiving response from service components of MDB (DB queue) adapter
A
0x9818
3
Invocation of service components of service adapters(CUSTOM) other than those mentioned above
A
0x9819
4
Point for receiving response from service components of service adapters(CUSTOM) other than those mentioned above
A
0x982a
5#
Point for invoking JSON-XML transformation in the custom adapter development framework (request message)
B
0x982b
6#
Point for receiving a response from JSON-XML transformation in the custom adapter development framework (request message)
B
0x982c
7#
Point for invoking JSON-XML transformation in the custom adapter development framework (response message)
B
0x982d
8#
Point for receiving a response from JSON-XML transformation in the custom adapter development framework (response message)
B
- Legend:
-
A: Indicates the "Standard" level.
B: Indicates the Advance level.
- #
-
This trace collection point is used only when JSON-XML transformation is performed in the custom adapter development framework.
- When executing business process services
-
The following figure shows the trace collection point of the performance analysis trace when executing business process services:
Figure 7‒13: Trace collection point of the performance analysis trace (when executing business process services) The following table lists the event ID, trace collection point, and the performance analysis trace collection level. The "Number in figure" in this table corresponds to the numbers in "Figure 7-13 Trace collection point of the performance analysis trace (when executing business process services)".
Table 7‒31: Performance analysis trace collection point(when executing business process services) Event ID
Number in figure
Trace collection point
Level
0x9800
1
Entry to standard reception (Web Services)
A
0x9801
2
Exit from standard reception (Web Services)
A
0x9802
1
Entry to standard reception (SessionBean)
A
0x9803
2
Exit from standard reception (SessionBean)
A
0x9804
1
Entry to standard reception (MDB(WS-R))
A
0x9805
2
Exit from standard reception (MDB(WS-R))
A
0x9806
1
Entry to standard reception (MDB(DB queue))
A
0x9807
2
Exit from standard reception (MDB(DB queue))
A
0x9808
1
Entry to SOAP reception
A
0x9809
2
Exit from SOAP reception
A
0x9810
7
Invocation of service components of SOAP adapter
A
0x9811
8
Point for receiving response from service components of SOAP adapter
A
0x9812
7
Invocation of service components of SessionBean adapter
A
0x9813
8
Point for receiving response from service components of SessionBean adapter
A
0x9814
7
Invocation of service components of MDB (WS-R) adapter
A
0x9815
8
Point for receiving response from service components of MDB (WS-R) adapter
A
0x9816
7
Invocation of service components of MDB (DB queue) adapter
A
0x9817
8
Point for receiving response from service components of MDB (DB queue) adapter
A
0x9818
7
Invocation of service components of service adapters(CUSTOM) other than those mentioned above
A
0x9819
8
Point for receiving response from service components of service adapters(CUSTOM) other than those mentioned above
A
0x9840
3
Invocation of business process services
A
0x9841
4
Point for receiving response from business process services
A
0x9842
5
Entry to business process reception
A
0x9843
6
Exit from business process reception
A
- Legend:
-
A:Indicates the "Standard" level.
- When executing database access
-
The following figure shows the collection point of performance analysis trace at the time of accessing the database when the HCSC server fetches commands.
Figure 7‒14: Performance analysis trace collection point (when executing database access) The following table lists the event ID, trace collection point, and the performance analysis trace collection level. The "Number in figure" in this table corresponds to the numbers in "Figure 7-14 Performance analysis trace collection point (when executing database access)".
Table 7‒32: Performance analysis trace collection point(when executing database access) Event ID
Number in figure
Trace collection point
Level
0x9850
1
Invocation of DB connector
A
0x9851
2
Point for receiving response from DB connector
A
0x9852
3
Invocation of execution log of DB connector
B
0x9853
4
Point for receiving response from execution log of DB connector
B
- Legend:
-
A:Indicates the "Standard" level.
B:Indicates the "Detail" level.
- When executing the file access
-
When you setup the HCSC server in a configuration in which the database is not used, files are accessed instead of the database when the command is processed. Acquire the performance analysis trace while accessing these files. The following figure shows the collection point when accessing files:
Figure 7‒15: Performance analysis trace collection point (when accessing files) The following table lists the event ID, trace collection point, and the performance analysis trace collection level. The "Number in figure" in this table corresponds to the numbers in "Figure 7-15 Performance analysis trace collection point (when accessing files)".
Table 7‒33: Performance analysis trace collection point (when accessing files) Event ID
Number in figure
Trace collection point
Level
0x9854
1
Invocation of file access (before opening the file)
B
0x9855
2
Point for receiving response from file access (after closing the file)
B
- Legend:
-
B:Indicates the "Detail" level.
(b) For HCSC server (Business process infrastructure)
The following figure shows the performance analysis trace collection point:
|
|
The following tables lists the event ID, trace collection point, and the performance analysis trace collection level, and indicates the output content of Interface name and Option information for each event ID. The numbers in the Number in figure column of the table correspond to the numbers in the above figure.
|
Event ID |
Number in figure |
Trace collection point |
Level |
Interface name |
Option information |
|---|---|---|---|---|---|
|
0x9900 |
1 |
Invoking a request for business process execution from messaging infrastructure |
A |
Business process definition name |
|
|
0x9901 |
2 |
Response to messaging infrastructure for the request to execute business process |
A |
Business process definition name |
|
|
0x9902 |
3 |
Invoking after reply activity from messaging infrastructure |
A |
Business process definition name |
|
|
0x9903 |
4 |
Response to invocation after reply activity from messaging infrastructure |
A |
Business process definition name |
|
|
0x9904 |
5 |
Invoking the request to re-execute from messaging infrastructure |
A |
Business process definition name |
|
|
0x9905 |
6 |
Response to invocation of the request to re-execute from messaging infrastructure |
A |
Business process definition name |
|
|
0x9906 |
7 |
Invoking the user-created Java class |
A |
Java class name |
None |
|
0x9907 |
8 |
Response from the user-created Java class |
A |
Java class name |
|
|
0x9908 |
9 |
Invoking data transformation request |
A |
"Data Transform" |
None |
|
0x9909 |
10 |
Response from data transformation request |
A |
"Data Transform" |
|
|
0x990A |
11 |
Invoking from TimerService after the standby activity |
A |
Business process definition name |
|
|
0x990B |
12 |
Response to invocation from TimerService after the standby activity |
A |
Business process definition name |
|
|
0x990C |
13 |
When registering of TimerService |
A |
Business process definition name |
|
|
0x990D |
14 |
In the case of TimerService timeout |
A |
Business process definition name |
|
|
0x9910 |
15 |
Invoking a service component request to messaging infrastructure |
A |
Service name |
|
|
0x9911 |
16 |
Response to the service component request from messaging infrastructure |
A |
Service name |
|
|
0x9912 |
17 |
Invoking after reply activity from messaging infrastructure to asynchronous EJB |
A |
Business process definition name |
|
|
0x9913 |
18 |
Response to the Invoking after reply activity from asynchronous EJB to messaging infrastructure |
A |
Business process definition name |
|
- Legend:
-
A:Indicates the "Standard" level.
- Note
-
The event IDs that are not listed in the table (0x9A00 to 0x9AFF) are issued from the data transformation infrastructure.
(c) For HCSC server (Database adapter)
The trace collection point of performance analysis trace differs depending on whether you execute startup operations or service components.
- At the time of starting
-
The following figure shows the performance analysis trace collection point at the time of starting:
Figure 7‒17: Trace collection point of performance analysis trace (when starting the DB adapter) The following table lists the event ID, trace collection point, and the performance analysis trace collection level. The "Number in figure" in this table corresponds to the numbers in "Figure 7-17 Trace collection point of performance analysis trace (when starting the DB adapter)".
Table 7‒35: Performance analysis trace collection point (when starting DB adapter) Event ID
Number in figure
Trace collection point
Level
0x9B60
1
Immediately before data source search
B
0x9B61
2
Immediately after data source search
B
0x9B62
B
- Legend:
-
B:Indicates the "Detail" level.
- When executing service components
-
The following figure shows the trace collection point of performance analysis trace when executing service components:
Figure 7‒18: Trace collection point of performance analysis trace (when executing DB adapter service) The following table lists the event ID, trace collection point, and the performance analysis trace collection level. The "Number in figure" in this table corresponds to the numbers in "Figure 7-18 Trace collection point of performance analysis trace (when executing DB adapter service)".
Table 7‒36: Performance analysis trace collection point(when executing DB adapter service) Event ID
Number in figure
Trace collection point
Level
0x9B00
1
Immediately after invoking a service component request from messaging infrastructure
A
0x9B01
14
Immediately before the response to the service component request from messaging infrastructure
A
0x9B02
A
0x9B20
2#1#2, 12#1#2
Immediately before invoking a data transformation request
A
0x9B21
3#1#2, 13#1#2
Immediately after invoking a data transformation request
A
0x9B22
A
0x9B23
15#2#3
Immediately before invoking a data replication request
A
0x9B24
16#2#3
Immediately after the response to the data replication request
A
0x9B25
A
0x9B63
4
Immediately before invoking a request to connect to database
B
0x9B64
5
Immediately after invoking a request to connect to database
B
0x9B65
B
0x9B66
6
Immediately before invoking an SQL request
A
0x9B67
7
Immediately after the response to the SQL request
A
0x9B68
A
0x9B69
6
Immediately before invoking an SQL request
A
0x9B6A
7
Immediately after the response to the SQL request
A
0x9B6B
A
0x9B6C
6
Immediately before invoking an SQL request
A
0x9B6D
7
Immediately after the response to the SQL request
A
0x9B6E
A
0x9B6F
17
When executing SELECT statement from DB adapter (only when ResultSet.next() is output for the first time)
A
0x9B70
18
A
0x9B71
A
0x9B40
8
Immediately before storing SQL (SELECT) execution results
A
0x9B41
11
Immediately after storing SQL (SELECT) execution results
A
0x9B42
A
0x9B43
9
Immediately before collecting SQL (SELECT) execution results
B
0x9B44
10
Immediately after collecting SQL (SELECT) execution results
B
0x9B45
B
- Legend:
-
A:Indicates the "Standard" level.
B:Indicates the "Detail" level.
- Note
-
The event IDs that are not listed in the table (0x9A00 to 0x9AFF) are issued from the data transformation infrastructure.
- Note#1
-
Indicates the trace collection point when the data transformation definition has an XML message as the standard message type.
- Note#2
-
Indicates the trace collection point when the data transformation definition has a binary message as the standard message type.
- Note#3
-
Indicates the trace collection point when there is no data transformation definition.
(d) In HCSC server (data transformation infrastructure)
The following table lists the event ID, trace collection point, and the performance analysis trace collection level.
|
Event ID |
Trace collection point |
Level |
|---|---|---|
|
0x9A07 |
Immediately before acquiring the value from XML |
A |
|
0x9A08 |
Immediately after acquiring the value from XML |
A |
|
0x9A0C |
Immediately before setting up the value in XML |
A |
|
0x9A0D |
Immediately after setting up the value in XML |
A |
|
0x9A11 |
Immediately before acquiring the node from XML |
A |
|
0x9A12 |
Immediately after acquiring the node from XML |
A |
|
0x9A16 |
Immediately before setting up the node in XML |
A |
|
0x9A17 |
Immediately after setting up the node in XML |
A |
|
0x9A43 |
Immediately before data transformation |
A# |
|
0x9A44 |
Immediately after data transformation |
A# |
|
0x9A52 |
Immediately before generating the data transformation template |
A |
|
0x9A53 |
Immediately after generating the data transformation template |
A |
|
0x9A65 |
Immediately before generating the XML schema instance |
A |
|
0x9A66 |
Immediately after generating the XML schema instance |
A |
|
0x9A6A |
Immediately before generating the XML schema instance |
A |
|
0x9A6B |
Immediately after generating the XML schema instance |
A |
|
0x9A77 |
Immediately before XML data analysis |
A |
|
0x9A78 |
Immediately after XML data analysis |
A |
|
0x9A7A |
Immediately before XML schema validation |
A |
|
0x9A7B |
Immediately after XML schema validation |
A |
|
0x9A7C |
Immediately before XML schema validation |
A |
|
0x9A7D |
Immediately after XML schema validation |
A |
|
0x9A80 |
Immediately before XML data analysis |
A |
|
0x9A81 |
Immediately after XML data analysis |
A |
|
0x9A82 |
Immediately before data transformation |
A |
|
0x9A83 |
Immediately after data transformation |
A |
|
0x9A84 |
Immediately before XML data analysis |
A |
|
0x9A85 |
Immediately after XML data analysis |
A |
|
0x9A88 |
Immediately before generating the XML schema instance |
A |
|
0x9A89 |
Immediately after generating the XML schema instance |
A |
|
0x9A8D |
Immediately before generating the XML schema instance |
A |
|
0x9A8E |
Immediately after generating the XML schema instance |
A |
|
0x9A8F |
Before invoking transformation function jar |
A |
|
0x9A90 |
After invoking transformation function jar |
A |
- Legend:
-
A:Indicatesthe "Standard" level.
- Note#
-
When invoking from the file operations adapter, the performance analysis trace collection level is "Detail".
(e) For HCSC server (component-common UOC)
The performance analysis trace when you use the Component-common UOC functionalityis output immediately before and after invoking the UOC class. The following figure shows the trace collection point of performance analysis trace when using component-common:
|
|
The following table lists the event ID, trace collection point, and the performance analysis trace collection level. The "Number in figure" in this table corresponds to the numbers in "Figure 7-19 Performance analysis trace collection point (when using component-common UOC)".
|
Event ID |
Number in figure |
Trace collection point |
Level |
|---|---|---|---|
|
0x986C |
1 |
Invocation of component-common UOC |
A |
|
0x986D |
2 |
Point for receiving response from component-common UOC |
A |
- Legend:
-
A:Indicates the "Standard" level.
The output format of the option information is as follows:
<Request identification information (parent ID)> <Request identification information (child ID)> Component type=<Component type (service adapter or reception)>, Component kind=<type>, Component ID=<Service ID of service adapter or reception ID#>, OP=<service operation name>
In case of abnormal end, the option information is output in the following format:
<Request identification information (parent ID)> <Request identification information (child ID)> Component type=< Component type (adapter type or reception type)>, Component ID=< Service ID of service adapter or reception ID #>, OP=< service operation name >, Exception=<exception class name>
- Note#
-
If you use the standard reception, the following fixed values are set:
Component
Reception ID
Standard reception (Web services)
(SOAP1.1,SOAP 1.1/1.2 combined mode is common)
StandardReception_SOAP
Standard reception (SessionBean)
StandardReception_EJB
Standard reception (MDB(WS-R))
StandardReception_WSR
Standard reception (MDB(DB queue))
StandardReception_DBQ