---
id: llama-index-instrumentation
version: "0.5.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# llama-index-instrumentation — Instrumentation and Observability for LlamaIndex

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

## What it is and what it does

llama-index-instrumentation provides instrumentation hooks for observability, using spans, events, and dispatchers to capture and manage application behavior. The package is lightweight, depending only on deprecated and pydantic, and is designed to integrate with the LlamaIndex ecosystem.

The library is actively maintained with recent releases and a large backing repository. It targets Python 3.10 or later and is licensed under MIT, making it freely usable in most contexts. The instrumentation model centers on dispatchers that manage span and event handlers, enabling flexible observation of application execution.

Use it for:

- Track execution flow and performance by instrumenting spans and events.
- Debug workflows by monitoring event dispatchers and their handlers.
- Collect observability data for integration with external monitoring systems.
- Observe application behavior in production deployments for performance analysis.

## Worth the install?

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

Provides instrumentation hooks for observability in LlamaIndex applications, enabling collection and management of spans, events, and dispatchers to track application behavior.

Yes, if you need observability for LlamaIndex applications. Low install friction, permissive MIT license, active maintenance, and zero known vulnerabilities make it a straightforward addition. Not applicable outside the LlamaIndex ecosystem.

## Install

pip install llama-index-instrumentation
uv add llama-index-instrumentation
poetry add llama-index-instrumentation

## Installing llama-index-instrumentation

Before you install: Low install friction with only 2 runtime dependencies (deprecated and pydantic). Active maintenance with recent commits as of 2026-08-14.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for most commercial and open-source projects.

Quickstart:

pip install llama-index-instrumentation

from llama_index_instrumentation import Instrumentation

instrumentation = Instrumentation()

Requires Python 3.10 or later (requires_python: >=3.10,<4.0).

Verify before relying:

- What observability backends or exporters are supported by the span and event system.
- Whether the dispatcher API is stable or still evolving given the recent first release.
- How this package integrates with external monitoring and tracing systems.

## Package facts

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

## Tags

llama index observability, instrumentation hooks, span and event tracking, application monitoring, observability framework, distributed tracing, event dispatchers, observability, instrumentation

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