创建应用监控任务
基调听云应用与微服务提供包括拓扑自动发现、调用链追踪、性能问题诊断以及故障告警和定位在内的多种应用性能监测手段和管理服务。如果您想要使用基调听云应用与微服务开始监控您的应用,那么需要先创建应用监控任务。
应用与微服务产品可以监控运行在多种容器环境下的多种开发语言的应用。本文以在Linux系统的Tomcat环境下运行的Java应用为例,介绍如何创建一个应用监控任务。应用与微服务产品提供手动安装和自动安装两种方式来安装Java探针,目前仅Tomcat、Jetty、JBoss、WildFly、Glassfish容器支持自动安装。本文示例中采用的是手动安装探针的方法。
前提条件
在安装探针前,需要先确保本地浏览器时间与服务器时区、时间都一致。若有多个服务器,则要保证本地浏览器、多个服务器的时区、时间都一致。否则,可能会影响数据的准确性,例如拓扑不正确等。
第一步:安装Agent Collector
在安装探针前,需要先安装Agent Collector(以下简称Collector)。请按照以下步骤进行安装Collector:
在左侧导航栏中依次点击应用与微服务>部署管理,然后选择下载中心页签,选择Agent Collector进行下载。
将tingyun-collector-3.5.1-with-jre.tar.gz放到任意目录并解压。
tar -zxvf tingyun-collector-3.5.1-with-jre.tar.gz
说明:基调听云提供了两种安装包,分别是带JRE版和不带JRE版,可以从名称中进行鉴别。如果安装环境中已经安装了JDK( JDK版本必须为1.8及以上),可以安装不带JRE版;如果安装环境中没有安装JDK,请安装带JRE版。推荐安装带JRE版。
修改/tingyun-collector目录下的collector.properties文件。
配置Redirect server服务地址
redirect.host=10.128.2.28
配置Redirect server服务端口
redirect.port=7071
配置Collector 所在的机房名称(可不修改)
collector.idc=default
指定Collector服务暴露给探针的IP地址,建议您配置此项。
collector.ip=10.128.1.120
指定Collector服务暴露给探针的端口号。Docker容器内使用 -p 映射端口时,需要配置此项。默认值和 collector.listen 一致。
collector.port=
配置Collector 服务的监听端口,默认值: 7665
collector.listen=7665
在/tingyun-collector目录下执行start.sh启动Collector。
部署成功后,在左侧导航栏中单击部署管理菜单,然后在页面上方单击Collectors页签,可以看到新部署的Collector信息。
第二步:安装探针
在左侧导航栏中依次点击应用与微服务>部署管理,然后选择下载中心页签,选择Java Agent进行下载。
解压缩安装文件包到你的应用服务器的根目录。
unzip tingyun-agent-java-3.4.6.zip -d /path/to/appserver/
说明:“/path/to/appserver”是示例路径,请用户根据自身不同的环境修改正确的目录。
修改放在服务器解压的tingyun目录下tingyun.properties文件。
方式一:修改配置文件
修改放在服务器解压的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服务器地址和端口号都配置进来,以英文逗号分隔。
在应用服务器的启动脚本中配置 JAVA_OPTS,添加以下JVM参数 。
export JAVA_OPTS="$JAVA_OPTS -javaagent: /${路径}/tingyun-agent-java.jar"
说明:
${路径}
为应用服务器的绝对路径,请用户根据自身不同的环境创建和修改目录。- 在其他容器的部署请参见手动安装。
第三步:启动或重启应用服务器
登录基调听云应用与微服务系统查看性能数据。当您的Java应用服务有HTTP请求进入,性能数据将发送到基调听云应用与微服务系统。重启5分钟后,若您的应用出现在基调听云应用与微服务控制台的业务系统列表或应用列表中且有数据上报,则说明探针部署成功。
注意:如果在几分钟之内,你没有看到任何应用性能数据,可以按照以下方式获取帮助:
- 请按照以上步骤重新查看是否安装正确、目录是否正确、启动脚本是否正确。
- 请检查tingyung.properties中的license_key是否与您创建应用中的看到的License Key一致。
- 以上方式都无效时,查看
/${路径}/tingyun/logs/tingyun_agent.log
日志文件,可将探针的日志文件发送给基调听云的技术支持人员寻求帮助。