- Configuring the DocuSign Connector
- Performing the Post-Configuration Tasks for DocuSign Connector
- Managing Logging for the Connector
- Enabling Logging
4.3.2 Enabling Logging
Perform this procedure to enable logging in Oracle WebLogic Server.
To enable logging in Oracle WebLogic Server:
- Edit the logging.xml file as follows:
-
Add the following blocks in the file:
<log_handler name='DocuSign-handler' level='[LOG_LEVEL]' class='oracle.core.ojdl.logging.ODLHandlerFactory'><property name='logreader:' value='off'/> <property name='path' value='[FILE_NAME]'/> <property name='format' value='ODL-Text'/> <property name='useThreadName' value='true'/> <property name='locale' value='en'/> <property name='maxFileSize' value='5242880'/> <property name='maxLogSize' value='52428800'/> <property name='encoding' value='UTF-8'/> </log_handler> <logger name="ORG.IDENTITYCONNECTORS.GENERICREST" level="[LOG_LEVEL]" useParentHandlers="false"> <handler name="DocuSign-handler"/> <handler name="console-handler"/> </logger> <logger name="ORG.IDENTITYCONNECTORS.RESTCOMMON" level="[LOG_LEVEL]" useParentHandlers="false"> <handler name="DocuSign-handler"/> <handler name="console-handler"/> </logger>
-
Replace both occurrences of [LOG_LEVEL] with the ODL message type and level combination that you require. Similarly, replace [FILE_NAME] with the full path and name of the log file in which you want log messages specific to connector operations to be recorded. The following blocks show sample values for [LOG_LEVEL] and [FILE_NAME] :
<log_handler name='DocuSign-handler' level='NOTIFICATION:1' class='oracle.core.ojdl.logging.ODLHandlerFactory'><property name='logreader:' value='off'/> <property name='path' value='F:\MyMachine\middleware\user_projects\domains\base_domain1\servers\oim_server1\logs\oim_server1-diagnostic-1.log'/> <property name='format' value='ODL-Text'/> <property name='useThreadName' value='true'/> <property name='locale' value='en'/> <property name='maxFileSize' value='5242880'/> <property name='maxLogSize' value='52428800'/> <property name='encoding' value='UTF-8'/> </log_handler> <logger name="ORG.IDENTITYCONNECTORS.GENERICREST" level="NOTIFICATION:1" useParentHandlers="false"> <handler name="DocuSign-handler"/> <handler name="console-handler"/> </logger> <logger name="ORG.IDENTITYCONNECTORS.RESTCOMMON" level="NOTIFICATION:1" useParentHandlers="false"> <handler name="DocuSign-handler"/> <handler name="console-handler"/> </logger>
With these sample values, when you use Oracle Identity Governance, all messages generated for this connector that are of a log level equal to or higher than the
NOTIFICATION:1
level are recorded in the specified file. -
- Save and close the file.
- Set the following environment variable to redirect the server logs to a file:
-
For Microsoft Windows:
set WLS_REDIRECT_LOG=FILENAME
-
For UNIX:
export WLS_REDIRECT_LOG=FILENAME
Replace FILENAME with the location and name of the file to which you want to redirect the output.
-
- Restart the application server.