Java — Containers & VMs

This guide covers Java applications running on ECS, EC2, Kubernetes, or any container/VM environment. For Java on AWS Lambda, see the Java Lambda guide.

1. Install the OpenTelemetry Java Agent

Download the latest opentelemetry-javaagent.jar from the OpenTelemetry Java instrumentation releases and attach it to your JVM startup:

java -javaagent:path/to/opentelemetry-javaagent.jar -jar myapp.jar

Alternatively, if you are using Gradle, you can use the Gradle Javaagent Plugin to attach the agent to your application. For full configuration options, see the official OpenTelemetry Java Agent docs.

2. Set Environment Variables

Add the following environment variables to your application. Replace YOUR_TRACE0_ENV_API_KEY with the API key from your Trace0 environment.

Variable	Value
`OTEL_EXPORTER_OTLP_ENDPOINT`	`https://app.trace0hq.com/api`
`OTEL_EXPORTER_OTLP_HEADERS`	`X-API-KEY=YOUR_TRACE0_ENV_API_KEY`

Also set the following additional environment variable for your cloud provider.

AWS
GCP
Azure

Variable	Value
`OTEL_RESOURCE_PROVIDERS_AWS_ENABLED`	`true`

Variable	Value
`OTEL_RESOURCE_PROVIDERS_GCP_ENABLED`	`true`

Variable	Value
`OTEL_RESOURCE_PROVIDERS_AZURE_ENABLED`	`true`

Alternatively, you can set all these environment variables in a YAML file using declarative configuration.

3. Kubernetes Setup

If your application runs on Kubernetes, including Amazon EKS, Google Kubernetes Engine or Azure Kubernetes Service, add the following environment variables to your container specification.

env:
  - name: K8S_POD_UID
    valueFrom:
      fieldRef:
        fieldPath: metadata.uid

  - name: K8S_POD_NAME
    valueFrom:
      fieldRef:
        fieldPath: metadata.name

  - name: K8S_NAMESPACE_NAME
    valueFrom:
      fieldRef:
        fieldPath: metadata.namespace

  - name: K8S_CONTAINER_NAME
    value: my-container-name

  - name: OTEL_RESOURCE_ATTRIBUTES
    value: k8s.pod.uid=$(K8S_POD_UID),k8s.pod.name=$(K8S_POD_NAME),k8s.namespace.name=$(K8S_NAMESPACE_NAME),k8s.container.name=$(K8S_CONTAINER_NAME)

4. Deploy Service

Deploy your service and watch traces, metrics, and logs appear in the Trace0 dashboard within seconds.

Example Service

See our Java ECS example app and Java EC2 example app for working services you can deploy to your AWS account.

Introduction

Getting Started

Platform

Agents

Setup Guides

Pricing

Security

FAQ

Java — Containers & VMs

1. Install the OpenTelemetry Java Agent

2. Set Environment Variables

3. Kubernetes Setup

4. Deploy Service

Example Service

​1. Install the OpenTelemetry Java Agent

​2. Set Environment Variables

​3. Kubernetes Setup

​4. Deploy Service

​Example Service

1. Install the OpenTelemetry Java Agent

2. Set Environment Variables

3. Kubernetes Setup

4. Deploy Service

Example Service