安装试例

发布时间：2025-08-01 14:18:00

1、注册一个New Relic账号（https://newrelic.com/signup）。

2、登录网站选择APM（Application Performance Management，应用性能管理），选择Get Started，假如已经有了applications，就选择[+Add more],如图：

选择java：

3、按照提示步骤进行处理，选择账号、输入应用名称、下载配置文件（里面包含license_key）、下载Java Agent：

第2步下载配置文件，如：newrelic.yml

第3步下载代理包，如：newrelic-java.zip

4、JAVA代理安装

解压下载的JAVA代理到指定目录，如：/home/mppay/下

unzip newrelic-java.zip -d /home/mppay/

5、替换配置文件

将 newrelic.yml（/home/mppay/newrelic/newrelic.yml）文件替换为您下载的自定义配置文件（newrelic）

也可以直接修改，主要修改以下2个属性：

license_key: cf1e0a1f56b12a40a6d2bcb6da4c6f1df509NRAL
app_name: appName

6、应用运行配置newrelic

在启动命令中，增加以下配置：

-javaagent:/home/mppay/newrelic/newrelic.jar

7、重启tomcate服务,并查看日志

tomcat日志：

2021-08-03T16:04:25,510+0800 [3914 1] com.newrelic INFO: New Relic Agent: Loading configuration file "/home/mppay/newrelic/./newrelic.yml"
2021-08-03T16:04:25,641+0800 [3914 1] com.newrelic INFO: Using default collector host: collector.newrelic.com
2021-08-03T16:04:25,642+0800 [3914 1] com.newrelic INFO: Using default metric ingest URI: https://metric-api.newrelic.com/metric/v1
2021-08-03T16:04:25,642+0800 [3914 1] com.newrelic INFO: Using default event ingest URI: https://insights-collector.newrelic.com/v1/accounts/events
2021-08-03T16:04:25,771+0800 [3914 1] com.newrelic INFO: New Relic Agent: Writing to log file: /home/mppay/newrelic/logs/newrelic_agent.log

agent日志：

2021-08-03T16:41:42,354+0800 [9179 1] com.newrelic INFO: Writing to New Relic log file: /home/mppay/newrelic_mmc/logs/newrelic_agent.log2021-08-03T16:41:42,355+0800 [9179 1] com.newrelic INFO: JRE vendor Oracle Corporation version 1.8.0_1912021-08-03T16:41:42,355+0800 [9179 1] com.newrelic INFO: JVM vendor Oracle Corporation Java HotSpot(TM) 64-Bit Server VM version 25.191-b122021-08-03T16:41:42,355+0800 [9179 1] com.newrelic INFO: OS Linux version 2.6.32-431.el6.x86_64 arch amd642021-08-03T16:41:42,355+0800 [9179 1] com.newrelic INFO: Agent Host: localhost.localdomain IP: 127.0.0.12021-08-03T16:41:42,355+0800 [9179 1] com.newrelic INFO: New Relic Agent v7.1.1 is initializing...2021-08-03T16:41:43,357+0800 [9179 8] com.newrelic INFO: Instrumentation com.newrelic.instrumentation.jdbc-resultset is disabled. Skipping.2021-08-03T16:41:46,552+0800 [9179 1] com.newrelic.agent.RPMServiceManagerImpl INFO: Configured to connect to New Relic at collector.newrelic.com:4432021-08-03T16:41:47,587+0800 [9179 1] com.newrelic INFO: Setting audit_mode to false2021-08-03T16:41:48,044+0800 [9179 1] com.newrelic.agent.config.ConfigServiceImpl INFO: Configuration file is /home/mppay/newrelic_mmc/./newrelic.yml2021-08-03T16:41:48,062+0800 [9179 1] com.newrelic INFO: New Relic Agent v7.1.1 has started2021-08-03T16:41:48,063+0800 [9179 1] com.newrelic INFO: Agent class loader: com.newrelic.bootstrap.BootstrapAgent$JVMAgentClassLoader@3b95a09c2021-08-03T16:41:48,063+0800 [9179 1] com.newrelic INFO: Premain startup complete in 6,707ms2021-08-03T16:42:05,329+0800 [9179 1] com.newrelic INFO: Server Info: Apache Tomcat/9.0.412021-08-03T16:42:23,060+0800 [9179 30] com.newrelic INFO: Host name is localhost.localdomain, display host localhost.localdomain for application SIT_NEW_MMC12021-08-03T16:42:23,060+0800 [9179 30] com.newrelic INFO: New Relic JFR Monitor is disabled: JFR config has not been enabled in the Java agent.2021-08-03T16:42:23,665+0800 [9179 30] com.newrelic INFO: Collector redirection to collector-004.newrelic.com:4432021-08-03T16:42:24,628+0800 [9179 30] com.newrelic INFO: Max payload size is 1,000,000 bytes2021-08-03T16:42:24,634+0800 [9179 30] com.newrelic INFO: Agent run id: BeMBvI7bvdxwAC9Ppjzb-xFhCQHQAAIBAAAnIQEAACPbAgQ82_sQAwAFNy4xLjEAFWxvY2FsaG9zdC5sb2NhbGRvbWFpbgAMU0lUX05FV19NTUMx2021-08-03T16:42:24,634+0800 [9179 30] com.newrelic INFO: Agent 9179@localhost.localdomain/SIT_NEW_MMC1 connected to collector.newrelic.com:4432021-08-03T16:42:24,634+0800 [9179 30] com.newrelic INFO: Reporting to: https://rpm.newrelic.com/accounts/3100582/applications/10210496162021-08-03T16:42:24,636+0800 [9179 30] com.newrelic INFO: Using default collector host: collector.newrelic.com2021-08-03T16:42:24,636+0800 [9179 30] com.newrelic INFO: Using default metric ingest URI: https://metric-api.newrelic.com/metric/v12021-08-03T16:42:24,636+0800 [9179 30] com.newrelic INFO: Using default event ingest URI: https://insights-collector.newrelic.com/v1/accounts/events2021-08-03T16:42:24,644+0800 [9179 30] com.newrelic INFO: Using default collector host: collector.newrelic.com2021-08-03T16:42:24,644+0800 [9179 30] com.newrelic INFO: Using default metric ingest URI: https://metric-api.newrelic.com/metric/v12021-08-03T16:42:24,644+0800 [9179 30] com.newrelic INFO: Using default event ingest URI: https://insights-collector.newrelic.com/v1/accounts/events2021-08-03T16:42:25,240+0800 [9179 30] com.newrelic INFO: Real user monitoring is enabled for application SIT_NEW_MMC1. Auto instrumentation is enabled.2021-08-03T16:42:25,240+0800 [9179 30] com.newrelic WARN: Not starting JFR Service. Core JFR APIs do not exist in this JVM.

