Enabling logging for web services

 This topic describes steps to enable logging for web services.

To enable logging for web services

1. Edit the logback_server.xml file by using ConfigMaps.
   For more information, see the topic Using ConfigMaps to access the configuration files.

2. Update the file with the following lines:

   <logger name="com.bmc.arsys.ws.client.WebServiceSoapClientImpl"   
                  level="debug" additivity="false">
                  <appender-ref ref="ServerLog" />
   </logger>
3. Restart the AR System server.
   If you have provided the appender-ref as ServerLog, the logs for web services will be generated in arerror.log file.

To create a separate log file for web services

1. Create new appender in the logback_server.xml file. The logback_server.xml file is located at <install-location>/conf.
2. Locate and copy the existing appender "ServerLog".

3. Paste the existing appender "ServerLog" after the last appender.
   Refer to the following example for a new appender entry:

   <appender name="webservicelog" class="com.bmc.arsys.logging.SuspendableRollingFileAppender">
         <file>${com.bmc.arsys.homedir}/${com.bmc.arsys.server.dbdir}/arwebsvc.log</file>
         <append>true</append>
         <enableThreadLogging>true</enableThreadLogging>
         <!-- <param name="Encoding" value="UTF-8" /> -->
         <rollingPolicy class="com.bmc.arsys.logging.StoredRollingPolicy">
            <fileNamePattern>${com.bmc.arsys.homedir}/${com.bmc.arsys.server.dbdir}/arwebsvc${threadId}.log.%i</fileNamePattern>
            <minIndex>1</minIndex>
            <maxIndex>8</maxIndex>
         </rollingPolicy>
         <triggeringPolicy class="com.bmc.arsys.logging.ARSizeBasedTriggeringPolicy">
            <maxFileSize>128MB</maxFileSize>
         </triggeringPolicy>
         <encoder>
            <charset>UTF-8</charset>
            <pattern>%m%n</pattern>
         </encoder>
   </appender>
4. Change the appender name and file name from the <file> tag and the <fileNamePattern> tag. Enter rest of the information as it is. 

5. Create the logger using the created appender name in the logback_server.xml file. Create the logger after the last logger in file.
   Refer to the following example for a new logger entry:

   <logger name="com.bmc.arsys.ws.client.WebServiceSoapClientImpl"   
                  level="debug" additivity="false">
                  <appender-ref ref="webservicelog" />
   </logger>
6. Save the logback_server.xml file.
7. Restart the AR System server.
8. Open the file location mentioned in logback_server.xml file and verify that the newly created file is present.

Related topics

Publishing-the-AR-System-functionality-as-a-web-service