New Relic Java Agent
--------------------
New Relic is an application performance monitoring (APM) service that lets
you see and understand application performance metrics in real time so you
can fix problems fast.  The Java agent collects system and application
metrics by injecting bytecode into a select set of methods. The metrics are
reported to the New Relic service once a minute. The agent also reports
uncaught exceptions and slow transactions.

The Java Agent installs into your app server and monitors the performance
of your apps.  The agent monitors applications written in Java, Scala, and
other languages that run on the JVM.  New Relic provides additional detail
for many common frameworks and libraries. See this page for details:

  http://newrelic.com/java


Getting Started
---------------
If you don't already have a New Relic account, sign up for a free account:

  https://newrelic.com/signup

When you sign up, you will be provided with a customized zip file that is
configured with your license key.

Using Java SE 5? You will need a different version of the agent. See below.


Installation
------------
Complete installation instructions and troubleshooting tips are available 
at:

  https://newrelic.com/docs/java/new-relic-for-java

For most users, the following self-installer instructions apply:

  https://newrelic.com/docs/java/java-agent-self-installer

Configuration options are available at:

  https://newrelic.com/docs/java/java-agent-configuration


Using New Relic
---------------
Once you have installed the agent and restarted your app server, you can
login to New Relic at

  https://rpm.newrelic.com

and see your application's performance information. It takes about two
minutes for the application data to show up. By default, your data will
appear under an application named "My Application". You can change this by
updating the app_name setting in newrelic.yml (see below).


Agent Files
-----------
Typically, you will unzip the newrelic files in your app server root. The
layout is:

  newrelic/
    newrelic.jar
    newrelic-api.jar
    newrelic.yml
    logs/
      ...

The installation process adds a JVM argument
  -javaagent:newrelic/newrelic.jar
to your app server startup script.

The newrelic.yml file provides configuration options. Most of the options
take effect on restart of the app server. NOTE: yml requires exact
whitespace indentation! If the indentation is incorrect, the option may be
ignored.

The logs directory contains important diagnostic information about the
agent. In particular, view newrelic/logs/newrelic_agent.log if you are
troubleshooting.

If you use the New Relic API in your code, you will need to include the
newrelic-api.jar file at compile time and add it as a dependency to your
app. Make sure that you use the same version for your API and newrelic.jar.
New Relic publishes to the Maven Central Repository, so you can add a
dependency to newrelic-api in your favorite build tool.


Note to Java SE 5 Users
-----------------------
This version of the agent works with Java SE 6 and 7. At signup or in your
Account Settings page, you have the option to download a version of the
agent that works with Java SE 5.


Support
-------
Email <support@newrelic.com>, or visit our support site at

  https://support.newrelic.com


Licenses
--------
See the LICENSE file for New Relic's license terms and the list of
third-party components that are included in the agent.
