Java Integration

Quick Start with Java Agent

Download the OpenTelemetry Java Agent:

# Download the latest agent
curl -L -o opentelemetry-javaagent.jar \
  https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar

Run Your Application

java -javaagent:opentelemetry-javaagent.jar \
  -Dotel.service.name=my-java-service \
  -Dotel.exporter.otlp.endpoint=https://api.qorrelate.io/v1/otlp \
  -Dotel.exporter.otlp.headers="X-API-Key=YOUR_API_KEY" \
  -jar your-application.jar

Environment Variables

export OTEL_SERVICE_NAME=my-java-service
export OTEL_EXPORTER_OTLP_ENDPOINT=https://api.qorrelate.io/v1/otlp
export OTEL_EXPORTER_OTLP_HEADERS="X-API-Key=YOUR_API_KEY"
export OTEL_RESOURCE_ATTRIBUTES="environment=production,version=1.0.0"

java -javaagent:opentelemetry-javaagent.jar -jar your-application.jar

Supported Frameworks

Docker Example

FROM eclipse-temurin:17-jre

# Download OpenTelemetry Java Agent
ADD https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar /opt/opentelemetry-javaagent.jar

ENV JAVA_TOOL_OPTIONS="-javaagent:/opt/opentelemetry-javaagent.jar"
ENV OTEL_SERVICE_NAME=my-java-service
ENV OTEL_EXPORTER_OTLP_ENDPOINT=https://api.qorrelate.io/v1/otlp

COPY target/app.jar /app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]

Spring Boot Configuration

# application.properties
otel.service.name=my-spring-boot-app
otel.exporter.otlp.endpoint=https://api.qorrelate.io/v1/otlp
otel.exporter.otlp.headers.X-API-Key=${QORRELATE_API_KEY}