README.md

Getting Started Guide - Java

This is a simple application instrumented with OpenTelemetry Java's automatic instrumentation javaagent. It demonstrates how to configure OpenTelemetry Java to send data to New Relic.

Requirements

• Java JDK 17+, due to the use of Spring Boot 3; Java 8+ otherwise
• A New Relic account
• A New Relic license key

Running the application

1. Set the following environment variables to configure OpenTelemetry to send data to New Relic:

   export OTEL_SERVICE_NAME=getting-started-java
   export OTEL_EXPERIMENTAL_EXPORTER_OTLP_RETRY_ENABLED=true
   export OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION=BASE2_EXPONENTIAL_BUCKET_HISTOGRAM
   export OTEL_EXPERIMENTAL_RESOURCE_DISABLED_KEYS=process.command_args
   export OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.nr-data.net
   export OTEL_EXPORTER_OTLP_HEADERS=api-key=<your_license_key>
   export OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT=4095
   export OTEL_EXPORTER_OTLP_COMPRESSION=gzip
   export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
   export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta

   • If your account is based in the EU, set the endpoint to: https://otlp.eu01.nr-data.net

2. Run the application with the following command and open http://localhost:8080/fibonacci?n=1 in your web browser to ensure it is working.

   ./gradlew bootRun

3. Experiment with providing different values for n in the query string. Valid values are between 1 and 90. Values outside this range cause an error which will show up in New Relic.