从日志中可以看到，Agent已经成功装数据发往newrelic.com的个人账号。

8、打开NewRelic，检查是否有该应用的监控数据

使用Maven集成Newrelic

使用newrelic监控应用，需要在应用服务器上部署newrelic客户端（如：newrelic.jar），并对newrelic.yml进行配置（license_key、app_name），然后在启动命令中加入-javaagent:newrelic.jar。

除上述方法外，还可以在应用中使用maven集成newrelic，这样就不需要在部署newrelic客户端了，具体有以下两种实现：

方案一：应用中将newrelic客户端依赖进来，同时通过maven将newrelic客户端的源码加入应用的jar包中；　　
方案二：应用中将newrelic客户端依赖进来，同时通过maven将newrelic客户端的jar包复制到target/目录下；

以上两种的最大区别是：

方案一：优点：部署简单；缺点：对应用的侵入性大（newrelic客户端的源码全部放入应用的jar包中），风险较大；
方案二：优点：应用与newrelic相互独立隔离；缺点：部署时要额外处理newrelic客户端的jar包，需要将它上传至应用服务器（使用jenkins）；
上面的两种实现方案，都要额外处理newrelic.yml配置文件。我这里的处理方式是，在应用中按环境内置一个newrelic.yml，在maven打包时把它复制到newrelic客户端.jar包同一目录下；

方案一实现步骤：

1、添加了 NewRelic 依赖项：

    com.newrelic.agent.java    newrelic-agent    6.4.2    provided

2、配置maven-dependency-plugin插件

作用：复制newrelic-agent.jar包到指定目录（target/）下。

                            org.apache.maven.plugins                maven-dependency-plugin                                                            prepare-package                                                    copy-dependencies                                                                            newrelic-agent                            ${project.build.directory}                            true

3、配置maven-antrun-plugin插件

作用：将应用中默认的newrelic.yml配置文件，复制到指定目录（target/）下（跟newrelic-agetn.jar同目录）。

                            org.apache.maven.plugins                maven-antrun-plugin                                                            id.newrelic                        package                                                                                                                                                                                                                                                                                                                                            run

4、应用中按环境添加默认的newrelic.yml配置文件

5、使用mavent打包

打包结果如下，除了应用的jar包外，还有newrelic-agent.jar、newrelic.yml。

6、发布运行

将上述3个包一起上传（一般使用jenkins）到应用服务器，放置在同一个目录，然后使用以下命令运行：

java -javaagent:newrelic-agent.jar -jar umpg.jar

方案二实现步骤：

1、添加了 NewRelic 依赖项：

    com.newrelic.agent.java    newrelic-agent    6.4.2    provided

2、配置maven-antrun-plugin插件

作用：解压newrelic-agent.ar中包含的所有文件到应用的jar包中，复制依赖jar包到指定目录（target/）下

                            org.apache.maven.plugins                maven-antrun-plugin                                                            addExtractedJarOnRootLevel                        package                                                                                                                                                                                                                                                        run                                                                                        id.newrelic                        package                                                                                                                                                                                                                                                                                                                                            run

