phoenix-observability

Trace, evaluate, and monitor LLM applications with OpenTelemetry-based observability.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Clay-HHK/claude-skills --skill phoenix-observability-clay-hhk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: phoenix-observability
Source: https://github.com/Clay-HHK/claude-skills/tree/main/phoenix
Command: npx skills add https://github.com/Clay-HHK/claude-skills --skill phoenix-observability-clay-hhk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires arize-phoenix, and includes references (resource) components.

What problem does it solve? Debugging and monitoring LLM applications in production is difficult without visibility into traces, evaluation results, and system behavior. This Skill provides a self-hosted observability platform for tracing LLM calls, running systematic evaluations, and monitoring production AI systems without vendor lock-in. ## Core Features & Use Cases - OpenTelemetry Tracing: Instrument OpenAI, LangChain, LlamaIndex, and Anthropic SDKs to capture detailed traces and spans of every LLM call. - LLM Evaluation Framework: Run built-in evaluators (hallucination, relevance, toxicity) or custom LLM-as-judge evaluators on datasets and production spans. - Datasets & Experiments: Create versioned test datasets and run experiments to compare prompts, models, and configurations with aggregate metrics. - Use Case: A team deploying a RAG chatbot instruments their LangChain pipeline with Phoenix, runs hallucination evaluations on production spans nightly, and compares prompt variants via experiments before each release. ## Quick Start Install arize-phoenix, launch the Phoenix server, and instrument my OpenAI client so all LLM calls are traced to the local Phoenix UI.

Frequently Asked Questions about phoenix-observability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace OpenAI calls with Phoenix?▼

Register an OpenTelemetry tracer provider with phoenix.otel.register pointing to the Phoenix endpoint, then call OpenAIInstrumentor().instrument with that provider. All subsequent OpenAI SDK calls are automatically traced and visible in the Phoenix UI.

How do I run LLM evaluations on a dataset in Phoenix?▼

Create a dataset with the Phoenix Client, define a task function and evaluators, then call run_experiment with the dataset name. Built-in evaluators like HallucinationEvaluator and RelevanceEvaluator use an LLM judge model such as GPT-4o.

Phoenix vs LangSmith for LLM observability?▼

Phoenix is open-source and self-hosted with PostgreSQL or SQLite, avoiding vendor lock-in, while LangSmith is a managed platform with LangChain-first integration. Phoenix supports any framework via OpenTelemetry instrumentation.

Why are my traces not appearing in Phoenix?▼

Verify the endpoint includes /v1/traces, confirm the Phoenix server is running via the /healthz endpoint, and call force_flush on the tracer provider. Also ensure the instrumentor is called after registering the tracer provider.

Can Phoenix run in production with authentication?▼

Yes, set PHOENIX_ENABLE_AUTH=true with a PHOENIX_SECRET of at least 32 characters, and use PostgreSQL via PHOENIX_SQL_DATABASE_URL for the backend. Docker and Kubernetes deployment configurations are supported.