Span Attribute Filtering#

April 20, 2026

Available in arize-phoenix 14.9.0+ (server), arize-phoenix-client 2.4.0+ (Python), @arizeai/phoenix-client 6.7.0+ (TypeScript)

Filter spans by stored attribute values when calling GET /v1/projects/{project_identifier}/spans. Multiple attribute=key:value pairs are AND-ed together. The value’s type determines how the stored attribute is matched — passing an integer matches a stored integer; passing a string matches a stored string — so user.id: 12345 (int) and user.id: "12345" (string) are distinct filters.

Python

from phoenix.client import Clientclient = Client()spans = client.spans.get_spans(    project_identifier="my-project",    attributes={        "llm.model_name": "gpt-4o",        "metadata.tier": "premium",    },)

TypeScript

import { createClient } from "@arizeai/phoenix-client";import { getSpans } from "@arizeai/phoenix-client/spans";const client = createClient();const result = await getSpans({  client,  project: { projectName: "my-project" },  attributes: {    "llm.model_name": "gpt-4o",    "metadata.tier": "premium",  },});

REST

GET /v1/projects/my-project/spans?attribute=llm.model_name:gpt-4o&attribute=metadata.tier:premium

CLI

px span list --project my-project \  --attribute "llm.model_name:gpt-4o" \  --attribute "metadata.tier:premium"

• Type-aware matching — str, int, float, and bool values each select a distinct storage type; an integer query (1) also matches whole-number floats in storage (1.0)
• Forced-string matching — wrap a numeric-looking string in quotes: user.id:"12345" (URL-encoded %2212345%22); the Python and TypeScript clients handle this automatically
• Colon-in-value is supported — split is on the first : only, so session.id:sess:abc:123 works without escaping
• AND semantics — repeat the parameter or add multiple entries to the map to require all conditions

CLI Span Notes#

April 20, 2026

Available in @arizeai/phoenix-cli 1.1.0+

Add free-text notes to spans from the terminal with px span add-note. Pass --include-notes to px span list or px trace get to read notes back alongside span data.

# Attach a note to a spanpx span add-note <span-id> --text "Reviewed manually — output looks correct."# List spans with their notespx span list --include-notes# Fetch a trace with span notespx trace get <trace-id> --include-notes

Notes are stored separately from annotations. When you pass --include-annotations, note entries are excluded from that output — use --include-notes to fetch them explicitly.

Claude Opus 4.7 in the Playground#

April 20, 2026

Available in arize-phoenix 14.9.0+

Claude Opus 4.7 is now available as a model option in the Phoenix Playground. Select it from the model picker to compare outputs against other Anthropic and cross-provider models.