openinference-instrumentation

OpenInference is a set of conventions and plugins that is complimentary to OpenTelemetry to enable tracing of AI applications. OpenInference is natively supported by arize-phoenix, but can be used with any OpenTelemetry-compatible backend as well.

Specification

The OpenInference specification is edited in markdown files found in the spec directory. It's designed to provide insight into the invocation of LLMs and the surrounding application context such as retrieval from vector stores and the usage of external tools such as search engines or APIs. The specification is transport and file-format agnostic, and is intended to be used in conjunction with other specifications such as JSON, ProtoBuf, and DataFrames.

Instrumentation

OpenInference provides a set of instrumentations for popular machine learning SDKs and frameworks in a variety of languages.

Python

Libraries

Package	Description	Version
openinference-semantic-conventions	Semantic conventions for tracing of LLM Apps.
openinference-instrumentation	Reusable utilities, decorators, configurations, and helpers for instrumentation.
openinference-instrumentation-agno	OpenInference Instrumentation for Agno Agents.
openinference-instrumentation-openai	OpenInference Instrumentation for OpenAI SDK.
openinference-instrumentation-openai-agents	OpenInference Instrumentation for OpenAI Agents SDK.
openinference-instrumentation-claude-agent-sdk	OpenInference Instrumentation for Claude Agent SDK.
openinference-instrumentation-llama-index	OpenInference Instrumentation for LlamaIndex.
openinference-instrumentation-dspy	OpenInference Instrumentation for DSPy.
openinference-instrumentation-bedrock	OpenInference Instrumentation for AWS Bedrock.
openinference-instrumentation-langchain	OpenInference Instrumentation for LangChain.
openinference-instrumentation-mcp	OpenInference Instrumentation for MCP.
openinference-instrumentation-mistralai	OpenInference Instrumentation for MistralAI.
openinference-instrumentation-portkey	OpenInference Instrumentation for Portkey.
openinference-instrumentation-guardrails	OpenInference Instrumentation for Guardrails.
openinference-instrumentation-vertexai	OpenInference Instrumentation for VertexAI.
openinference-instrumentation-crewai	OpenInference Instrumentation for CrewAI.
openinference-instrumentation-haystack	OpenInference Instrumentation for Haystack.
openinference-instrumentation-litellm	OpenInference Instrumentation for liteLLM.
openinference-instrumentation-groq	OpenInference Instrumentation for Groq.
openinference-instrumentation-instructor	OpenInference Instrumentation for Instructor.
openinference-instrumentation-anthropic	OpenInference Instrumentation for Anthropic.
openinference-instrumentation-beeai	OpenInference Instrumentation for BeeAI.
openinference-instrumentation-google-genai	OpenInference Instrumentation for Google GenAI.
openinference-instrumentation-google-adk	OpenInference Instrumentation for Google ADK.
openinference-instrumentation-autogen-agentchat	OpenInference Instrumentation for Microsoft Autogen AgentChat.
openinference-instrumentation-pydantic-ai	OpenInference Instrumentation for PydanticAI.
openinference-instrumentation-smolagents	OpenInference Instrumentation for smolagents.
openinference-instrumentation-pipecat	OpenInference Instrumentation for Pipecat.
openinference-instrumentation-agentspec	OpenInference Instrumentation for Open Agent Specification.
openinference-instrumentation-strands-agents	OpenInference Instrumentation for Strands Agents.

Span Processors

Normalize and convert data across other instrumentation libraries by adding span processors that unify data.

Package	Description	Version
openinference-instrumentation-openlit	OpenInference Span Processor for OpenLIT traces.
openinference-instrumentation-openllmetry	OpenInference Span Processor for OpenLLMetry (Traceloop) traces.

Examples

