Skip to main content

Get started sending traces to Phoenix from your application. Choose the approach that best fits your needs.

Let your coding agent set this up. Works with Claude Code, Codex, Cursor, and OpenCode.

Start Phoenix

In one terminal, start Phoenix and leave it running. It serves at http://localhost:6006:

Already have a Phoenix deployment? Skip this step. px setup can point at any running Phoenix, including a self-hosted one.

Add tracing with a coding agent

In a new terminal, from your app’s root directory, run one of these:

px setup hands the instrumentation to your coding agent and waits until a real trace arrives. It can also install the Phoenix skills so your agent can query what you capture. See Connect a project with px setup for the full flow, CI usage, and unsupported agents.

Quick Start#

The fastest way to get started is using the Phoenix OTEL wrapper, which provides sensible defaults and automatic configuration.

Python Setup

Use phoenix.otel for automatic configuration with Phoenix-aware defaults

TypeScript Setup

Use @arizeai/phoenix-otel to trace your Node.js applications

Instrumentation Methods#

Choose how you want to instrument your code:

Auto Instrumentation

Automatically capture traces from popular frameworks and LLM providers with zero code changes

Tracing Helpers

Use decorators and helpers to easily trace specific methods or code blocks in Python

Organization#

Organize your traces for better visibility and analysis:

Projects

Group traces by application or environment using projects

Sessions

Track multi-turn conversations by grouping related traces into sessions