为 Java 应用安装探针的常见问题_应用监控常见问题_常见问题

ARMS 探针和其他 APM 产品探针（例如 Pinpoint）是否兼容？

ARMS 探针和其他 APM 产品探针都不兼容。由于 APM 技术大部分都是基于 ASM 框架进行字节码插装，同时安装两个探针相当于对您的代码插装两次，由于不同商家的插装代码实现不一样，代码冲突可能造成严重的性能问题，因此强烈建议您不要同时安装多个 APM 探针。

挂载 Agent 后应用启动时报 OutOfMemoryError 错误

如出现此情况，请在 Java 启动命令后面加上堆内存大小配置项，以适量调大 JVM 参数。

以堆内存初始值（Xms）512 M、堆内存最大值（Xmx）2 G 为例，配置项如下所示。请根据实际情况适量调节。对于 Tomcat 等其他环境，请在配置文件的 JAVA_OPTS 中加入此参数。

   -Xms512M
   -Xmx2048M

如果出现OutOfMemoryError: PermGen space错误，加入参数：

   -XX:PermSize=256M 
   -XX:MaxPermSize=512M

如何检查网络连通性？

部署 ARMS-APM Agent 时，可使用 Telnet 命令测试目标主机与 ARMS 服务器网络是否连通。

表 1. 各地域 ARMS 应用监控服务器地址
地域	地址
杭州	arms-dc-hz.aliyuncs.com
北京	arms-dc-bj.aliyuncs.com
上海	arms-dc-sh.aliyuncs.com
青岛	arms-dc-qd.aliyuncs.com
深圳	arms-dc-sz.aliyuncs.com

假设用户在 ARMS 的深圳地域创建应用，则需测试深圳地域环境与 ARMS 服务器网络是否连通。以下结果表明网络已连通：

telnet arms-dc-sz.aliyuncs.com 8443Trying 119.23.169.12...Connected to arms-dc-sz.aliyuncs.com.Escape character is '^]'.

说明必须根据所在地域替换服务器地址，端口不变。

如何检查 ArmsAgent 是否加载成功？

使用 ps 命令查看命令行启动参数中是否成功加载 ArmsAgent。
```
ps -ef | grep 'arms-bootstrap'
```
成功加载时，如下图所示：
命令行中的 arms.licenseKey 属性必须与 ARMS 新接入应用页面中显示的 License Key 保持一致。

ArmsAgent 加载成功，为什么界面仍无监控数据？

如果 Agent 日志中出现“send agent metrics. no metrics.”，请确认您的应用是否有持续的外部请求访问，包括 HTTP 请求、HSF 请求和 Dubbo 请求，并确认开发框架是否在 ArmsAgent 的支持范围内。关于 ARMS 应用监控对第三方组件和框架的支持情况，请参考应用监控概述。
确认选择的查询时间范围是否正确。请您将查询时间条件设为最近 15 分钟，然后再次确认是否有监控数据。

如果是通过 -jar 命令行启动的，请检查命令行设置，确保 -javaagent 参数在 -jar 之前。

java -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey=xxx -Darms.appName=xxx -jar demoApp.jar

如果 ArmsAgent/log/ 下的日志中出现 LicenseKey is invalid. 异常，请您检查应用所属地域与 Agent 所属地域是否一致。
如果应用启动之后 ArmsAgent 目录下无 log 子目录，是由于 arms-bootstrap-1.7.0-SNAPSHOT.jar 未被成功加载导致的，请您检查 ArmsAgent 安装目录的权限是否正确。
若应用启动时出现以下报错，请您检查 arms-bootstrap-1.7.0-SNAPSHOT.jar 软件包及相应权限是否正确。
如果仍无监控数据，请打包 Java 探针日志（路径：ArmsAgent/log），并联系钉钉服务账号 @ARMS-服务解决问题。
检查 JDK 版本。如果 JDK 版本为 1.8.0_25 或者 1.8.0_31，可能会出现无法安装探针的情况，建议您升级对应的 JDK 版本，或咨询钉钉服务账号 @ARMS-服务。

ArmsAgent 加载成功，但 IP 显示不正确或无显示，怎么办？

首先通过 ifconfig -a 命令确认当前机器的网络配置情况，若为多网卡环境，则 Agent 采集到的 IP 地址可能会与预期不符合（与网络配置环境有关）。
任选以下方式之一来解决问题。
- 通过显式配置 JVM 的 -DEAGLEEYE.LOCAL.IP=10.XX.XX.XX 参数来解决。
  
  说明将 10.XX.XX.XX 替换为实际 IP 地址。
- 配置 Agent 获取 JVM 的 -DNETWORK.INTERFACE=eth0 参数，其中 eth0 为网卡名称。

ArmsAgent日志（路径：ArmsAgent/log）错误常用排查方法

LicenseKey is invalid 错误

首先确保该应用在 ARMS 中创建成功，并且确认安装 Agent 时填写的 LicenseKey 正确无误。
由于 ARMS 产品是多地域（Region）环境，所以还需要确认 Agent 的下载地址所属的地域与应用所属地域是否一致。

如何支持单机多实例？

同一台机器上面，部署同一应用的多个实例场景，可以通过 -Darms.agentId（逻辑编号：如 001，002）参数来区分接入的 JVM 进程，例如：

    java -javaagent:/{user.workspace}/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar -Darms.licenseKey=<LicenseKey> -Darms.appName=<AppName> 
    -Darms.agentId=001 -jar demoApp.jar