简介
数据采集
探针通过对特定方法嵌码,采集每个方法的响应时间以及响应时间统计分析(最大值、最小值、平均值以及标准差)。在系统中,您可以看到这些类和方法的响应时间和调用次数。
除此之外,还可以采集线程堆栈、数据库执行计划、自定义参数、HTTP请求参数等信息。例如:
- 应用请求控制器和调度活动
- 数据库操作符
- NoSQL操作符
- 数据库和NoSQL实例信息
- 外部服务调用
- 视图解析
- 未捕获的异常和计数
- 进程内存和CPU使用率
数据传输
Java探针默认使用HTTP传输数据,即使用HTTP方式传输数据,您可以在Java Agent的配置文件tingyun.properties里启动或者禁用使用HTTPS,如下图所示。
# 使用HTTPS传输数据
# 当设置为true时,探针以HTTPS接收和发送数据
# default: false
# ssl=false
说明:tingyun.properties在解压tingyung-agent-java-[version版本号].zip后的tingyun文件夹下面。
防火墙限制
如果您配置了防火墙,需要将Agent Collector的IP地址和端口添加到许可列表。如果涉及高可用部署,请务必将所有的IP地址和端口都配置进来。
如果您的host或者collector.addresses配置的是域名,可以使用dig命令查看IP,请在Linux控制台输入以下命令:
dig 域名
说明:如果dig命令无法使用,可能是还没有安装该命令。dig是bind的一部分,您可以尝试安装一下bind-utils。如果您使用的是yum,请运行yum install bind-utils命令。
流程图
说明:配置tingyun.properties后,要在相应应用容器或无容器的启动脚本的jvm参数中加入-javaagent:/${路径}/tingyun-agent-java.jar。
License Key说明
License Key是探针区别用户账号的唯一标识,请妥善保管。
LicenseKey值的查看位置:将鼠标悬浮在左下角的账号名称位置,在悬浮菜单中选择账户管理,在账号信息页签中查看LicenseKey。如下图所示:
下载探针包后,您需要手动修改tingyung.properties中的License Key值,License Key才能生效。
探针下载
在左侧导航栏中依次点击应用与微服务>部署管理,然后选择下载中心页签,选择Java Agent进行下载。探针安装包的名称为tingyun-agent-java-X.X.X.zip,其中X.X.X为具体版本号。
探针文件说明
在tingyun-agent-java-X.X.X.zip文件中包含以下内容:
- tingyun-agent-java.jar:基调听云探针文件,包含探针的核心处理逻辑和扩展plugin。
- tingyun-agent-core.jar:负责处理探针的启动、升级、卸载等。
- tingyun.properties:Java探针配置文件,包括License Key、应用名称等配置项,具体请根据配置文件中的说明来填写。
- extensions/:扩展目录,放置扩展plugins及自定义方法监控XML配置文件。
- ReleaseNote:探针版本更新说明。
探针文件运行说明
在Application Server启动的时候,探针会在tingyun-agent-java.jar的同级目录查找tingyun.properties文件。探针会在tingyunagent-java.jar所在目录中的子目录logs中记录探针运行日志(请确保该目录有写权限)。
tingyun-agent-java.jar在运行时采用的是当前主机系统时间。
注意:为确保探针上传数据的时间有效性,请在启动探针之前,确保系统时间与标准时间一致。Linux下可使用命令ntpdate –u ntp1.aliyun.com 同步当前网络时间。