3、应用中按环境添加默认的newrelic.yml配置文件

4、使用mavent打包

打包结果如下，除了应用的jar包外，还有newrelic.yml。

注意：这里并没有newrelic-agent.jar包，而是将它里面的内容，复制到umpg.jar包中了：

上图右边框中的部分，都是newrelic-agent.jar包中的内容。

5、发布运行

将上述2个包一起上传（一般使用jenkins）到应用服务器，放置在同一个目录，然后使用以下命令运行：

java -javaagent:umpg.jar -jar umpg.jar

注：这里-javaagent指定的jar包就是应用jar包。

其它说明

以上两种实现方案，最大好处就是，newrelic代理依赖是你构建过程的一部分，不用在每台应用服务器部署newrelic.jar包（除了 newrelic.yml）。推荐使用第一种方案，第二种方案对应用的侵入性太大；
以上两种实现方案，都要额外处理newrelic.yml配置文件。如不想在打包的时候处理newrelic.yml文件（运维不肯给license_key），则需要运维在部署时自己提供newrelic.yml（放到跟jar包同一目录下，或由-Dnewrelic.config.file指定路径）；
还可以使用-Dnewrelic.config.app_name指定应用名称；
上面提到了，使用jenkins将newrelic-agent.jar、newrelic.yml上传至服务器，下面给出参考配置：
下面是一些参考网站：

Newrelic自定义检测

某些场景下NewRelic无法自动识别Transactions，则要进行自定义检测处理，需要在应用中植入代码，具体方法如下。

添加依赖

添加newrelic-api 的依赖，version要跟应用服务器上newrelic客户端的保持一致。

    com.newrelic.agent.java    newrelic-api    6.4.2    compile

添加注解

在需要监控的方法头上，增加 @Trace(dispatcher=true) 注解。

注意：在增加了@Trace注解方法的调用链路中，如果有异步场景，则异步中处理的逻辑监控不到。

图表的简单说明

Summary介绍：

Web transactions time：JVM、Mysql、Web external、Response time 整体耗时报表
Apdex score：apm 综合打分，满分1.0
Throughtput：整体吞吐量，单位分钟
Transactions：请求调用等，Top5
Error rate：错误率，如果检测到系统错误，这里会提现处理，如果达到一定错误率，会有系统报警（邮件），报表背景将会是：淡红色
Host：JVM 报表，每个 jvm 具体情况，比如：
Recent events：近期历史事件，常见的就是报警了

Transactions介绍

Type：Web、Non-Web（Java/Job/SpringController等，定时任务之类的）
排序：

Most Time consuming：耗时最多的
Slowest average response time：响应最慢的
Adpex most dissatisfying：Adpex打分最不满意的
Highest throughput：吞吐量最高的

Top 5 web Transactions：耗时最多的5个web请求百分比，可以选择不同的报表展示方式
Transaction traces：一般是有问题的请求事件会出现在这里，点进去可以看到堆栈的东西，查询sql之类的等

Summary：汇总
Trace details：跟踪详情
Database queries：数据库查询

附上 Transaction traces 3张截图：

DataBases介绍

SORT BY：排序

Most time consuming：秏时最多的
Slowest query time：查询最慢的
Throughtput：吞吐量最大的（频率最高的）

MySQL overview：根据排序来展现的详细报表，仅第一个根据排序变化

Top database operations by time consumed：耗时最多的5个查询
Top database operations by query time：整体增删改查耗时
Top database operations by throughput：整体增删改查吞吐量

External services介绍

比如嵌入了第三方的API，调用时也会被记录下来，比如：吞吐量、平均响应时长等信息。

JVMs介绍

Service map介绍

显示服务之间的拓扑图。

Dependencies介绍

显示服务之间的依赖关系，包括数据库和中间件。

Distributed tracing介绍

分布式调用链路。

注：目前发现只支持http请求的调用。

展开阅读全文

︾

new relic

中国服务商

安装试例

使用Maven集成Newrelic

方案一实现步骤：

方案二实现步骤：

其它说明

Newrelic自定义检测

添加依赖

添加注解

图表的简单说明

Summary介绍：

Transactions介绍

DataBases介绍

External services介绍

JVMs介绍

Service map介绍

Dependencies介绍

Distributed tracing介绍

标签：

安装试例

使用Maven集成Newrelic

方案一 实现步骤：

方案二 实现步骤：

其它说明

Newrelic自定义检测

添加依赖

添加注解

图表的简单说明

Summary介绍：

Transactions介绍

DataBases介绍

External services介绍

JVMs介绍

Service map介绍

Dependencies介绍

Distributed tracing介绍

标签：

方案一实现步骤：

方案二实现步骤：