---
id: opentelemetry-instrumentation-lancedb
version: "0.62.3"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# opentelemetry-instrumentation-lancedb — OpenTelemetry Lancedb instrumentation

License: permissive · Maintenance: active · Downloads: 8.2M/mo

## What it is and what it does

This package wraps the official LanceDB library to automatically emit OpenTelemetry traces for every client-side call. It integrates with the OpenTelemetry ecosystem, meaning traces are formatted according to semantic conventions and can be exported to any backend that accepts OpenTelemetry signals—Jaeger, Datadog, New Relic, or any other collector.

You install it, call `LanceInstrumentor().instrument()` once at startup, and then all subsequent LanceDB operations are traced without further code changes. It depends on opentelemetry-api, opentelemetry-instrumentation, and two semantic-conventions packages to define how database operations are represented in traces.

Use it for:

- Debug slow LanceDB queries by viewing end-to-end traces in your observability backend.
- Monitor production vector database operations and correlate them with application traces.
- Troubleshoot connection issues or failures by inspecting trace spans and error attributes.
- Measure LanceDB latency distribution across your application's request lifecycle.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds distributed tracing instrumentation for LanceDB client calls, automatically capturing traces compatible with OpenTelemetry collectors and backends.

Yes, if you are already using OpenTelemetry and LanceDB in production. The package is actively maintained, has no known vulnerabilities, and low install friction. Install only if you have an OpenTelemetry exporter already configured; the instrumentation alone produces no output without a collector backend.

## Install

pip install opentelemetry-instrumentation-lancedb
uv add opentelemetry-instrumentation-lancedb
poetry add opentelemetry-instrumentation-lancedb

## Installing opentelemetry-instrumentation-lancedb

Before you install: Low friction install with four lightweight OpenTelemetry dependencies. Actively maintained as of 4 days ago with recent commits and a substantial upstream repository.

License in practice: Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart:

pip install opentelemetry-instrumentation-lancedb

from opentelemetry.instrumentation.lancedb import LanceInstrumentor

LanceInstrumentor().instrument()

Requires Python 3.10 or later; requires an OpenTelemetry collector or exporter to be configured separately to actually export traces.

Verify before relying:

- Whether instrumentation works with all LanceDB versions or only specific releases.
- What trace data is captured (query parameters, latency, errors) and how detailed the semantic conventions are.
- Whether the package supports async LanceDB operations or only synchronous calls.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 8.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

opentelemetry lancedb tracing, lancedb instrumentation, distributed tracing vector database, lancedb observability, opentelemetry database instrumentation, trace lancedb calls, lancedb monitoring, observability, vector-database, tracing

[View on SkillFed](https://skillfed.io/packages/opentelemetry-instrumentation-lancedb) · [View on PyPI](https://pypi.org/project/opentelemetry-instrumentation-lancedb/)