Industrial IoT SDK for Java – Logging¶

Introduction¶

Logging of the Industrial IoT SDK for Java is implemented with SLF4J (Simple Logging Facade for Java), which gives access to many logging frameworks such as Log4j or java.util.logging. This allows the end user to plug-in the desired logging framework. This section shows how to use Log4j or Logback with the SDK's logging functionality without making any change in application code.

SDK Logging with Log4j or Logback¶

Preparation¶

Prepare Log4j for Industrial IoT SDK Logging¶

If you want to use Log4j for Industrial IoT SDK logging, you need to download SLF4J-Log4J12 and Log4J jars. Build the project and ensure the jars are available as project dependencies.

The configuration file log4j.properties must be available at the root resource folder src\main\resources.

Prepare Logback for Industrial IoT SDK Logging¶

If you want to use Logback for Industrial IoT SDK logging, you need to add the logback-classic jar to the project dependency.

The configuration file logback.xml must be available at the root resource folder src\main\resources.

Enable Logging and Set Log Levels¶

Log levels have to be configured in the configuration file of your logging framework. The Industrial IoT SDK supports the log levels DEBUG, INFO and ERROR.

The following examples illustrate how to set the rootLogger to DEBUG, which causes info, warning and error messages from all loggers in the application to be logged:

# set log level in the log4j.properties file
log4j.rootLogger=DEBUG, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d %p (%t) [%c] - %m%n

<!-- set log level in the logback.xml file -->
<?xml version="1.0" encoding="UTF-8"?>

<configuration>
  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <layout class="ch.qos.logback.classic.PatternLayout">
      <Pattern>
        %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n
      </Pattern>
    </layout>
  </appender>

  <root level="DEBUG">
    <appender-ref ref="STDOUT"/>
  </root>

</configuration>

The following examples show how to set the log level only for the Industrial IoT SDK:

#set log level in the log4j.properties file
log4j.logger.com.siemens.mindsphere.sdk = INFO

<!-- set log level in the logback.xml file -->
<logger name="com.siemens.mindsphere.sdk" level="INFO"/>

Disable logging¶

Industrial IoT SDK logs can be disabled by setting the logging level to OFF in the configuration file:

#disable logging in the log4j.properties file
log4j.logger.com.siemens.mindsphere.sdk = OFF

<!-- disable logging in the logback.xml file -->
<logger name="com.siemens.mindsphere.sdk" level="OFF"/>

// Use only if `log4j-over-slf4j` and `logback-classic` are available in project dependencies
compile ('org.springframework.boot:spring-boot-starter-web') {
    exclude module : 'log4j-over-slf4j'
    exclude module: 'logback-classic'
}