1. 概述编辑
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.5 | - |
1.2 功能简介
运维平台提供「链路追踪」功能，但该功能默认仅对容器化部署的应用生效。
本文将介绍如何将非容器化部署的 FineReport/FineBI 项目，接入链路追踪功能。
2. 操作步骤编辑
2.1 新增项目
管理员需要先将待接入链路追踪的非容器化部署的 FineReport/FineBI 项目，新增到运维平台的「项目管理」中。如下图所示：
新增项目的操作方法请参见：接入已有非容器化项目
2.2 获取containerNamePrefix值
管理员登录运维平台，点击「F12」键，点击「Network」，根据项目名称，找到对应 FineReport/FineBI 的 containerNamePrefix 值。如下图所示：
2.3 上传skywalking-java-agent文件夹
付费用户请联系技术支持获取skywalking-java-agent压缩包。
技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。
解压后，将skywalking-java-agent文件夹上传到 FineReport/FineBI 项目所在服务器的任意目录下。
2.4 项目增加启动参数
FineReport/FineBI 增加启动参数。
启动参数内容包括：
JAVA_OPTS="$JAVA_OPTS -javaagent:${skywalkingAgentDirPath}/skywalking-agent.jar -Dskywalking.agent.service_name=${containerNamePrefix}::fr -Dskywalking.agent.instance_name=${frIp}:${frPort} -Dskywalking.collector.backend_service=${skywalkingOapIP}:11800"
JAVA_OPTS="$JAVA_OPTS -Dskywalking.plugin.jdkthreading.threading_class_prefixes=com.fr.data.impl.restriction. -Dskywalking.plugin.tomcat.collect_http_params=true"
| 参数 | 参数值 | 说明 |
|---|---|---|
| -javaagent | ${skywalkingAgentDirPath}/skywalking-agent.jar | ${skywalkingAgentDirPath}为： skywalking-java-agent文件夹所在目录 |
| -Dskywalking.agent.service_name | ${containerNamePrefix}::fr | ${containerNamePrefix}为： 2.2节获取的 containerNamePrefix 值 |
| -Dskywalking.agent.instance_name | ${frIp}:${frPort} | ${frIp}：FineReport/FineBI工程节点IP ${frPort}：FineReport/FineBI工程节点端口 |
| -Dskywalking.collector.backend_service | ${skywalkingOapIP}:11800 | ${skywalkingOapIP}： skywalking oap组件所在服务器IP |
| -Dskywalking.plugin.jdkthreading.threading_class_prefixes | com.fr.data.impl.restriction. | - |
| -Dskywalking.plugin.tomcat.collect_http_params | true | - |
启动参数示例：
1）找到%Tomcat%/bin目录下的catalina.sh/setenv.sh文件
注：若有setenv.sh文件，优先将启动参数加在该文件中，若无setenv.sh文件，则加在catalina.sh文件中。
2）新增配置
JAVA_OPTS="$JAVA_OPTS -javaagent:/usr/local/tomcat/webapps/webroot/WEB-INF/skywalking-java-agent/skywalking-agent.jar -Dskywalking.agent.service_name=fanruan221124170529::fr -Dskywalking.agent.instance_name=192.168.101.36:8080 -Dskywalking.collector.backend_service=192.168.101.36:11800"
JAVA_OPTS="$JAVA_OPTS -Dskywalking.plugin.jdkthreading.threading_class_prefixes=com.fr.data.impl.restriction. -Dskywalking.plugin.tomcat.collect_http_params=true"
3）配置完成后重启工程。
2.5 重启项目
重启FineReport/FineBI项目，即可将该非容器化部署的 FineReport/FineBI 项目，接入链路追踪功能。
注：FineReport/FineBI工程下的所有节点，都需要依次进行以上操作。