Configuring Server Logs

Logging is configured via logback.xml. By default, the logging level is set to INFO.

The provided logback.xml configures logging to ${user.home}/oslc-connect-jira-cloud/logs/broker.log. You can customize the log location by editing the LOG_LOCATION property in the file.

<property name="LOG_LOCATION" value="${user.home}/oslc-connect-jira-cloud/logs"/>

Default logback.xml Configuration

<configuration scan="true" scanPeriod="15 seconds">

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <property name="LOG_LOCATION" value="${user.home}/oslc-connect-jira-cloud/logs"/>
  <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_LOCATION}/broker.log</file>
    <append>true</append>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <fileNamePattern>${LOG_LOCATION}/broker.log.%d{yyyy-MM-dd}.gz</fileNamePattern>
      <maxHistory>10</maxHistory>
      <totalSizeCap>2GB</totalSizeCap>
    </rollingPolicy>
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>

  <root level="INFO">
    <!-- Uncomment below appender if you want to have the logs directly in console output -->
    <!-- <appender-ref ref="STDOUT" /> -->
    <appender-ref ref="FILE"/>
  </root>

  <!-- Don't want Jena warning on missing (and unused) java-jsonld library -->
  <logger name="org.apache.jena.riot.RDFLanguages" level="ERROR"/>

  <logger name="com.sodius" level="INFO"/>

  <!-- Apache HTTP Client logging -->
  <logger name="org.apache.http" level="INFO"/>

</configuration>

The log file is automatically reloaded when changes are made (thanks to scan="true").

Enable Debug Logging

To enable detailed logging for troubleshooting, change the logger level you need or add specific loggers.

<logger name="com.sodius" level="DEBUG"/>