inspectit/tomcat

Tomcat with inspectIT

基于官方Tomcat Docker镜像构建，集成开源APM解决方案inspectIT的agent，可直接作为标准Tomcat镜像的替代品使用，仅需将现有Dockerfile中的FROM tomcat:latest替换为FROM inspectit/tomcat:latest即可。

核心功能与特性

• 基于官方Tomcat镜像，完全兼容原有Tomcat功能
• 集成inspectIT agent，提供应用性能监控(APM)能力
• 支持通过环境变量自定义agent配置，灵活适配不同监控需求
• 可无缝替换现有Tomcat部署，最小化迁移成本

使用场景

适用于需要对部署在Tomcat上的Java应用进行性能监控、问题诊断和性能优化的场景，尤其适合开发、测试和生产环境中快速集成APM功能的需求。

快速启动

1. 启动inspectIT CMR

首先需要运行inspectIT CMR（Central Measurement Repository），可使用官方CMR镜像：

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

2. 启动Tomcat容器

启动Tomcat容器并链接到CMR：

bash
$ docker run -d --link inspectIT-CMR:cmr -p 8080:8080 inspectit/tomcat

启动后，可通过inspectIT UI调整 instrumentation配置以满足需求，详情参见官方文档。

配置说明

Agent名称

默认情况下，inspectIT agent使用容器主机名（docker ID）作为agent名称。可通过以下方式自定义：

通过环境变量设置

bash
$ docker run -d --link inspectIT-CMR:cmr -e AGENT_NAME=<自定义agent名称> inspectit/tomcat

通过设置主机名

bash
$ docker run -d --link inspectIT-CMR:cmr -h <自定义agent名称> inspectit/tomcat

使用自定义inspectIT CMR

若不使用inspectIT CMR docker镜像或无法通过--link链接，可手动指定CMR的IP地址和端口：

bash
$ docker run -d -e INSPECTIT_CMR_ADDR=<cmr-ip地址> -e INSPECTIT_CMR_PORT=<cmr端口> inspectit/tomcat

指定版本信息

Tomcat版本

当前镜像基于最新的官方Tomcat镜像构建，后续将支持更多Tomcat版本。

inspectIT版本

当前镜像基于最新的inspectIT beta版本构建，后续将支持更多inspectIT版本。

构建镜像

如需自行构建该镜像，克隆仓库后执行：

bash
$ docker build -t inspectit/tomcat .