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

# opentelemetry-instrumentation-marqo — OpenTelemetry Marqo instrumentation

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

## What it is and what it does

This package is an OpenTelemetry instrumentation plugin that automatically captures traces from the official Marqo vector database client library. When installed and initialized, it intercepts client-side calls to Marqo and emits structured trace data compatible with any OpenTelemetry-compliant backend (Jaeger, Datadog, etc.), enabling visibility into vector search latency, indexing operations, and error rates.

It's designed for developers already using OpenTelemetry for observability who want to extend tracing coverage to their Marqo vector database interactions. The instrumentation is passive—once initialized with a single method call, it requires no further code changes to the Marqo client usage itself.

Use it for:

- Monitor latency of vector search queries in production applications using OpenTelemetry backends.
- Correlate Marqo database calls with upstream application traces for end-to-end observability.
- Debug performance issues in vector indexing or search by inspecting detailed trace spans.
- Track error rates and failure modes in Marqo operations across distributed systems.
- Integrate Marqo observability into existing OpenTelemetry-based monitoring infrastructure.

## Worth the install?

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

Adds OpenTelemetry tracing to client-side calls to Marqo vector database, capturing traces of vector search and indexing operations.

Yes, if you are already using OpenTelemetry and Marqo together. The package is actively maintained, has no known vulnerabilities, and adds tracing with minimal install friction. If you are not yet using OpenTelemetry, this package alone does not justify adopting it—it is an instrumentation layer that requires an OpenTelemetry SDK and exporter already in place.

## Install

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

## Installing opentelemetry-instrumentation-marqo

Before you install: Low friction install with four lightweight OpenTelemetry dependencies. Package is actively maintained with a recent release (4 days old) and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows use in most projects, including commercial ones, with minimal restrictions.

Quickstart:

pip install opentelemetry-instrumentation-marqo

from opentelemetry.instrumentation.marqo import MarqoInstrumentor

MarqoInstrumentor().instrument()

Requires Python 3.10 or later and an active OpenTelemetry SDK setup to export traces.

Verify before relying:

- Whether instrumentation works with all Marqo client versions or specific versions only.
- What trace attributes and span types are captured for Marqo operations.
- Whether additional configuration is needed beyond calling instrument().

## Package facts

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

## Tags

opentelemetry marqo tracing, marqo instrumentation, vector database tracing, marqo observability, distributed tracing vector db, marqo client instrumentation, telemetry marqo calls, observability, vector-search, distributed-tracing

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