Jump to content

Connect Leeroopedia MCP: Equip your AI agents to search best practices, build plans, verify code, diagnose failures, and look up hyperparameter defaults.

Implementation:Arize ai Phoenix Pip Install Phoenix Otel

From Leeroopedia
Knowledge Sources
Domains AI Observability, Dependency Management, OpenTelemetry
Last Updated 2026-02-14 00:00 GMT

Overview

Concrete tool for installing all required OpenTelemetry dependencies for AI observability provided by the arize-phoenix-otel Python package.

Description

The arize-phoenix-otel package (version 0.14.0 as of this writing) is a meta-package that bundles the complete set of OpenTelemetry SDK components, OTLP exporters, and OpenInference semantic conventions needed to instrument LLM applications and export traces to Phoenix or any OTLP-compatible collector.

A single pip install command resolves and installs the following transitive dependencies:

  • opentelemetry-sdk: Core tracing SDK providing TracerProvider, Resource, and span processor abstractions.
  • opentelemetry-exporter-otlp: Meta-package that pulls in both HTTP and gRPC OTLP exporters (opentelemetry-exporter-otlp-proto-http and opentelemetry-exporter-otlp-proto-grpc).
  • opentelemetry-proto (>=1.12.0): Protobuf message definitions for the OTLP wire format.
  • opentelemetry-semantic-conventions: Standard OTel semantic attribute keys.
  • openinference-semantic-conventions (>=0.1.17): AI-specific semantic attribute keys for LLM spans (e.g., llm.token_count.prompt, input.value, output.value).
  • openinference-instrumentation (>=0.1.38): Base instrumentation framework with entry point discovery for auto-instrumentation of LLM libraries.
  • typing-extensions (>=4.5, <5): Backported typing features for Python 3.8+ compatibility.
  • wrapt: Function wrapping utilities used by instrumentation hooks.

The package also provides Phoenix-aware wrapper classes (TracerProvider, SimpleSpanProcessor, BatchSpanProcessor, HTTPSpanExporter, GRPCSpanExporter) that auto-infer configuration from environment variables.

Usage

Use this installation command when:

  • Bootstrapping a new Python project that needs LLM tracing.
  • Adding observability to an existing LLM application.
  • Ensuring all OTel dependencies are at compatible versions.
  • Needing Phoenix-specific convenience wrappers on top of the standard OTel SDK.

Code Reference

Source Location

  • Repository: Phoenix
  • File: packages/phoenix-otel/pyproject.toml

Signature

pip install arize-phoenix-otel

Import

from phoenix.otel import register
from phoenix.otel import TracerProvider
from phoenix.otel import SimpleSpanProcessor, BatchSpanProcessor
from phoenix.otel import HTTPSpanExporter, GRPCSpanExporter

I/O Contract

Inputs

Name Type Required Description
arize-phoenix-otel Python package Yes The package name passed to pip install
Python version Runtime Yes Requires Python >=3.8, <3.14

Outputs

Name Type Description
phoenix.otel module Python module Provides register(), TracerProvider, span processors, and span exporters with Phoenix-aware defaults
opentelemetry-sdk Python package Core OTel tracing SDK installed as a dependency
opentelemetry-exporter-otlp Python package OTLP exporters for HTTP and gRPC transport
openinference-semantic-conventions Python package AI-specific semantic attribute constants
openinference-instrumentation Python package Base instrumentation framework with entry point discovery

Usage Examples

Basic Installation

pip install arize-phoenix-otel

Installation with a Specific LLM Instrumentor

# Install phoenix-otel alongside the OpenAI instrumentor
pip install arize-phoenix-otel openinference-instrumentation-openai

Verifying the Installation

from phoenix.otel import register

# This will print tracing details including endpoint and transport info
tracer_provider = register(verbose=True)

Dependency Tree Overview

arize-phoenix-otel (0.14.0)
  +-- opentelemetry-sdk
  +-- opentelemetry-exporter-otlp
  |     +-- opentelemetry-exporter-otlp-proto-http
  |     +-- opentelemetry-exporter-otlp-proto-grpc
  +-- opentelemetry-proto (>=1.12.0)
  +-- opentelemetry-semantic-conventions
  +-- openinference-semantic-conventions (>=0.1.17)
  +-- openinference-instrumentation (>=0.1.38)
  +-- typing-extensions (>=4.5, <5)
  +-- wrapt

Related Pages

Implements Principle

Requires Environment

Page Connections

Double-click a node to navigate. Hold to expand connections.
Principle
Implementation
Heuristic
Environment