Java

Use the OpenTelemetry Java agent or SDK to send logs, metrics, and traces to ClickHouse Observability.

Set up OpenTelemetry

Follow the official OpenTelemetry Java agent setup instructions to install instrumentation and configure your application. For manual instrumentation, use the Java SDK documentation. Configure OTLP export for the signals you want to send, using the connection settings below. Replace any example destinations from the upstream instructions, including signal-specific endpoint overrides.

Configure your destination

Fully managed
Self-managed

Open Team Settings → Data → Managed Telemetry in your service and copy the OTLP HTTP endpoint and API key. Use the complete HTTPS endpoint, including its port:

export OTEL_EXPORTER_OTLP_ENDPOINT='https://YOUR_OTEL_ENDPOINT:4318'
export OTEL_EXPORTER_OTLP_HEADERS='authorization=Bearer%20YOUR_INGESTION_API_KEY'
export OTEL_EXPORTER_OTLP_PROTOCOL='http/protobuf'

Use your collector’s OTLP HTTP endpoint and ingestion key. Use http:// instead of https:// if your collector does not have TLS configured. For collector setup, see Ingesting with OpenTelemetry.

export OTEL_EXPORTER_OTLP_ENDPOINT='https://YOUR_COLLECTOR_HOST:4318'
export OTEL_EXPORTER_OTLP_HEADERS='authorization=YOUR_INGESTION_API_KEY'
export OTEL_EXPORTER_OTLP_PROTOCOL='http/protobuf'

Verify ingestion

Start your instrumented application and generate activity. In ClickHouse Observability, select a recent time range and find your application’s service name in Logs or Traces. If your application emits metrics, check Metrics after allowing time for export. For instrumentation and exporter troubleshooting, see the OpenTelemetry Java agent troubleshooting guidance.

Introduction

Features

Administration

Guides

Integration partners

Self-managed

Set up OpenTelemetry

Configure your destination

Verify ingestion

​Set up OpenTelemetry

​Configure your destination

​Verify ingestion

Set up OpenTelemetry

Configure your destination

Verify ingestion