15.4.2 Investigating the Log Using the Root Application Information
If the application API is used in a J2EE application or batch application, the character string expression of root application information of the performance analysis information can be output to the log file at any time.
The character string expression of the root application information is output to the following format (maximum 48 characters):
IP address / process ID / communication number (Example: 10.209.15.130/1234/0x0000000000000001)
If the root application information is output to a log file using an API, you compare the log file with the trace based performance analysis file to investigate.
When a new request is received in the Web container, a new root application information is assigned to the single request. The following table describes the trace points to which the new root application information is assigned.
|
Conditions |
Event ID (process contents) |
Process contents |
|---|---|---|
|
When using the in-process HTTP server |
0x8211 |
When acquiring a request, when completing the request header analysis |
|
When connecting to a Web server# |
0x8200 |
When acquiring a request, when completing the request header analysis |
- #
-
When connecting to a Web server, the root application information acquired by the redirector is assigned. If route application information is not issued because the redirector failed or a failure occurred in loading the PRF trace output library used by the redirector, new route application information is assigned in the Web container.
Moreover, in the following trace collection point, IPaddress/process ID/communication number might be output as 0.0.0. 0/0/0x0000000000000000.
-
0x8212
When data is read from Web client where the in-process HTTP server is used.
-
0x8312
When data is written to the Web client where the in-process HTTP server is used.
In the following cases the IP-address/process-ID/communication-number is output as 0.0.0. 0/0/0x0000000000000000:
-
If an HTTP request header is received
-
If an incorrect data that is not an HTTP request is received
-
If an exception occurs during processing of the request
Note that the APIs used to output the character string expression of the root application information is the getRootApInfo method of the CprfTrace class, provided in the com.hitachi.software.ejb.application.prf package.
For details on implementing acquisition of route application information when developing a J2EE application or batch application, see 7.7.9 Investigation about the location of the problem associated to the trace based performance analysis file and thread dump in the manual uCosminexus Application Server Maintenance and Migration Guide. For details on the APIs, see the uCosminexus Application Server API Reference Guide.