Structure of the Transaction Log
The transaction log contains the following information:
|
Field |
Description |
|
Example |
|---|---|---|---|
|
Date |
Date when request was received. |
Fields Date and Time are set automatically for system messages.
|
|
|
Time |
Time when request was received. |
|
|
|
Time Zone |
Time zone offset |
|
|
|
Transaction ID |
Unique ID of the transaction. It is used to trace service calls through the call stack (see Transaction ID). The transaction log contains the first 40 characters of the transaction ID. |
|
|
|
Request ID |
Unique ID of request. |
|
|
|
Component Name |
Name of component that has been requested (not the name of the xUML service). |
|
|
|
Elapsed Time |
Elapsed time, for each call (service calls, external or internal calls) in milliseconds. If the elapsed time is displayed as "0", the logged step has taken below 1 millisecond of time. The value of elapsed time does not contain:
|
|
|
|
State |
State is either OK or ERROR. |
|
|
|
Domain |
|
|
|
|
Log Type |
|
|
|
|
Parameter 1 and 2 |
|
|
|
|
Correlation ID |
Unique ID that relate an adapter call with the adapter response. The transaction log contains the first 40 characters of the correlation ID. A correlation ID is available for the following:
For more information refer to the adapter pages. |
|
|
Log Levels
The following transaction log levels can be set for each selected xUML service. The higher the log level the more information will be written to the log files. The log levels in the table below are cumulative and are ordered from the lowest to the highest log level. For each log level, also the information of the lower levels is logged. How to view the log is described in (25.3) xUML Service Transaction Log.
|
Log Level |
Log Types Logged |
Description |
|---|---|---|
|
None |
|
No logging executed. |
|
Custom |
CUSTOM |
Logs everything that is written by the logger adapter (for more details, see (25.3) Log Adapter). |
|
Service |
CUSTOM
|
Additionally logs the start and the end of calls to a service operation (service interface). For example, calls to SOAP, SAPRFC, or HTTP operations. |
|
IOExternal |
CUSTOM
|
Additionally logs calls of adapters that communicate with external systems like SAP, SQL, SOAP, etc. For instance, the SQL queries that are sent to the database will be logged as well. Calls via the file system and system adapter are excluded. |
|
IOInternal |
CUSTOM
|
Additionally logs also calls of adapters to internal (local) resources (file system adapter and system adapter). |
Transaction Log Domains
Each adapter logs to a dedicated domain:
Transaction Log xUML Service Adapter Details
Conversations
|
Domain |
State |
Parameter 1 |
Parameter 2 |
Correlation ID |
|||||
|---|---|---|---|---|---|---|---|---|---|
|
Log Level: IOInternal |
|||||||||
|
|
|
|
conversation ID
|
|
|||||
|
|
conversation ID |
|
|||||||
File System Adapter
|
Domain |
Component |
Parameter 1 |
State |
Parameter 2 |
|---|---|---|---|---|
|
Log Level: IOInternal |
||||
|
|
name of the adapter action node |
adapter action as defined on the adapter: Example: |
|
path to file/directory
|
|
|
error message
|
|||
|
|
|
path to old file
|
||
Java Adapter
|
Domain |
Component |
Parameter 1 |
State |
Parameter 2 |
||
|---|---|---|---|---|---|---|
|
Log Level: IOInternal |
|
|
||||
|
|
name of the adapter action node |
|
|
|
|
|
JMS Adapter
The JMS adapter is used in combination with the Java adapter. Possible errors are logged with the Java adapter.
|
Domain |
Component |
Transaction ID |
Parameter 1 |
State |
Parameter 2 |
Correlation ID |
|---|---|---|---|---|---|---|
|
Log Level: IOInternal |
||||||
|
|
name of the adapter action node |
custom JMS header property xTransactionId if present (see JMS Adapter Reference for more information on custom JMS Adapter header fields) |
|
|
JMS connection
|
JMSMessageID (for send and receive, not for listen) |
Log Adapter
|
Domain |
Component |
Adapter Action |
State |
Parameter 1 |
Parameter 2 |
||||
|---|---|---|---|---|---|---|---|---|---|
|
Log Level: Custom |
|||||||||
|
as defined in tagged value domain |
name of the adapter action node |
report |
|
as defined in tagged value description |
as defined in tagged value parameter |
||||
POP3 Adapter
|
Domain |
Component |
Adapter Action |
Parameter 1 |
Parameter 2 |
|
|---|---|---|---|---|---|
|
State |
State |
||||
|
Log Level: IOExternal |
|||||
|
|
name of the adapter action node |
getMessage |
|
Mail host
|
|
|
delete |
|
||||
|
commit |
|
||||
|
rollback |
|
||||
Persistent State Adapter
Log Level "Service"
The start of a transition/do activity (TRANSITION_ENTER/DOACTION_ENTER) is always logged with state OK. If the transition/do activity fails, TRANSITION_EXIT/DOACTION_EXIT is logged with state ERROR and the transition/do activity is rollbacked.
|
Domain |
Component |
Log Type |
State |
Parameter 1 |
Parameter 2 |
|---|---|---|---|---|---|
|
Log Level: Service |
|||||
|
|
name of the persistent state class |
|
|
name of the transition |
primary key of the persistent state object |
|
|
|
internal MagicDraw id of the do activity |
primary key of the persistent state object |
||
Log Level "IOInternal" for Bridge Console Actions
|
Domain |
Control Port Action |
Component |
Parameter 1 |
Parameter 2 |
|---|---|---|---|---|
|
Log Level: IOInternal |
||||
|
|
retry of completion transition |
|
<name of persistent state class> |
<console user> |
|
retry of completion transition |
|
<name of persistent state class> |
||
|
delete single PS object |
|
<name of persistent state class> |
||
|
show pstate data as raw object |
|
<name of persistent state class> |
||
|
show pstate data as raw object |
|
<name of persistent state class> |
||
|
list all PS classes |
|
|
||
|
list all PS classes |
|
|
||
|
list all PS objects |
|
<name of persistent state class> |
||
|
show instances for owner |
|
|
||
|
assign objects to own service instance |
|
|
||
|
delete PS objects |
|
|
||
|
delete PS objects |
|
|
||
|
send signal to PS object |
|
<unique object ID> |
||
Log Level "IOInternal" for xUML Service Actions
|
Domain |
Component |
Adapter Action |
Parameter 1 |
Parameter 2 |
||
|---|---|---|---|---|---|---|
|
|
|
|
||||
|
Log Level: IOInternal |
||||||
|
|
name of the persistent state class
|
broadcast signal |
|
signal name |
|
|
|
create |
|
|
primary key of the persistent state object |
|
||
|
getObjectHandle |
|
|
primary key of the persistent state object |
|
||
|
getObjectHandles |
|
name of the persistent state class |
|
|
||
|
getObjectCopy |
|
primary key of the persistent state object |
|
|
||
|
getStateInfo |
|
primary key of the persistent state object |
|
|
||
|
commit |
|
primary key of the persistent state object |
|
|
||
|
rollback |
|
pimary key of the persistent state object |
|
|
||
|
send signal |
|
signal name |
|
|
||
REST Adapter
|
Domain |
Component |
Parameter 1 |
State |
Parameter 2 |
|---|---|---|---|---|
|
Log Level: IOExternal |
||||
|
|
name of the adapter action node |
REST method, e.g. |
|
REST URL |
SAP Adapter
|
Domain |
Component |
Parameter 1 |
State |
Parameter 2 |
Correlation ID |
|
|---|---|---|---|---|---|---|
|
Log Level: IOExternal |
||||||
|
|
name of the adapter action node |
adapter operation
|
|
IP address of the SAP system
|
|
|
|
|
|
Open connection to SAP system. |
|
|||
|
|
Close connection to SAP system. |
|
||||
|
|
No connection available from the SAP connection pool. |
|
||||
SMTP Adapter
|
Domain |
Component |
Parameter 1 |
State |
Parameter 2 |
Correlation ID |
|
|---|---|---|---|---|---|---|
|
Log Level:IOExternal |
||||||
|
|
name of the adapter action node |
|
|
SMTP host and correlation ID
|
|
|
|
|
error message
|
|
||||
SOAP Adapter
|
Domain |
Component Name |
Parameter 1 |
State |
Parameter 2 |
Correlation ID |
|---|---|---|---|---|---|
|
Log Level:IOExternal |
|||||
|
|
name of the SOAP operation |
|
|
URL |
|
|
|
error message |
||||
SQL Adapter
Adapter Call
|
|||
|
Domain |
Adapter Action |
Parameter 1 |
|
|---|---|---|---|
|
Log Level:IOExternal |
|||
|
|
execute |
SQL action as defined in the SQL statement:
|
|
|
fetch |
|
||
|
closeHandle |
|
||
|
Log Level: IOInternal |
|||
|
|
implicit action |
|
Establish a connection to the database. |
|
|
Apply a PRAGMA statment to the database connection. |
||
|
|
Disable autocommit on this database connection. |
||
|
|
Set the database isolation level to the given value. |
||
|
|
Perform an implicit commit on the database transaction. |
||
|
|
Perform an implicit rollback on the database transaction. |
||
|
|
Test the database connection. |
||
|
|
Disconnect from the database. |
||
States
|
|||
|
Domain |
State |
Parameter 2 |
|
|
|
|
name and path of the SQL database the action has been performed on
|
|
|
|
error message
|
||
System Adapter
|
Domain |
Component Name |
Parameter 1 |
State |
Parameter 2 |
|
|---|---|---|---|---|---|
|
Log Level: IOInternal |
|||||
|
|
name of the adapter action node |
|
|
component name |
|
URL Adapter
|
Domain |
Parameter 1 |
State |
Parameter 2 |
Correlation ID |
|---|---|---|---|---|
|
Log Level: IOExternal |
||||
|
|
URL method
|
|
URL
|
|
|
|
- |
|||
ZIP Adapter
|
Domain |
Parameter 1 |
State |
Parameter 2 |
|
|---|---|---|---|---|
|
Log Level: IOInternal |
||||
|
|
|
|
name of the ZIP file |
|
|
|
- |
|||
Transaction Log Service Implementation Details
HTTP Service
|
Domain |
Component |
Log Type |
Transaction ID |
State |
Parameter 1 |
Parameter 2 |
Correlation ID |
|---|---|---|---|---|---|---|---|
|
Log Level: Service |
|||||||
|
|
model path to the HTTP operation
|
|
HTTP header X-Transaction-ID if present |
|
|
IP address of the caller
|
HTTP header X-Request-ID if present |
|
|
HTTP header X-Transaction-ID
|
||||||
Java Callback Service
|
Domain |
Component |
Log Type |
State |
Parameter 1 |
Parameter 2 |
|---|---|---|---|---|---|
|
Log Level: Service |
|||||
|
|
model path to the callback operation
|
|
|
|
IP address of the caller
|
REST Service
|
Domain |
Component |
Log Type |
Transaction ID |
State |
Parameter 1 |
Parameter 2 |
Correlation ID |
|---|---|---|---|---|---|---|---|
|
Log Level: Service |
|||||||
|
|
model path to the REST operation
|
|
HTTP header X-Transaction-ID if present |
|
|
IP address of the caller
|
HTTP header X-Request-ID if present |
|
|
HTTP header X-Transaction-ID
|
||||||
SAP Service
|
Domain |
Component |
Log Type |
State |
Parameter 1 |
Parameter 2 |
|---|---|---|---|---|---|
|
Log Level: Service |
|||||
|
|
model path to the SAPRFC operation
|
|
|
|
IP address of the caller
|
Scheduler Service
|
Domain |
Component |
Log Type |
State |
Parameter 1 |
Parameter 2 |
|---|---|---|---|---|---|
|
Log Level: Service |
|||||
|
|
model path to the scheuler |
|
|
|
|
SOAP Service
|
Domain |
Component |
Log Type |
Transaction ID |
State |
Parameter 1 |
Parameter 2 |
Correlation ID |
|---|---|---|---|---|---|---|---|
|
Log Level: Service |
|||||||
|
|
model path to the SOAP operation
|
|
HTTP header X-Transaction-ID if present |
|
|
IP address of the caller
|
HTTP header X-Request-ID if present |
|
|
HTTP header X-Transaction-ID
|
||||||
Timer and Event Observer Service
|
Domain |
Component |
Log Type |
State |
Parameter 1 |
Parameter 2 |
|---|---|---|---|---|---|
|
Log Level: Service |
|||||
|
|
model path to the timer |
|
|
|
|
Transaction Log System Log Details
|
Domain |
Component |
Log Type |
State |
Parameter 1 |
Parameter 2 |
|---|---|---|---|---|---|
|
Log Level: Service |
|||||
|
|
request service status |
|
|
|
IP address of the caller
|
|
request long running session threshold
|
|
|
|
||
|
reload changed tab files (e.g. due to changes to service preferences)
|
|
|
|
||
|
request service shutdown
|
|
|
<user that has triggered the action>
|
||
Transaction Log xUML Runtime API Details
|
Domain |
Component |
Log Type |
State |
Parameter 1 |
Parameter 2 |
|---|---|---|---|---|---|
|
Log Level: Service |
|||||
|
|
|
|
|
|
IP address of the caller
|