ARMS已支持白屏接入ECS环境上的Java应用。初次接入时,您只需重启一次应用进程即可完成探针接入,无需修改应用启动脚本。后续探针的升级、维护,也将由ARMS探针底座自动完成,无需人工参与。本文介绍如何为ECS主机应用安装ARMS探针。

前提条件

  • 请确认您的应用部署在阿里云的ECS服务器上,且已安装阿里云云助手。具体操作,请参见安装云助手Agent
  • 请确认您的ECS服务器安装的是Linux操作系统,非Linux系统ECS列表页将被过滤。
  • 请确认您的ECS服务器使用的是专有网络,经典网络下的ECS应用暂不支持当前安装方式。
    说明 您可以使用手动接入方式为经典网络下的ECS应用安装探针。具体操作,请参见为Java应用手动安装Agent
  • 请确认您的应用采用的是主机部署方式,非主机部署方式(如Docker、Kubernetes部署)暂不支持当前安装方式。
    说明
  • 确保您使用的第三方组件或框架在应用监控兼容性列表范围内,请参见应用监控兼容性列表
  • 检查您的JDK版本。ARMS应用监控支持的JDK版本如下:
    • JDK 1.7.0+
      重要 ARMS应用监控将于3.0.X探针版本终止支持Java 7,如果您还在使用Java 7,请尽快升级Java版本。更多信息,请参见ARMS应用监控终止支持Java 7的说明
    • JDK 1.8.0_25+
      说明
      • Kubernetes集群应用部署建议:JDK 1.8.0_191+。
      • 如果JDK版本为1.8.0_25或者1.8.0_31,可能会出现无法安装探针的情况,请升级至1.8.X最新版本。
    • JDK 11.0.8+
    • JDK 17

安装探针

如果您的应用之前已经手动安装了ARMS探针,那么需要先从部署脚本中移除手动安装的配置内容,然后再通过白屏安装接入。具体操作,请参见卸载Agent

  1. 登录ARMS控制台,在左侧导航栏选择应用监控 > 应用列表
  2. 应用列表页面顶部选择目标地域,然后单击接入应用
  3. 接入应用面板单击Java,然后选择ECS安装
  4. 输入应用名称,选择应用所在的ECS实例,然后单击检测Java进程
    说明 您可以通过ECS标签对ECS实例进行过滤,也可以参考已接入的应用选择正确的ECS实例。
    安装ECS应用1
  5. 检测Java进程向导页选择要接入的应用对应的进程组。
    说明
    • ECS扫描出的进程默认按照进程工作目录进行分组,您可以选择多个进程组。
    • 您可以在ECS服务器上使用ls -al /proc/${pid}/cwd命令查看进程工作目录。
    如果您的Java进程没有被扫描出来,请确认应用是否通过主机方式部署(容器部署的应用暂不支持当前接入方式),如果确认是主机部署方式,请在ECS上执行以下命令,并将返回内容截图发给ARMS钉钉服务账号arms160804进行问题排查。
    1. 查看本地detector插件版本。
      ls -al /usr/local/share/aliyun-assist/plugin/arms-plugin-detector/

      例如:当前版本是0.4。

    2. 以debug模式运行detector插件,查看返回结果。
      /usr/local/share/aliyun-assist/plugin/arms-plugin-detector/0.4/bin/detector --logger-level=DEBUG
    安装ECS应用2
  6. 单击执行安装,在执行安装向导页查看安装结果。
    安装ECS应用3
  7. 初次安装时,系统将提示您重启应用进程,重启后即可完成探针接入。
    当页面显示探针安装成功,监控数据已就绪时表示探针已安装成功。
    说明 初次安装时需要等待1分钟左右。
    如果重启后页面状态显示目标Java进程未找到,需要确认重启时是否变更了命令和脚本执行目录,导致进程的工作目录发生了变化,可以通过以下命令进行确认:
    1. 找到对应的Java进程并获取进程PID。
      ps -ef | grep java
    2. 执行以下命令查看进程目录。
      ls -al /proc/${pid}/cwd
    安装成功
  8. 单击查看应用,进入ARMS应用详情页。
    说明 初次接入探针时,可能需要等待1~2分钟,这是由于应用启动需要一些时间,监控数据本身也会有短暂的延迟。
    应用详情

结果验证

  1. ARMS控制台应用监控 > 应用列表页面查看是否存在刚接入的Java应用。
  2. 单击应用名称,查看应用总览页面是否有数据上报。
    如果存在数据,则说明接入成功。

卸载探针

  1. 登录ARMS控制台,在左侧导航栏选择应用监控 > 应用列表
  2. 应用列表页面顶部选择目标地域,然后单击目标应用名称。
    说明 语言列显示Java图标图标的应用为接入应用监控的应用,显示-图标的应用为接入可观测链路 OpenTelemetry 版的应用。
  3. 在左侧导航栏单击应用设置
  4. Agent状态页签卸载应用实例。
    • 卸载单个实例:

      在目标实例右侧单击卸载

    • 批量卸载实例:

      选择所有需要卸载的实例节点,然后单击批量卸载

    卸载ECS
  5. 在弹出的提示框中单击确定卸载
    卸载成功后,操作列会提示Agent已卸载,将在下次应用重启时生效已卸载ECS实例
  6. 重启应用,等待1~2分钟后,在左侧导航栏单击应用详情,查看监控数据是否已停止上报。
    如果监控数据已停止上报,说明已卸载成功。
    说明 5分钟左右后,Agent状态页签将不再显示已卸载的实例。
    卸载后数据停止上报

常见问题

如何查看Agent日志?

ECS白屏安装的Agent日志路径为/opt/.arms/apm-agent/${pid}/current/ArmsAgent/logs/xxxx.log