https://docs.newrelic.com/docs/agents/java-agent/getting-started/new-relic-java
New Relic for Java
For an overview of New Relic's Java agent (compatibility, requirements, installation, configuration), start here.
Contents
- Compatibility and requirements
- Installation
- Startup configuration
- Editing the configuration
- For more help
Compatibility and requirements
-
Show All
App/Web servers
Frameworks
JDBC drivers
JVM
Hosting services
Other instrumented features
Security requirements
Installation
allowtransparency="true" class="wistia_embed" frameborder="0" height="309" name="wistia_embed" scrolling="no" src="https://fast.wistia.net/embed/iframe/ld2xazuco9?endVideoBehavior=reset&playButton=false&playerColor=4cb0bd&version=v1&videoHeight=309&videoWidth=550&volumeControl=true" width="550" style="box-sizing: border-box; border: 1px solid rgb(204, 204, 204); border-radius: 4px; max-width: 700px; margin-bottom: 0px; padding: 5px;">
For Java agent installation tips, watch this New Relic video (approximately 1 minute).
To use the Java agent, sign up for a New Relic account, and then follow these installation instructions for your specific application server:
- The Java agent self-installer (Tomcat, Jetty, JBoss, and Glassfish)
- Manual installation (Tomcat, Jetty, JBoss, Apache Geronimo, Play, etc.)
- Java agent Frameworks (installing on AWS Elastic Beanstalk, ColdFusion, Glassfish, Tomcat on Windows, Websphere, etc.)
Notes:
- Even if you do not see your app server here, New Relic's Java agent should work on any application server by passing the
-javaagent:/full/path/to/newrelic.jar
switch to the JVM. - As part of the installation, change the default application name to a meaningful name.
- Recommendation: Change the default newrelic.yml file permissions to be read/write only for the owner of the app server process.
- To view your app's performance in the New Relic UI: From the New Relic menu bar, select APM > Applications > (selected app) > Monitoring > Overview.
Startup configuration
The agent reads the startup configuration from the newrelic.yml file, which must be in the same directory as newrelic.jar. You can also override settings using Java system properties.
The agent needs the license_key
and app_name
settings at startup (bootstrap). You cancustomize the location of the log file and other settings in your newrelic.yml file.
If your app server runs multiple applications in the same JVM, see Java agent configuration for multiple applications.
Editing the configuration
You can configure application reporting from the New Relic web interface using server-side configuration. Changes will be applied to all agents reporting for your application when the JVM restarts. However, if you use server-side config, you must still maintain required settings (license_key
and app_name
) in the local config file.
For more help
Additional documentation resources include:
- Java agent self-installer (how to install the New Relic Java agent)
- Upgrading the Java agent (how to upgrade New Relic for Java)
- Troubleshooting: No data appears (what to do if your Java application isn't reporting data)
- Web transaction naming (how transactions are named)
- Custom instrumentation for Java (implement custom instrumentation for unsupported frameworks)
Join the discussion about Java monitoring in the New Relic Community Forum ! The Community Forum is a public platform to discuss and troubleshoot your New Relic toolset.
If you need additional help, get support at support.newrelic.com .
How to create a new relic account:
https://newrelic.com/signup