7. Configuring the SpringSource Application Platform

7.1 Configuring Serviceability

The serviceability subsystem of the SpringSource Application Platform is configured in the platform.config file found in the config directory of the Platform installation. Any relative paths in this file are relative to the root of the installation.

7.1.1 Configuring tracing

The tracing component provides two configurable settings. For example:

"trace": {
    "directory": "serviceability/trace",
    "levels": {
        "*" : "info",
        "com.foo.*" : "verbose",
        "com.foo.TheClass" : "debug",
        "com.bar.AnotherClass" : "verbose"
    }
}

In this example, the tracing component will write its output to the $PLATFORM_HOME/serviceability/trace directory. The trace component provides five different levels at which trace can be output. These are, in descending order of severity: error, warn, info, debug, and verbose. The configured levels govern what trace is output and what trace is filtered out. Trace levels can be configured for individual classes or for entire packages and package trees. In this example, every class has info level tracing enabled except for those in the com.foo package and its subpackages which have verbose level tracing enabled, com.foo.TheClass which has debug level tracing enabled, and com.bar.AnotherClass which has verbose level tracing enabled. When determining what level of trace is enabled for any given class, the tracing component will use the level of the most specific match, e.g. com.foo.TheClass is a more specific match than com.foo.*. Any classes that are not matched by any of the configured levels will have trace disabled.

7.1.2 Configuring logging

The logging component provides a single configurable setting. For example:

"logs": {
    "directory": "serviceability/logs"
}

In this example the logging component will write its output to the $PLATFORM_HOME/serviceability/logs directory.

7.1.3 Configuring dump files

The dump file component provides a single configurable setting. For example:

"dump": {
    "directory": "serviceability/dump"
}

In this example, the dump file component will write its output to the $PLATFORM_HOME/serviceability/dump directory.