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。