1 Introduction

This document approaches the logging system of Intershop Commerce Management from the configuration perspective. It is addressed to administrators or DevOps who configure and maintain Intershop Commerce Management instances.

This document does not describe the logging framework. For details about the framework implementation, refer to Concept - Logging.

The Intershop Commerce Management logging framework is used to log application events. Intershop Commerce Management sends logging messages via SLF4J, which interfaces to logback as logging system. The combination of SLF4J and logback allows Intershop Commerce Management to produce more detailed log information and to integrate third party APIs (log4j, Jakarta Commons Logging, java.util.logging, etc.) into its logging framework.

The application log files are located in the directory <IS_SHARE>/system/log/. The available options are controlled via logback configuration files logback-*.xml and the Intershop Commerce Management-specific logging configuration files.

1.1 Glossary

The main configurable components of the logging framework include:

1.2 References

• Overview - Infrastructure, Scaling and Performance
• Concept - Logging

2 Application Logging: Configuration

The logging framework options are controlled via a global logback configuration file and cartridge-specific logback configuration files, as well as a global Intershop Commerce Management logging configuration file and server-specific Intershop Commerce Management logging configuration files.

2.1 Logback Configuration Files

Upon application server startup, Intershop Commerce Management dynamically creates the internal main logback configuration file. This file sets some basic properties and defines a list of <include> elements, which, basically, constitute the logback-*.xml files as described below.

The internal logback configuration could look, for example, like this:

<?xml version="1.0" encoding="UTF-8" ?>
<configuration>
  <include file=".../<cartridge_name>/release/logback/logback-bc_auditing.xml"/>
  <include file=".../<cartridge_name>/release/logback/logback-bc_pricing.xml"/>
</configuration>

The central logback configuration file <IS_SHARE>/system/config/cluster/logback-main.xml controls the cluster-wide appenders and loggers. Any cartridge-specific configuration is passed via logback-<cartridgename>.xml files located in <CARTRIDGE_DIRIECTORY>/<CARTRIDGE_NAME>/release/logback. In addition, Intershop Commerce Management provides a dedicated DBinit log configuration file (<IS_SHARE>/system/config/cluster/logback-dbinit.xml), which is added to the dynamically generated configuration if the application server is started in dbinit mode.

Basically, the appender definitions in the logback-*.xml files specify

• an appender name for internal reference,
• a type (file or console) via the class attribute,
• a filter and an according level or filter expression,
• a rolling policy, e.g., for time-based or file size-based log file rolling,
• a layout and an according pattern to be used.

In addition, the logback-main.xml file defines

• levels for common logger categories, such as root assigned with the TRACE level (which should not be changed),
• assignments of appenders to categories.

For information about creating project-specific appenders or customizing existing ones, refer to the logback documentation.

The System Management application provides an interface to upload and manage additional logback configuration files, which allow for changing the logging details at server run time, e.g., for maintenance reasons. For details, see the System Management online help.

2.2 Intershop Commerce Management Logging Configuration Files

The file <IS_SHARE>/system/config/cluster/logging.properties controls the global, i.e., cluster-wide Intershop Commerce Management-specific logging settings. Intershop Commerce Management-specific logging settings can be defined locally, i.e., on application server level, using <IS_HOME>/config/appserver#.properties.

Basically, the global logging.properties file defines

• MDC enrichment for certain object types used in the current Intershop Commerce Management instance, using Java expressions

  intershop.logging.mdc.types=<type>
  intershop.logging.mdc.<type>.class=<fully_qualified_class_name>
  intershop.logging.mdc.<type>.attr.<attr1_ID>=<Java_expression>
  intershop.logging.mdc.<type>.attr.<attr2_ID>=<Java_expression>

• default categories, encoding and pattern for any dynamically created appenders, to be used as fallback if not defined explicitly, for instance

  intershop.logging.dynamictarget.categories=root
  intershop.logging.dynamicfiletarget.encoding=
  intershop.logging.dynamicfiletarget.pattern=
  [%date{yyyy-MM-dd HH:mm:ss.SSS z}]
  [%thread] %-5level %logger{36} - %msg%n

  If no encoding is specified, Intershop Commerce Management uses the default platform encoding when writing log output.

• default JDK logging adapter settings, namely

  intershop.logging.javaloggingadapter.enable=true
  intershop.logging.javaloggingadapter.exclusive=true

• level filters and category assignments for existing appenders as changed via the System Management application

• appender settings that control specific appender behavior, like, for example, intershop.logging.appender.buffer.flushInterval, which defines the interval that appenders with <immediateFlush>false</immediateFlush> (as set, for example, in logback-main.xml) are flushed

• the level of logback status messages (ERROR, WARN, INFO) that are passed to system.err and automatically appended to the application server log files, as well as the number of status messages stored with each application server, e.g.,

  intershop.logging.engine.statuslogging.level=WARN
  intershop.logging.engine.statusbuffer.size=500

3 Application Logging: Default Log Output

The following table lists the columns of the log output as provided by the default error and warn appenders defined in logback-main.xml. This information is expected, for instance, by the Intershop CIC.

Hence, a default log output could look as follows:

[2012-07-16 12:34:55.501 CEST+0200] WARN  127.0.0.1 ES1 appserver0 [] []
 com.intershop.adapter.saferpay.AcSaferpayCartridge [] [] [] [] "main"
 cartridge property: 'intershop.cartridges.ac_saferpay.sac.installation
.path' is *not* found!

4 Application Logging: Simple Commerce Management Auditing

To support PA-DSS compliance for Intershop Commerce Management-based e-commerce applications, Intershop Commerce Management features a simple logging system accessible to users in Commerce Management. It records payment-relevant Commerce Management user operations, including

• logging in,
• changing passwords,
• creating or deleting users,
• capturing or cancelling payments

into the dedicated log file audits-PCI-<IS.AS.HOSTNAME>-<IS.INSTANCE.ID>-appserver<ID>.log, located in <IS_SHARE>/system/log. The messages states the result of the performed operation (success or error), as well as any additional data, if available.

Commerce Management auditing log is enabled by default. To this end, the standard logging configuration file logback-main.xml includes a dedicated appender definition and corresponding category assignments.