phoenix-tracing

OpenInference semantic conventions and instrumentation for Phoenix AI observability. Use when implementing LLM tracing, creating custom spans, or deploying to…

INSTALLATION
npx skills add https://github.com/arize-ai/phoenix --skill phoenix-tracing
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

Phoenix Tracing

Comprehensive guide for instrumenting LLM applications with OpenInference tracing in Phoenix. Contains reference files covering setup, instrumentation, span types, and production deployment.

When to Apply

Reference these guidelines when:

  • Setting up Phoenix tracing (Python or TypeScript)
  • Creating custom spans for LLM operations
  • Adding attributes following OpenInference conventions
  • Deploying tracing to production
  • Querying and analyzing trace data

Reference Categories

Priority

Category

Description

Prefix

1

Setup

Installation and configuration

setup-*

2

Instrumentation

Auto and manual tracing

instrumentation-*

3

Span Types

9 span kinds with attributes

span-*

4

Organization

Projects and sessions

projects-*, sessions-*

5

Enrichment

Custom metadata

metadata-*

6

Production

Batch processing, masking

production-*

7

Feedback

Annotations and evaluation

annotations-*

Quick Reference

1. Setup (START HERE)

  • setup-python - Install arize-phoenix-otel, configure endpoint

2. Instrumentation

3. Span Types (with full attribute schemas)

  • span-llm - LLM API calls (model, tokens, messages, cost)
  • span-tool - Function/API calls (name, parameters)

4. Organization

5. Enrichment

6. Production (CRITICAL)

7. Feedback

Reference Files

Common Workflows

  • Quick Start: setup-{lang} → instrumentation-auto-{lang} → Check Phoenix
  • Custom Spans: setup-{lang} → instrumentation-manual-{lang} → span-{type}
  • Session Tracking: sessions-{lang} for conversation grouping patterns
  • Production: production-{lang} for batching, masking, and deployment

How to Use This Skill

Navigation Patterns:

# By category prefix

references/setup-*              # Installation and configuration

references/instrumentation-*    # Auto and manual tracing

references/span-*               # Span type specifications

references/sessions-*           # Session tracking

references/production-*         # Production deployment

references/fundamentals-*       # Core concepts

references/attributes-*         # Attribute specifications

# By language

references/*-python.md          # Python implementations

references/*-typescript.md      # TypeScript implementations

Reading Order:

  • Start with setup-{lang} for your language
  • Choose instrumentation-auto-{lang} OR instrumentation-manual-{lang}
  • Reference span-{type} files as needed for specific operations
  • See fundamentals-* files for attribute specifications

References

Phoenix Documentation:

Python API Documentation:

TypeScript API Documentation:

  • TypeScript Packages - @arizeai/phoenix-otel, @arizeai/phoenix-client, and other TypeScript packages
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card