Name	Description	Complexity Level
Agno	Agno agent examples	Beginner
OpenAI SDK	OpenAI Python SDK, including chat completions and embeddings	Beginner
Claude Agent SDK	Claude Agent SDK	Beginner
MistralAI SDK	MistralAI Python SDK	Beginner
VertexAI SDK	VertexAI Python SDK	Beginner
LlamaIndex	LlamaIndex query engines	Beginner
DSPy	DSPy primitives and custom RAG modules	Beginner
Boto3 Bedrock Client	Boto3 Bedrock client	Beginner
LangChain	LangChain primitives and simple chains	Beginner
LiteLLM	A lightweight LiteLLM framework	Beginner
LiteLLM Proxy	LiteLLM Proxy to log OpenAI, Azure, Vertex, Bedrock	Beginner
Groq	Groq and AsyncGroq chat completions	Beginner
Anthropic	Anthropic Messages client	Beginner
BeeAI	Agentic instrumentation in the BeeAI framework	Beginner
Haystack	A Haystack QA RAG application	Intermediate
OpenAI Agents	OpenAI Agents with handoffs	Intermediate
Autogen AgentChat	Microsoft Autogen Assistant Agent and Team Chat	Intermediate
PydanticAI	PydanticAI agent examples	Intermediate
Pipecat	Pipecat application examples	Intermediate

JavaScript

Libraries

Package	Description	Version
@arizeai/openinference-semantic-conventions	Semantic conventions for tracing of LLM Apps.
@arizeai/openinference-core	Reusable utilities, configuration, and helpers for instrumentation.
@arizeai/openinference-instrumentation-bedrock	OpenInference Instrumentation for AWS Bedrock.
@arizeai/openinference-instrumentation-bedrock-agent-runtime	OpenInference Instrumentation for AWS Bedrock Agent Runtime.
@arizeai/openinference-instrumentation-beeai	OpenInference Instrumentation for BeeAI.
@arizeai/openinference-instrumentation-langchain	OpenInference Instrumentation for LangChain.js.
@arizeai/openinference-instrumentation-mcp	OpenInference Instrumentation for MCP.
@arizeai/openinference-instrumentation-openai	OpenInference Instrumentation for OpenAI SDK.
@arizeai/openinference-instrumentation-anthropic	OpenInference Instrumentation for the Anthropic SDK.
@arizeai/openinference-instrumentation-claude-agent-sdk	OpenInference Instrumentation for Claude Agent SDK.
@arizeai/openinference-vercel	OpenInference Support for Vercel AI SDK.
@arizeai/openinference-tanstack-ai	OpenInference middleware for TanStack AI.
@arizeai/openinference-genai	OpenInference Support for GenAI conventions

Java

Libraries

Package	Description	Version
openinference-semantic-conventions	Semantic conventions for tracing of LLM Apps.
openinference-instrumentation	Base instrumentation utilities.
openinference-instrumentation-langchain4j	OpenInference Instrumentation for LangChain4j.
openinference-instrumentation-springAI	OpenInference Instrumentation for Spring AI.
openinference-instrumentation-annotation	Annotation-based manual tracing with ByteBuddy.

Examples

Name	Description	Complexity Level
LangChain4j Example	Simple example using LangChain4j with OpenAI	Beginner
Spring AI Example	Spring AI example with OpenAI and tool calling	Beginner
Annotation Example	Annotation-based tracing with @Chain, @LLM, @Tool, @Agent	Beginner
Programmatic Example	Manual tracing with typed span classes (LLMSpan, AgentSpan, etc.)	Beginner

Supported Destinations

OpenInference supports the following destinations as span collectors.

• ✅ Arize Phoenix
• ✅ Arize AX
• ✅ Any OTEL-compatible collector

Community

Join our community to connect with thousands of machine learning practitioners and LLM observability enthusiasts!

• 🌍 Join our Slack community.
• 💡 Ask questions and provide feedback in the #phoenix-support channel.
• 🌟 Leave a star on our GitHub.
• 🐞 Report bugs with GitHub Issues.
• 𝕏 Follow us on X.
• 🗺️ Check out our roadmap to see where we're heading next.