Open-source AI observability

Turn AI traces into release evidence with Arize Phoenix

MetaCTO implements Arize Phoenix as the evidence workspace around a production AI workflow. OpenTelemetry traces expose model, retrieval, tool, and custom-logic behavior; reviewed failures become versioned dataset examples; and experiments show whether a proposed change is ready for an external approval and release process.

Explain
Follow an operational result through its model, retrieval, tool, and application spans
Compare
Test a candidate against versioned examples and explicit evaluation criteria
Improve
Convert reviewed failures into regression coverage for the next change

Trace-to-release evidence circuit

Governed
  1. 01
    Export OpenTelemetry spans with workflow and version context
  2. 02
    Inspect the trace and classify the observed failure
  3. 03
    Promote a reviewed case into a versioned dataset
  4. 04
    Run the proposed prompt or workflow as an experiment
  5. 05
    Attach code, model, or human evaluation annotations
  6. 06
    Send evidence to the external approval and release gate

Trace-to-dataset architecture

Connect runtime evidence to a repeatable evaluation loop

Phoenix becomes useful when every captured span can be interpreted in operational context and every release decision can point to representative test cases. The application remains responsible for authorization, approvals, deployment, and business-system actions.

Instrument

Describe the live run

01

Emit a coherent trace over OTLP from automatic or manual instrumentation.

  • Model, retrieval, tool, and custom application spans
  • OpenInference semantic attributes where they fit
  • Workflow, environment, and release identifiers
  • Redacted case metadata for useful segmentation

Investigate

Find the failing step

02

Use the Phoenix collector and trace UI to examine behavior before assigning a cause.

  • Inputs, outputs, timing, errors, and tool sequence
  • Retrieved context and model parameters where permitted
  • Human labels and span-level evaluation annotations
  • Failure taxonomy linked to an operational owner

Evaluate

Reproduce the evidence

03

Add reviewed examples to a versioned dataset and run candidates as comparable experiments.

  • Inputs with optional expected outputs and metadata
  • Pinned dataset version for the release candidate
  • Deterministic, model-based, or human evaluators
  • Experiment results connected back to traces

Release

Act outside Phoenix

04

Pass the evidence to the systems that own change control and production execution.

  • External technical and process-owner approval
  • CI/CD or deployment-system release
  • Business-system write-back under existing permissions
  • Rollback, incident response, and post-release sampling

Phoenix records and analyzes evidence. It does not establish business truth, grant tool authority, enforce every workflow guardrail, approve a release, or write an operational decision back to the system of record.

Operational evidence in practice

Investigate and test the AI behavior behind real operating queues

Each workflow starts with an observable failure definition, enough trace context to diagnose it, a review method, and a release owner who can act on the findings.

01 Finance operations

Test invoice exception routing before rollout

Trace extraction, vendor lookup, policy retrieval, and routing logic for invoices that miss the straight-through path. Reviewed miscategorizations become dataset examples used to compare a revised prompt or workflow.

  1. Instrument document, retrieval, model, and routing spans
  2. Annotate confirmed category and missing-evidence failures
  3. Run the candidate against a pinned exception dataset
  4. Require external approval before changing production routing

Business outcome: More defensible routing changes with visible regression evidence

02 Project controls

Diagnose unsupported construction responses

Inspect which documents, chunks, and tool steps contributed to an RFI or submittal draft. Separate retrieval failure from unsupported reasoning, then preserve corrected field cases for the next experiment.

  1. Tag traces by project, workflow, and release without exposing unnecessary content
  2. Review citation presence and evidence support as separate criteria
  3. Add confirmed failures and expected handling to a dataset
  4. Compare the change before the project team adopts it

Business outcome: Faster root-cause review and stronger release evidence for document-grounded assistance

03 Claims operations

Review claim-intake classification drift

Observe document processing, policy context, classification, and escalation steps while authorized adjusters retain claim authority. Sample behavior by claim type and route confirmed evaluation failures to the right workflow owner.

  1. Capture non-sensitive case and release identifiers
  2. Score schema and routing rules with deterministic checks
  3. Use rubric-based review for ambiguous classifications
  4. Test the proposed fix across known exception segments

Business outcome: Earlier visibility into classification regressions without automating claim decisions

04 Customer operations

Improve support-resolution recommendations

