Configuring Spring Insight

You configure Spring Insight by editing the insight.properties file, located in the insight directory of the tc Runtime instance. For example, if you created an instance called insight-instance, then its configuration file is in a subdirectory of the tc Server installation directory at ./insight-instance/insight/insight.properties.

In the properties file, each property is on its own line. The properties take the form property: value. Comments begin with #.

The following table describes the properties you can set in the insight.properties file.

Table 1. Properties of the insight.properties File

Property and Default SettingDescription
insight.data.dirSpecifies the full pathname of the directory in which Spring Insight persists its data. If you do not specify a value for this property, the default data directory is INSTANCE_DIR/insight/data.
application.context. ignore.identifierSpecifies the application contexts that you want Spring Insight to ignore. Spring Insight will not instrument these applications, which in turn improves the startup time of the application.

The default insight.properties file excludes the Spring Insight application itself from being instrumented by adding the following entry:

application.context.ignore.dashboard: localhost|insight

The identifier part of the property name (such as dashboard in the example above) is not used internally by Spring Insight. Use this part of the property name to separate multiple entries; specify an identifier that has meaning to you.

The value of this property must be of the form localhost|context where context refers to the URL context that invokes the application. The value of context refers to the URL context you specify in a browser to invoke the application. By default, this is the name of the WAR file in which the application is packaged, but you can specify a different name in the web.xml file.

database.urlSpecifies the URL of the database that Spring Insight uses to persist its data.

Note: Spring Insight bundles the H2 Java SQL database and uses it internally to persist its data. A tc Runtime instance configured with Spring Insight is automatically configured to internally connect and use the H2 database.

database.driverClassNameSpecifies the class name of the JDBC Driver that Spring Insight uses to connect to the database.
database.usernameSpecifies the name of the user that connects to the database that Spring Insight uses to persist its data.
database.passwordSpecifies the password of the user that connects to the database that Spring Insight uses to persist its data.
trace.exclude.path.typeProvides a list of patterns that are matched against requests. When a trace matches a path in this list, the trace is discarded. This setting lets you ignore requests to static content such as .css or .js files. Specify this property multiple times, one for each type of pattern you want to exclude.

For example:

trace.exclude.path.png: /**/*.png
trace.exclude.path.gif: /**/*.gif
trace.exclude.path.jpg: /**/*.jpg
trace.exclude.path.css: /**/*.css
trace.exclude.path.js: /**/*.js