Java agent incubator

New Relic's Java agent Incubator is a program for experimental new instrumentation. It allows you to get visibility into frameworks that are not instrumented automatically by the New Relic agent.

If you have feedback, questions, or problems with this instrumentation, create a post in New Relic's Explorers Hub, and tag your post with java_incubator.

Installation

Specific instrumentation modules work with the latest Java agent version. To install the instrumentation:

  1. In the directory where the newrelic.jar and newrelic.yml are located, create a directory named extensions if there is not already one there.
  2. Copy the downloaded incubator module jar file into the extensions directory.
  3. Restart your server.
  4. Send some traffic to the server or host that will exercise the instrumentation.

Incubator instrumentation modules

Instrumentation modules from New Relic are subject to the New Relic Java agent licenses, which are included in each module jar's LICENSE file.

Download the module

This instrumentation package intercepts the following:

org.apache.camel.component.http.CamelServlet.resolve

To name the transaction so that web transactions have a finer grained name than the Camel servlet name, it uses this:

org.apache.camel.component.http.HttpConsumer.getPath()

To view the bytecode, use this terminal command:

javap -verbose -cp camel-2.12-<FILENAME>.jar org.apache.camel.component.http.CamelServlet

Download the module

This instrumentation package requires the New Relic Java agent version 3.12.0 or higher. It samples C3P0 connection pools and reports busy and idle counts in metrics that start with this:

Custom/Database Connection/C3P0

Download the module

This instrumentation package integrates with the MetricRegistry and begins sampling the registered metrics every minute. Reported metrics are prefixed with this:

Custom/CodaHale/Metrics2/

You can view the metrics with custom dashboards.

Download the module

This instrumentation package integrates with the MetricRegistry and begins sampling the registered metrics every minute. Reported metrics are prefixed with this:

Custom/CodaHale/Metrics3/

You can view the metrics with custom dashboards.

Download the module

This instrumentation package requires the New Relic Java agent version 3.12.0 or higher. It samples HikariCP database connection pools and reports busy and idle counts in metrics that start with this:

Custom/Database Connection/HikariCP

Download the module

This instrumentation package requires the New Relic Java agent version 3.12.0 or higher. It samples HikariCP database connection pools and reports busy and idle counts in metrics that start with this:

Custom/Database Connection/HikariCP

Download the module

This instrumentation package requires the New Relic Java agent version 3.29 or higher. This instrumentation package adds support for async linking of Ratpack's execution primitives. It also monitors handler execution. You must name the transactions manually by using the Java agent API.

Download the module

This instrumentation captures Ratpack's HTTP client requests and responses.

For more help