Log Mechanism
The logging of the integration framework actions is managed from our generic logging mechanism. You must define first the level of logging you wish to have for the integrations you have activated using our integration framework and then you can access these logs from our audit log.
Integration Framework Log Settings
For defining the level of logging you wish, you must do the following:
- Navigate to BSS > Setup > Administration > System Options > Log Settings
- The Log Settings page include the setting for all the logs we offer. You should go at the bottom of the page and locate the field "Integration Framework"
- From the available values in the drop-down field you should select the level of logging you wish. Every option includes also the previous option(s). So the option "Warn" includes logging of the errors plus the warnings. The "Debug" option offers the most comprehensive logging of all the actions that are executed from the integration framework.
Accessing Log Entries
The logging of the integration framework actions can be viewed in BSS > Setup > Administration > Audit Logs. For filtering only the records related with the integration framework you should select in Category field the "integration framework" option. You can further filter your results by selecting the severity level and the date period.
Below is an example of a Debug entry for pushing a contact record from BSS to third party system.
Created At | Object Name | Severity | Comments |
23/03/2018 09:52:49 | Undefined | Info | |
23/03/2018 09:52:50 | Undefined | Debug | Authenticating using oAuth2 authorizationCode method for integration provider with ID dcf06ba1-6197-48a5-9b7e-a85f00bdd6b4 started. dcf06ba1-6197-48a5-9b7e-a85f00bdd6b4. |
23/03/2018 09:52:52 | Undefined | Debug | Token received for integration provider with ID dcf06ba1-6197-48a5-9b7e-a85f00bdd6b4. |
23/03/2018 09:52:52 | Undefined | Debug | Starting Syncrhonization actions event (Push), Module (Contacts), with ObjectId (3) |
23/03/2018 09:52:52 | Undefined | Debug | Getting values from external API using path https://sandbox-quickbooks.api.intuit.com/v3/company/193514681960574/account/190 |
23/03/2018 09:52:53 | Undefined | Debug | Data from API saved to body |
23/03/2018 09:52:53 | Undefined | Debug | Syncrhonization actions finished for event (Push), Module (Contacts), with ObjectId (3) |
23/03/2018 09:52:53 | Undefined | Debug | Start conditions checks for event (Push) |
23/03/2018 09:52:53 | Undefined | Debug | Starting Syncrhonization step for event (Push), Module (Contacts), with ObjectId (3) |
23/03/2018 09:52:54 | Undefined | Debug | Syncrhonization procedure for event (Push), Module (Contacts), with ObjectId (3 finished) |
23/03/2018 09:52:54 | Undefined | Debug | Syncrhonization actions finished for event (Push), Module (Contacts), with ObjectId (3) |
23/03/2018 09:52:54 | Undefined | Debug | Integration framework - Push Sync procedure for Integration provider configuration with id (dcf06ba1-6197-48a5-9b7e-a85f00bdd6b4), with SyncItem(Contacts) and ObjectId (3) finished. |