Trace knowledge retrieval, tool use, and the proposed case action for a support assistant. Turn agent corrections and reopened cases into evaluation examples while the service platform remains the source of truth.

  1. Correlate the trace with workflow and knowledge versions
  2. Review samples for evidence use and complete next actions
  3. Compare candidate behavior on corrected cases
  4. Monitor the approved version by failure category

Business outcome: A tighter learning loop between reviewed cases and workflow changes

05 Order operations

Reproduce an order-exception failure

Use traces to determine whether stale context, a tool error, or workflow logic produced an incorrect inventory or hold recommendation. Capture the case as a reproducible test without letting Phoenix retry or commit the order change.

  1. Inspect source-query, model, tool, and error spans
  2. Confirm the outcome against the order system
  3. Add the corrected case to the regression dataset
  4. Verify the fix before an external deployment resumes automation

Business outcome: Clearer incident diagnosis and safer recovery for order workflows

Start with the failure you need to explain

Design the evidence loop before instrumenting every span

We map the operational outcome, failure classes, trace attributes, privacy boundaries, review rubric, dataset strategy, release gate, and incident owner for one production workflow.

Production controls

Make telemetry useful without turning it into an authority layer

An observable workflow can still be unsafe, private, or wrong. Phoenix needs an operating design around access, telemetry content, evaluator limitations, release ownership, and recovery.

Human approval points

  • Have domain reviewers label ambiguous or consequential cases and document the rubric behind each annotation.
  • Require technical and process owners to review regressions, uncovered segments, and evaluator limitations before release.
  • Send policy conflicts, sensitive-data findings, and high-impact production failures to established incident or compliance owners.

Failure handling

  • Buffer or degrade telemetry export so a Phoenix outage does not silently become authority to skip application controls or duplicate work.
  • Alert when instrumentation breaks, trace volume drops unexpectedly, evaluations fail to run, or dataset experiments are incomplete.
  • Reconcile a suspected bad result against the source system before retrying any external action.
  • Keep an approved prior release and manual fallback in the deployment and operating process outside Phoenix.
1 Privacy

Telemetry minimization

Define which prompts, retrieved passages, tool arguments, outputs, and identifiers may enter traces. Redact or omit sensitive fields before export rather than relying on the observability store to repair exposure.

2 Access

Authenticated access

When self-hosting, enable authentication, choose user or system API keys for the right principal, assign appropriate roles, protect secrets, and place the instance inside the organization's network and access controls.

3 Storage

Durable persistence

Use a production-suitable SQL backend, retention policy, backups, and tested restoration for the evidence the team is accountable for keeping.

4 Quality

Evaluation calibration

Validate evaluators against reviewed examples, separate deterministic requirements from judgment, and retain the underlying trace so a score can be challenged.

5 Lineage

Versioned evidence

Pin the dataset version, task, prompt or workflow version, evaluator configuration, and release candidate so comparisons remain interpretable.

6 Authority

External action boundary

Keep release approval, deployment credentials, workflow permissions, and business-system write-backs in their authoritative systems with explicit receipts.

A narrow evidence role

Let Phoenix explain AI behavior, not own the business decision

Phoenix sits beside the operational runtime. It receives and organizes evidence about what the workflow did, then helps teams turn reviewed behavior into testable cases.

Specific role

Collect OTLP traces, support inspection and annotations, maintain versioned evaluation datasets, and compare experiments so human owners and external release systems can make an informed change decision.

1

Evidence in

  • Instrumented application and agent traces
  • OpenTelemetry and OpenInference attributes
  • Reviewed labels, expected outputs, and metadata
  • Prompt, model, retrieval, and workflow versions
2

Phoenix workspace

  • Projects, traces, spans, and annotations
  • Versioned datasets and examples
  • Experiment runs and evaluator results
  • Prompt comparisons and failure investigation
3

Owned elsewhere

  • Identity, source permissions, and data policy
  • Human approval and release authorization
  • Deployment, rollback, and incident command
  • System-of-record writes and business outcome measurement

Self-hosting Phoenix gives the team control over deployment and persistence, but it also makes the team responsible for infrastructure, authentication, upgrades, backups, retention, network security, and operational support.

Arize Phoenix production FAQ

Decide how Phoenix should collect evidence without owning the decision

Use these answers to scope Phoenix tracing, evaluation, access, and operating responsibilities around a governed Operational AI workflow.

What should an Operational AI team capture in an Arize Phoenix trace?

