Service Layer Logging for Inbound Requests
Data can be loaded to OneData using inbound service requests through REST, Interchange Mapping, and JMS. You can configure and view audit logs for such service requests. The service audit logs provide information about operations performed on the data that is imported to OneData along with what the original data was in the source payload.
OneData provides you the flexibility of accessing the service audit logs for service requests either through the OneData interface, or through REST requests. You would need to configure both service audit logging and access to the audit logs through REST request responses in the onedata.properties configuration file.
To see the required configurations for audit logging of service requests, see
Configuring Service Audit Logging.
Should any errors occur in completing the inbound service requests successfully, error logs are created.
For details on how to access the service request errors, see
Viewing Service Layer Error Logs for Inbound
Requests.
Log Levels
The default log level is Detailed. You can change the log level to no logging, Basic, or Advanced either at the individual Interchange Mapping profile level or global level in the onedata.properties configuration file.
Logging Level | Master Table Entries | Detail Table Entries |
Basic | OneData Service Audit Master IdOneData Service TypeOneData Service ChannelOneData Service Payload FormatOneData Service Source SystemCreated DateCreated UserOneData Service StatusOneData Service Status MessageInterchange MappingDuration (ms)Master Object | N/A |
Detailed | OneData Service Audit Master IdOneData Service TypeOneData Service ChannelOneData Service Payload FormatOneData Service Source SystemCreated DateCreated UserOneData Service StatusOneData Service Status MessageInterchange MappingDuration (ms)Master Object | OneData Service Audit Detail IdOneData Service Audit Master IdOneData Primary KeyDML ActionOneData Service Record DetailOneData Service Record StatusDetail ObjectOneData Service Record Status MessageCreated Date |
Advanced | OneData Service Audit Master IdOneData Service TypeOneData Service ChannelOneData Service Payload FormatOneData Service Source SystemCreated DateCreated UserOneData Service StatusOneData Service Status MessageInterchange MappingDuration (ms)Master ObjectPayloadInterchange Mapping Info | OneData Service Audit Detail IdOneData Service Audit Master IdOneData Primary KeyDML ActionOneData Service Record DetailOneData Service Record StatusDetail ObjectOneData Service Record Status MessageCreated Date |
System and Reference Objects for Service Layer Logs
OneData creates a set of system and reference objects that required to view the service audit logs within the Service Layer folder. The Service Layer folder contains the following system and reference objects in the System Objects and Reference Data folders, respectively.
Table 1. System Objects
Object Name | Description |
OneData Service Audit | A de-normalized view of all service audit logs present in OneData. |
OneData Service Audit Detail | Service audit log that describes processing details at the record level. Every incoming service call generates a single entry for each record processed in this log. |
OneData Service Audit Master | Service audit log that describes the result, duration and other summary details of the process involving one or more records coming into OneData as payload. Every incoming service call generates a single entry in this log, irrespective of the number of records processed. |
OneData Service Audit [CO] | Service audit log with a hierarchical organization of job record level information. |
Table 2. Reference Data Objects
Object Name | Description |
OneData Service Action | Holds the possible values for OneData DML actions:  Insert Update Delete Restore Purge |
OneData Service Audit Detail | |
OneData Service Audit Master | |
OneData Service Channel | Holds the possible values of the source or channel from which OneData receives the payload: REST JMS Java API Interchange Mapping |
OneData Service Payload Format | Holds the possible values for formats in which the payload can be defined: XML Delimited Remote Database |
OneData Service Record Status | Holds the possible values for the record level status shown in the Detail table: Success Failed Ignored Sent to Exception Queue Retriggered from exception queue : Success Retriggered from exception queue : Error No Change Changes Rolled Back You can view more details about these statuses in the OneData Service Record Status Description column of the log. |
OneData Service Status | Holds the possible values at the job level status shown in the Master table: Active Completed Successfully Completed with Errors You can view more details about these statuses in the OneData Service Status Description column of the log. |
OneData Service Type | Holds the possible values for the service type: Inbound Outbound — Currently not used. |