<p class="shortdesc"></p> <section><div class="tasklabel"><h2 class="doc-tairway">操作步骤</h2></div><ol class="ol steps"><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">解压Agent</strong></span> <div class="itemgroup info"> <p class="p">在console页面中，输入<code class="ph codeph">unzip detector-agent.zip -d /{any.directory}/</code>解压Agent包。</p> <div class="note note note_note"><span class="note__title">说明：</span> {any.directory}是用户自定义的路径，作为实例，用户可以进行修改。</div> </div> </li><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">添加Java启动程序参数</strong></span> <div class="itemgroup info"> <p class="p">在应用服务器的启动脚本中添加以下参数：</p> <p class="p"><code class="ph codeph">-javaagent:/{any.directory}/detector-bootstrap.jar -Ddetector.agentId={InstanceName} -Ddetector.applicationName={AppName} -Ddetector.license={License Key}</code></p> <div class="note note note_note"><span class="note__title">说明：</span> 在 Java 启动参数中加入 -javaagent 参数，指向{any.directory}目录下的 detector-bootstrap.jar 文件，并加上 -Ddetector.agentId={InstanceName}、-Ddetector.applicationName={AppName}和 -Ddetector.license={License Key}参数。其中InstanceName为实例名称，AppName为应用名称，用户进行自定义。集群中有多个实例，应用名称AppName可以相同，实例名InstanceName唯一。</div> </div> </li><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">不同的应用修改参数示例</strong></span> <div class="itemgroup info"> <p class="p"><strong class="ph b">例1：如为 Tomcat 运行环境，请在 {TOMCAT_HOME}/bin 目录下的 setenv.sh 中加入以下配置。</strong></p> <p class="p"><code class="ph codeph">JAVA_OPTS="$JAVA_OPTS -javaagent:/{any.directory}/detector-bootstrap.jar -Ddetector.agentId={InstanceName} -Ddetector.applicationName={AppName} -Ddetector.license={License Key}"</code></p> <div class="note note note_note"><span class="note__title">说明：</span> <p class="p">如果您的 Tomcat 版本没有 setenv.sh 配置文件，请打开 {TOMCAT_HOME}/bin/catalina.sh，编辑文件，在其开头第二行加入下面的代码：</p> <div class="p"> <pre class="pre codeblock"><code>CATALINA_OPTS="$CATALINA_OPTS -javaagent:/{any.directory}/detector-bootstrap.jar " CATALINA_OPTS="$CATALINA_OPTS -Ddetector.agentId={InstanceName} " CATALINA_OPTS="$CATALINA_OPTS -Ddetector.applicationName={AppName} " CATALINA_OPTS="$CATALINA_OPTS -Ddetector.license={License Key} "</code></pre> </div> </div> <div class="note note note_note"><span class="note__title">说明：</span> <p class="p">在 Windows 环境下，请在 {TOMCAT_HOME}/bin/catalina.bat 中加入：</p> <p class="p"><code class="ph codeph">Set "JAVA_OPTS=%JAVA_OPTS% -javaagent:/{any.directory}/detector-bootstrap.jar -Ddetector.agentId={InstanceName} -Ddetector.applicationName={AppName} -Ddetector.license={License Key}"</code></p> </div> <p class="p"><strong class="ph b">例2：如为 Jetty 运行环境，请在 {JETTY_HOME}/start.ini 配置文件中加入以下配置：</strong></p> <div class="p"> <pre class="pre codeblock"><code>--exec #打开注释 前面的井号去掉即可 -javaagent:/{any.directory}/detector-bootstrap.jar -Ddetector.agentId={InstanceName} -Ddetector.applicationName={AppName} -Ddetector.license={License Key}</code></pre> </div> <p class="p"><strong class="ph b">例3：如为 Spring Boot 运行环境，启动 Spring Boot 进程时，请在启动命令 java 后面加上 -javaagent 参数：</strong></p> <p class="p"><code class="ph codeph">java -javaagent:/{any.directory}/detector-bootstrap.jar -Ddetector.agentId={InstanceName} -Ddetector.applicationName={AppName} -jar demoApp.jar</code></p> <div class="note note note_note"><span class="note__title">说明：</span> demoApp.jar 为原应用 JAR 包名称，请根据实际情况替换。</div> <div class="note note note_note"><span class="note__title">说明：</span> 在 Windows 运行环境，启动 Java 进程时，请在挂载 Agent 路径中使用反斜杠（\）作为分隔符。<code class="ph codeph">{CMD}> java -javaagent:/{any.directory}/detector-bootstrap.jar -Ddetector.agentId={InstanceName} -Ddetector.applicationName={AppName} -jar {user.workspace}\demoApp.jar</code></div> </div> </li><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">重启应用</strong></span> <div class="itemgroup info"> <p class="p">在重启应用5分钟后便可以在<span class="ph uicontrol">应用接入</span>页面查看接入的应用。</p> </div> </li><li class="li step stepexpand"> <span class="ph cmd"><strong class="ph b">如需删除应用，将上述配置项删除，重启即可。</strong></span> </li></ol></section>