自动安装说明
前提条件
- 在安装探针前，请先安装好Agent Collector。
- 在安装探针前，需要先确保本地浏览器时间与服务器时区、时间都一致。若有多个服务器，则要保证本地浏览器、多个服务器的时区、时间都一致。否则，可能会影响数据的准确性，例如拓扑不正确等。
- 目前仅Tomcat、Jetty、JBoss、WildFly、Glassfish容器支持自动安装。
通过修改配置文件安装
Linux or Mac系统安装
解压缩安装文件包到你的应用服务器的根目录。
unzip tingyun-agent-java-3.4.6.zip -d /{workspace}/修改配置项。您可以通过两种方式进行配置。
方式一：修改配置文件
修改放在服务器解压的tingyun目录下tingyun.properties文件。
修改文件中的license_key、app_name和collector.addresses配置项，否则探针无法进行数据采集也无法启动探针。对于其他配置项，请根据实际需要进行配置。
- license_key：与您的基调听云账号关联。探针采集到的数据，会上传到该LicenseKey绑定的账号下。将鼠标悬浮在左下角的账号名称位置，在悬浮菜单中选择账户管理，在账号信息页签中查看LicenseKey。
- app_name：缺省应用名称，建议配置为应用的业务名称。
- collector.addresses：Agent Collector服务器的地址和端口号，例如：tingyun.server.com:8080。Agent Collector在高可用部署模式下，请务必将同一机房内所有的Agent Collector服务器地址和端口号都配置进来，以英文逗号分隔。
方式二：添加JVM参数
配置catalina.sh中的 JAVA_OPTS，在
-javaagent后加以下三个参数，中间以空格分隔：-Dtingyun.app_name=${APP_NAME} -Dtingyun.license_key=${LICENSE_KEY} -Dtingyun.coll ector.addresses=${COLLECTOR_ADDRESSES}- -Dtingyun.app_name：应用名称，建议配置为应用的业务名称。
- -Dtingyun.license_key：与您的基调听云账号关联。探针采集到的数据，会上传到该LicenseKey绑定的账号下。将鼠标悬浮在左下角的账号名称位置，在悬浮菜单中选择账户管理，在账号信息页签中查看LicenseKey。
- -Dtingyun.collector.addresses：Agent Collector服务器的地址和端口号，例如：tingyun.server.com:8080。Agent Collector在高可用部署模式下，请务必将同一机房内所有的Agent Collector服务器地址和端口号都配置进来，以英文逗号分隔。
在tingyun目录下执行自动安装程序。
cd /{workspace}/tingyun java -jar tingyun-agent-java.jar install
启动或重启应用服务器。
登录应用与微服务控制台查看性能数据。
当您的Java应用服务有HTTP请求进入，性能数据将发送到应用与微服务系统。重启5分钟后，若您的应用出现在应用与微服务控制台的业务系统列表或应用列表中且有数据上报，则说明探针部署成功。
注意：如果在几分钟之内，你没有看到任何应用性能数据，可以按照以下方式获取帮助：
- 请按照以上步骤重新查看是否安装正确、目录是否正确、启动脚本是否正确。
- 请检查tingyung.properties中的license_key是否与您创建应用中的看到的License Key一致。
- 以上方式都无效时，查看
/${路径}/tingyun/logs/tingyun_agent.log日志文件，可将探针的日志文件发送给基调听云的技术支持人员寻求帮助。
Windows系统安装
打开 tingyun-agent-java-x.x.x.zip。
拷贝tingyun目录到你的应用服务器的根目录。
修改放在服务器解压的tingyun目录下tingyun.properties文件。
修改文件中的license_key、app_name和collector.addresses配置项，否则探针无法进行数据采集也无法启动探针。对于其他配置项，请根据实际需要进行配置。
- license_key：与您的基调听云账号关联。探针采集到的数据，会上传到该LicenseKey绑定的账号下。将鼠标悬浮在左下角的账号名称位置，在悬浮菜单中选择账户管理，在账号信息页签中查看LicenseKey。
- app_name：缺省应用名称，建议配置为应用的业务名称。
- collector.addresses：Agent Collector服务器的地址和端口号，例如：tingyun.server.com:8080。Agent Collector在高可用部署模式下，请务必将同一机房内所有的Agent Collector服务器地址和端口号都配置进来，以英文逗号分隔。
在命令行窗口执行：(唤起控制台：Windows键+ R，然后输入cmd)。
cd tingyun java -jar tingyun-agent-java.jar install启动或重启你的应用服务器。
登录应用与微服务控制台查看性能数据。
当您的Java应用服务有HTTP请求进入，性能数据将发送到应用与微服务系统。重启5分钟后，若您的应用出现在应用与微服务控制台的业务系统列表或应用列表中且有数据上报，则说明探针部署成功。
注意：如果在几分钟之内，你没有看到任何应用性能数据，可以按照以下方式获取帮助：
- 请按照以上步骤重新查看是否安装正确、目录是否正确、启动脚本是否正确。
- 请检查tingyung.properties中的license_key是否与您创建应用中的看到的License Key一致。
- 以上方式都无效时，查看
/${路径}/tingyun/logs/tingyun_agent.log日志文件，可将探针的日志文件发送给基调听云的技术支持人员寻求帮助。