跳到主要内容

简介

数据采集​

探针通过对特定方法嵌码，采集每个方法的响应时间以及响应时间统计分析（最大值、最小值、平均值以及标准差）。在系统中，您可以看到这些类和方法的响应时间和调用次数。

除此之外，还可以采集线程堆栈、数据库执行计划、自定义参数、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 同步当前网络时间。