llama-index-instrumentation

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 on this page — 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

llama-index-instrumentation on PyPI

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

Evidence: llama_index_instrumentation-0.5.0-py3-none-any.whl

Tags

More Monitoring packages