Implementation:Arize ai Phoenix Pip Install Phoenix Otel
| 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-httpandopentelemetry-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