Tomcat with inspectIT

Tomcat Dockerfile including inspectIT

This docker image is based on the official Tomcat docker image including the inspectIT agent of the open source APM solution www.inspectit.rocks. This image can be used easily as a replacement for the Tomcat image, meaning you only have to change your existing Dockerfile FROM tomcat:latest to FROM inspectit/tomcat:latest.

Quickstart

First you need a running inspectIT CMR. You can use our docker image:

$ docker run -d --name inspectIT-CMR -p 8182:8182 -p 9070:9070 inspectit/cmr

Now you can start a container with the following command:

$ docker run -d --link inspectIT-CMR:cmr -v $(pwd)/config:/opt/agent/active-config inspectit/tomcat

You can now adjust the instrumentation configuration in the folder config for your needs. Please refer to our documentation or just leave a comment.

Configuration

Agent name

By default, the inspectIT agent uses the hostname (docker-ID) as agent name. You can set a different name setting AGENT_NAME or hostname:

$ docker run -d --link inspectIT-CMR:cmr -v $(pwd)/config:/opt/agent/active-config -e AGENT_NAME=<agent-name> inspectit/tomcat

$ docker run -d --link inspectIT-CMR:cmr -h <agent-name> -v $(pwd)/config:/opt/agent/active-config inspectit/tomcat

Using a custom inspectIT CMR

If you don't want to use the inspectIT CMR docker image or cannot link to it, you can set the IP address and port manually:

$ docker run -d -e INSPECTIT_CMR_ADDR=<cmr-ip-address> -e INSPECTIT_CMR_PORT=<cmr-port> inspectit/tomcat

Specifying the Tomcat version

Currently, this image is based on the latest official Tomcat image. Later, support for different versions is added.

Specifying the inspectIT version

Currently, this image is based on the latest beta inspectIT release. Later, support for other versions is added.

Build the docker image

If you want to build the Tomcat inspectIT image yourself, checkout this repository and run

$ docker build -t inspectit/tomcat .