How to Install the Extension

Install the DuckDB OpenTelemetry Extension to start querying OpenTelemetry data with SQL.

Install from Community

Install from DuckDB’s community extension repository:

-- Install from DuckDB community extensions
INSTALL otlp FROM community;
LOAD otlp;

DuckDB downloads the pre-built extension for your platform.

Requirements

DuckDB 0.10.0 or later
Supported platforms:
- Linux (x86_64, arm64)
- macOS (Intel, Apple Silicon)
- Windows (x86_64)

Use in Browser (DuckDB-WASM)

Try the extension in your browser without installation:

→ Interactive Demo

The WASM demo supports:

JSON, JSONL, and protobuf file reads
Loading sample OTLP data
Running SQL queries in-browser
Uploading your own files

Native builds include the live ingest server.

Build from Source

For development or custom builds, see CONTRIBUTING.md.

Quick Build

# Clone repository
git clone https://github.com/smithclay/duckdb-otlp.git
cd duckdb-otlp

# Install vcpkg dependencies
export VCPKG_TOOLCHAIN_PATH=`pwd`/vcpkg/scripts/buildsystems/vcpkg.cmake

# Build with ninja
GEN=ninja make

# DuckDB shell with extension loaded
./build/release/duckdb

WASM Build

# Build for browser
make wasm_eh

Note: The live ingest server is not available in WASM builds.

Verify Installation

Check that DuckDB loaded the extension:

-- List installed extensions
SELECT * FROM duckdb_extensions() WHERE extension_name = 'otlp';

-- Test with sample data
SELECT count(*) FROM read_otlp_logs('test/data/logs_simple.jsonl');

Next Steps

Get Started - install, load, and run first queries.
OpenTelemetry Collector - export OTLP files from the collector.
OpenTelemetry Demo - stream demo traces, logs, and metrics into local DuckLake.
How-to Guides - query and export telemetry.

Troubleshooting

Extension Not Found

Error: Extension "otlp" not found

Ensure you’re using DuckDB 0.10+ and run:

INSTALL otlp FROM community;
LOAD otlp;

Platform Not Supported

If pre-built binaries aren’t available for your platform, build from source.

Live Ingest in WASM

Error: otlp_serve is not implemented for the wasm platform

Use a native DuckDB build for the HTTP ingest functions: otlp_serve, otlp_flush, otlp_stop, and otlp_server_list.