在Docker环境安装Java探针

前提条件

• 安装人员熟悉Java探针的手动安装过程。
• 已安装好Agent Collector。
• 在安装探针前，需要先确保本地浏览器时间与服务器时区、时间都一致。若有多个服务器，则要保证本地浏览器、多个服务器的时区、时间都一致。否则，可能会影响数据的准确性，例如拓扑不正确等。

Dockerfile形式安装Java探针

以Tomcat环境为例，Dockerfile文件如下图所示：

1. 下载探针，将探针放在Dockerfile同级目录。

2. 将探针安装包放到Docker镜像内指定目录，并自动解压。

   说明：有的Dockerfile生成的容器不支持unzip命令，建议先将探针的zip包在本地解压，再传入镜像内。

   ADD tingyun-agent-java-2.7.1.zip /opt/apache-tomcat-8.5.11/
   

3. 备份修改的脚本文件。

   RUN cp /opt/apache-tomcat-8.5.11/bin/catalina.sh /opt/apache-tomcat-
   8.5.11/bin/catalina.sh.bak
   

4. 修改catalina.sh配置文件，增加探针启动参数。

   RUN sed -i '1a\export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/opt/apache-
   tomcat-8.5.11/tingyun/tingyun-agent-java.jar -Dtingyun.config.nbs.app_name=${TINGYUN_APP_NAME} -Dtingyun.config.nbs.license_key=${TINGYUN_LICENSE_KEY}"' /opt/apache-tomcat-
   8.5.11/bin/catalina.sh 
   

5. 执行docker build 命令，则创建出来的镜像包含Java探针。

6. 基于镜像，创建容器并添加环境变量。

   docker run -it -e TINGYUN_APP_NAME=TINGYUN -e TINGYUN_LICENSE_KEY=999-999-999 --name tomcat tomcat
   

7. 等待5分钟左右，查看探针日志和报表，观察性能数据上传是否正常。

参数说明

配置 JAVA_OPTS，在-javaagent后加以下参数，中间以空格分隔：

-Dtingyun.config.nbs.app_name=${TINGYUN_APP_NAME}
-Dtingyun.config.nbs.license_key=${TINGYUN_LICENSE_KEY} 
#以下3个参数仅在私有化环境下配置。
-Dtingyun.config.nbs.host=${TINGYUN_HOST} 
-Dtingyun.config.nbs.port=${TINGYUN_PORT} 
-Dtingyun.config.nbs.ssl=${TINGYUN_SSL}

• -Dtingyun.app_name：应用名称，建议配置为应用的业务名称。
• -Dtingyun.license_key：与您的基调听云账号关联。探针采集到的数据，会上传到该LicenseKey绑定的账号下。
• -Dtingyun.config.nbs.host：服务器的地址，例如tingyun.server.com。仅私有化部署时配置。
• -Dtingyun.config.nbs.port：服务器的端口号，例如8080。仅私有化部署时配置。
• -Dtingyun.config.nbs.ssl：是否使用HTTPS加密传输。默认是false。仅私有化部署时配置。