uCosminexus Service Platform, Reception and Adapter Definition Guide
If an error occurs during operation of a custom reception, the following information is output for troubleshooting purposes:
This section describes how to acquire this log data and trace information.
Message log data is output to the following logs:
For details on how to acquire message log data and its output destination, see 7.4.1 Message log in the manual Service Platform Setup and Operation Guide. For further details, see Chapter 2. List of Messages in the manual Service Platform Messages.
You can use request trace information to analyze the cause of an error in a request.
The following figure shows the collection points for request trace information:
Figure A-11 Request trace information collection points
The table below describes each trace information collection point and its detailed location. The number in the leftmost column of the table corresponds to the number in the figure.
Table A-5 Request trace collection points
| Number in figure | Detailed location | Trace collection point |
|---|---|---|
| 1 | IN | Entry point of custom reception framework |
| 2 | OUT | Exit point of custom reception framework |
Table A-6 Items output in request trace information
| Item | Description | |
|---|---|---|
| No. | The output serial number of the trace record | |
| Date | The date on which the trace record was acquired, in the format yyyy/mm/dd | |
| Time | The time at which the trace record was acquired in local time, in the format hh:mm:ss.sss | |
| Product ID | An ID that identifies the product.
|
|
| pid | An ID that identifies the process | |
| tid | An ID that identifies the thread | |
| ID | -- | |
| Common message ID | Information that identifies the request (parent ID) | |
| Service requester ID | Information that identifies the request (child ID) | |
| Collection point identification information | Collection point | Information about the collection point of the trace information.
|
| Protocol type | Information about the collection point of the trace information (protocol type).
|
|
| Detailed location | Information about the collection point of the trace information (detailed location).
|
|
| Name | -- | |
| Adapter type | -- | |
| Result | Outputs the response result type. This item is not output when the detailed location is IN.
|
|
| Additional information | Outputs the information appended to the response result.
|
|
| CRLF | The end of record code | |
For details on how to collect request trace information and the output destination of request trace information, see 7.4.2 Request trace in the manual Service Platform Setup and Operation Guide.
A performance analysis trace (PRF trace) is information that can be used to analyze the performance of the Service Platform system. A performance analysis trace file is a text file containing this information in CSV format. Performance analysis trace information is useful for analyzing performance bottlenecks across the entire system, including J2EE applications. You can use it to identify and troubleshoot performance issues. For details on the performance analysis trace functionality, see Chapter 7. Performance Analysis by Using Trace based Performance Analysis in the manual Application Server Maintenance and Migration Guide.
The following figure shows the collection points for performance analysis trace information.
Figure A-12 Collection points for performance analysis trace information
The table below shows the event IDs, trace information collection points, and performance analysis trace information collection levels. The number in the Number in figure column of the table corresponds to the number in the figure.
Table A-7 Collection points of performance analysis trace information
| Event ID | Number in figure | Trace information collection point | Level |
|---|---|---|---|
| 0x9860 | 1 | Entry point of custom reception framework | A |
| 0x9861 | 2 | Exit point of custom reception framework | A |
| 0x9862 | 3 | Invocation of data transformation (request message) | B |
| 0x9863 | 4 | Reception of data transformation response (request message) | B |
| 0x9864 | 5 | Invocation of HCSC message delivery control | A |
| 0x9865 | 6 | Reception of HCSC message delivery control response | A |
| 0x9866 | 7 | Invocation of data transformation (response message) | B |
| 0x9867 | 8 | Reception of data transformation response (response message) | B |
Table A-8 Information output to a performance analysis trace file
| Item | Description |
|---|---|
| Event ID | The event ID associated with the collection point |
| Return code | The collection point type.
|
| Interface name | The class name is output. The package name is not shown. |
| Operation name | The method name |
| Optional information | The following optional information is output:
|
The acquisition method and output destination for performance analysis trace files is common to the entire Service Platform. For details, see 7.3 Collecting the trace based performance analysis file by using Management Server in the manual Application Server Maintenance and Migration Guide.
You can use user message trace information to check the status of a message.
The following figure shows the collection points for user message trace information.
Figure A-13 User message trace information collection points
The table below shows the detailed location and collection points for user message trace information. The number in the leftmost column of the table corresponds to the number in the figure.
Table A-9 User message trace information collection points
| Number in figure | Detailed location | Trace collection point |
|---|---|---|
| 1 | IN | Entry point of custom reception framework |
| 2 | OUT | Exit point of custom reception framework |
| 3 | RQA#1 | Response to data transformation (request message) |
| 4 | RSB#1 | Invocation of data transformation (response message) |
| 5 | ERR#2 | Service invocation of custom reception framework |
Table A-10 Items output in user message trace information (trace start)
| Item | Description | |
|---|---|---|
| No. | The output serial number of the trace record | |
| Date | The date on which the trace record was acquired, in the format yyyy/mm/dd | |
| Time | The time at which the trace record was acquired in local time, in the format hh:mm:ss.sss | |
| Product ID | An ID that identifies the product.
|
|
| pid | An ID that identifies the process | |
| tid | An ID that identifies the thread | |
| ID | -- | |
| Collection point identification information for message trace start | Message trace start | The string telegramtrace started which indicates the start of the user message trace is output. |
| Collection point | Information about the collection point of the trace information.
|
|
| Protocol type | Information about the collection point of the trace information (protocol type).
|
|
| Detailed location | Information about the collection point of the trace information (detailed location).
|
|
| Common message ID | Information that identifies the request (parent ID) | |
| Additional information | The following additional information is output:
|
|
| CRLF | The end of record code | |
Table A-11 Items output in user message trace information (trace data)
| Item | Description | |
|---|---|---|
| No. | The output serial number of the trace record | |
| Date | The date on which the trace record was acquired, in the format yyyy/mm/dd | |
| Time | The time at which the trace record was acquired in local time, in the format hh:mm:ss.sss | |
| Product ID | An ID that identifies the product.
|
|
| pid | An ID that identifies the process | |
| tid | An ID that identifies the thread | |
| ID | -- | |
| Message trace data | Output position | The offset (hexadecimal format) from the start of the user message is output. |
| Data (hexadecimal format) |
The content of the user message (hexadecimal format) is output. | |
| Data (ASCII format) |
The content of the user message (ASCII format) is output. ASCII characters are output for characters in the range from 0x20 to 0x7E. Periods (.) are output for values outside this range. |
|
| CRLF | The end of record code | |
Table A-12 Items output in user message trace information (trace end)
| Item | Description | |
|---|---|---|
| No. | The output serial number of the trace record | |
| Date | The date on which the trace record was acquired, in the format yyyy/mm/dd | |
| Time | The time at which the trace record was acquired in local time, in the format hh:mm:ss.sss | |
| Product ID | An ID that identifies the product.
|
|
| pid | An ID that identifies the process | |
| tid | An ID that identifies the thread | |
| ID | -- | |
| Collection point identification information for message trace end | Message trace end | The string telegramtrace sended which indicates the end of the user message trace is output. |
| Collection point | Information about the collection point of the trace information.
|
|
| Protocol type | Information about the collection point of the trace information (protocol type).
|
|
| Detailed location | Information about the collection point of the trace information (detailed location).
|
|
| Common message ID | Information that identifies the request (parent ID) | |
| Additional information | The length of the user message (decimal format) is output. If there is no user message, null is output. | |
| CRLF | The end of record code | |
For details on the collection method and output destination of user message trace information, see 7.4.4 User message trace in the manual Service Platform Setup and Operation Guide.
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.