| title | metaDescription | redirects | freshnessValidatedDate | ||
|---|---|---|---|---|---|
Forward Micrometer data to New Relic with OpenTelemetry |
New Relic offers an integration that sends your Micrometer telemetry data to your New Relic account. |
|
never |
import opentelemetryMicrometerWithOtel from 'images/opentelemetry_screenshot-full_micrometer-with-otel.webp'
New Relic supports Micrometer data so you can view all of your observability metrics in one platform. You'll configure the OpenTelemetry Micrometer bridge with the OpenTelemetry SDK, then use OpenTelemetry Protocol (OTLP) to forward your Micrometer data to New Relic.
Before working through these procedures, you should:
- Configure the OpenTelemetry Metrics SDK to export data to New Relic via OTLP
- Install the OpenTelemetry Micrometer bridge
These are generalized steps to set up Micrometer metrics forwarding. You may want to update code snippets as needed to fit your specific environment.
Add OpenTelemetry Micrometer instrumentation to the alpha modules section of your build.gradle file:
```java
//Alpha modules
implementation 'io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5'
```
</Step>
<Step>
In the dependencies section, add the OpenTelemetry SDK and OTLP exporter:
```java
dependencies {
implementation 'io.opentelemetry:opentelemetry-sdk'
implementation 'io.opentelemetry:opentelemetry-exporters-otlp'
}
```
An example file with alpha modules and dependencies added might look something like this:
plugins {
id 'java-library'
id 'org.springframework.boot'
}
bootRun {
mainClass.set 'io.opentelemetry.example.micrometer.Application'
}
dependencies {
implementation platform("io.opentelemetry:opentelemetry-bom-alpha:<JAVA_OTEL_VERSION>")
implementation 'io.opentelemetry:opentelemetry-sdk'
implementation 'io.opentelemetry:opentelemetry-exporters-otlp'
implementation platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom-alpha:<OTEL_JAVA_)INSTRUMENTATION_VERSION>")
implementation 'io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5'
}Keep in mind you will need to update the snippet with correct versioning.
</Step>
<Step>
Below is an example code snippet that directs Micrometer to use the OpenTelemetry Micrometer bridge.
This snippet updates your code so OpenTelemetry can detect Micrometer data, then forward that data to New Relic:
public OpenTelemetry openTelemetry() {
return OpenTelemetrySdk.builder()
.setMeterProvider(
SdkMeterProvider.builder()
.setResource(
Resource.getDefault().toBuilder()
.put("service.name", "micrometer-shim")
// Include instrumentation.provider=micrometer to enable micrometer metrics
// experience in New Relic
.put("instrumentation.provider", "micrometer")
.build())
.registerMetricReader(
PeriodicMetricReader.builder(
OtlpHttpMetricExporter.builder()
.setEndpoint("https://otlp.nr-data.net")
.addHeader(
"api-key",
Optional.ofNullable(System.getenv("NEW_RELIC_LICENSE_KEY"))
.filter(str -> !str.isEmpty() && !str.isBlank())
.orElseThrow())
// IMPORTANT: New Relic exports data using delta temporality
// rather than cumulative temporality
.setAggregationTemporalitySelector(
AggregationTemporalitySelector.deltaPreferred())
// Use exponential histogram aggregation for histogram instruments
// to
// produce better data and compression
.setDefaultAggregationSelector(
DefaultAggregationSelector.getDefault()
.with(
InstrumentType.HISTOGRAM,
Aggregation.base2ExponentialBucketHistogram()))
.build())
// Match default micrometer collection interval of 60 seconds
.setInterval(Duration.ofSeconds(60))
.build())
.build())
.build();
}</Step>
<Step>
Wait a few minutes, trigger some test data, then go to one.newrelic.com > All Capabilities > APM & Services, then find Services - OpenTelemetry to choose the service instrumented with Micrometer.
</Step>
To learn more about using New Relic with Micrometer data, we recommend these docs:
- Learn to create custom visualizations with dashboards
- Set up some alerts to keep track of system performance
- Query your data with NRQL