Phoenix accepts traces over the OpenTelemetry Protocol, while OpenInference conventions describe AI-specific steps such as model calls, retrieval, tools, agents, and custom logic. MetaCTO starts with the spans needed to reconstruct one business outcome, then adds workflow, environment, release, and source-version identifiers. Prompt content, retrieved passages, tool arguments, and business identifiers are minimized or redacted before export according to the organization's data policy; observability value is not a reason to copy every sensitive field into Phoenix.

How can a production failure become a regression test in Phoenix?

Phoenix can promote production traces into datasets, and its datasets version every insert, update, and delete so an experiment can be pinned to a specific evidence set. MetaCTO has a domain owner confirm the failure, expected handling, and safe test inputs before adding the case. A candidate prompt or workflow then runs against that pinned version with the same evaluation criteria, preserving a defensible connection between the observed incident and the release evidence.

Should a Phoenix evaluation score automatically approve a workflow release?

No. Phoenix supports deterministic code checks, LLM-based evaluators, and human annotations, but each measures only the rubric and data it was given. MetaCTO calibrates automated evaluators against reviewed examples, separates hard requirements from judgment calls, and examines failures by segment rather than relying on one aggregate score. Technical and process owners approve the release in the existing change-control system after reviewing regressions, uncovered cases, and evaluator limitations.

Does Arize Phoenix enforce tool permissions, human approvals, or business-system write-backs?

Phoenix records and evaluates evidence about application behavior; a trace or annotation does not grant authority to take an operational action. MetaCTO keeps identity, least-privilege tool credentials, deterministic policy checks, approval queues, idempotent writes, and reconciliation in the workflow and systems of record. Phoenix can show whether those steps appeared and how they behaved, while the runtime remains responsible for blocking, committing, retrying, or rolling back work.

What does a team need to operate when it self-hosts Arize Phoenix?

Phoenix uses SQLite by default for simple deployments and supports PostgreSQL for production and multi-user deployments. Its official production guidance calls for capacity planning and database backups, and authentication is disabled by default until explicitly configured; authenticated deployments provide admin, member, and read-only viewer roles plus system and user API keys. MetaCTO treats the instance as production evidence infrastructure, with network controls, secret rotation, retention, tested restores, upgrades, ingestion monitoring, and a telemetry-failure plan owned by named operators.

Observability selection

Choose Phoenix for an open, trace-connected evaluation loop

The deciding question is not whether a workflow uses an LLM. It is whether the team needs to inspect multi-step behavior, curate production cases, and compare changes with an open-source platform it can deploy or operate on its own terms.

Arize Phoenix is a strong fit when

  • OpenTelemetry-compatible collection and OpenInference instrumentation fit the existing runtime and portability requirements.
  • The team wants traces, datasets, experiments, and evaluation annotations connected in one open-source workflow.
  • Engineers and operators can define failure classes, maintain representative examples, and assign owners to review findings.
  • Self-hosting is valuable and the organization can own persistence, access, upgrades, retention, and support.
  • The improvement loop needs to link a production trace to a reproducible experiment instead of stopping at dashboards.

Compare an alternative when

  • ! Infrastructure, logs, service maps, and incident operations are the primary concern. Datadog may be the broader observability home, with AI traces forwarded or correlated as needed.
  • ! A deeply integrated LangChain or LangGraph developer workflow is the selection priority. Compare LangSmith against Phoenix with the actual instrumentation and evaluation process.
  • ! The team prefers another open-source product's prompt, feedback, or product-analytics workflow. Evaluate Langfuse with the same privacy, hosting, and release requirements.
  • ! Evaluation authoring and experiment review are the center of the team's release process. Compare Braintrust using representative datasets and reviewer workflows.
  • ! The organization wants a vendor-operated enterprise platform and commercial support rather than owning an open-source deployment. Evaluate Arize's commercial offering separately from Phoenix.

Run a proof on one production workflow. Compare trace completeness, investigation speed, dataset curation, evaluator review, access controls, storage operations, and the handoff into the existing release process. Do not choose on a feature checklist alone.

Complete the evidence system

Connect Phoenix to portable telemetry, workflow context, and accountable operations

Observability improves a workflow only when teams can reproduce failures, govern the underlying context, release changes deliberately, and measure the real operating result.

See where the operating pattern applies.

Map your first AI opportunity

Tell us where work gets stuck. We’ll map the context, controls, and production workflow before deciding where Arize Phoenix fits.

No spam
100% secure
Quick response

Subscribe to our newsletter

Be the first to get insights on Operational AI, engineering quality, and building systems that move real business metrics.

By subscribing you agree to our Privacy Policy.