Migrate from Phoenix to Arize AX

Move your historical Phoenix data and future application traces into Arize AX. This keeps past and new observability data together in one AX space, where your team can investigate traces, manage datasets, and compare experiment results.

What you can migrate

Migrated by the coding-agent skill	Not currently migrated
Traces and spans	Evaluator definitions
Datasets, versions, and examples	Prompts and tags
Experiments and runs	Attachments
Stored evaluation scores, labels, and explanations	Span, trace, and session annotations
IDs, relationships, historical times, and supported attributes	Dataset/version descriptions and dataset/version/experiment metadata

The skill verifies the recreated records in AX and does not rerun evaluators or make model calls. If AX cannot preserve a dataset-version relationship, it stops instead of importing an incorrect relationship.

Migrate existing Phoenix data

Install the migration skill

npx skills add Arize-ai/arize-skills --skill arize-phoenix-migration --yes

Ask your coding agent to start

Use the Arize Phoenix migration skill. I want to migrate my Phoenix data to AX.

The agent inventories Phoenix, proposes fresh AX destination names, and asks what you want to migrate. You can migrate everything supported, traces only, dataset and experiment data only, or selected resources. You can also choose the destination AX project name.

Provide connection details privately

Give the agent the path to an existing local .env, or let it create a secure credential-entry command for you to run in a separate terminal window. Do not paste API keys into agent chat.

Create or find a Phoenix API key. A key is optional only for self-hosted Phoenix with authentication disabled.
Create or find an AX API key.

The agent resolves human-readable AX spaces for you; you do not need to find opaque IDs.

Review the inventory and migrate

The agent shows what it found, what is excluded, the AX organization and space, and the proposed project and dataset names. Reply go to accept everything shown, or specify a subset or another project name.A typical small or medium migration takes about 5–20 minutes. Large exports or AX trace indexing can take longer.

Open the verified results

Wait for the agent to report verified, not only uploaded. Its final table links directly to the AX trace project, dataset examples and versions, and experiments with stored evaluation results.

Send new application traces to AX

Historical migration does not redirect your running application. Update its trace exporter so new spans go to AX.

Install the AX tracing SDK

pip install "arize[otel]"

Keep your existing OpenInference instrumentors and manual spans. Replace the Phoenix registration with AX credentials and a space ID:

import os

from arize.otel import register
from openinference.instrumentation.openai import OpenAIInstrumentor

tracer_provider = register(
    space_id=os.environ["ARIZE_SPACE_ID"],
    api_key=os.environ["ARIZE_API_KEY"],
    project_name="my-llm-app",
)
OpenAIInstrumentor().instrument(tracer_provider=tracer_provider)

See Configure your tracer for other frameworks, JavaScript, regions, and manual OpenTelemetry setup.

Verify and finish the cutover

For production applications, send traces to Phoenix and AX for one representative traffic cycle. Compare trace counts, span trees, attributes, sessions, and users over the same time window. Once they match, stop the Phoenix export path and remove its credentials from your deployment.

Keep Phoenix running until the historical migration is verified because the skill reads directly from the source instance. See the migration skill source for current behavior and limits.

Quickstart

Instrument

Observe

Agents

Evaluate

Experimentation

Machine Learning

Settings

Security

Migrate from Phoenix to Arize AX

What you can migrate

Migrate existing Phoenix data

Send new application traces to AX

​What you can migrate

​Migrate existing Phoenix data

​Send new application traces to AX

What you can migrate

Migrate existing Phoenix data

Send new application traces to AX