[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BJWX6Z5WVBAC98RGHC99GN":3,"skill-same:01M7BJWX6Z5WVBAC98RGHC99GN":67},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":14,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":42,"install":43,"resources":56},"01M7BJWX6Z5WVBAC98RGHC99GN","observability-phoenix",null,"Open-source AI observability platform for LLM tracing, evaluation, and monitoring. Use when debugging LLM applications with detailed traces, running evaluations on datasets, or monitoring production AI systems with real-time insights.","origin-labs-ai\u002Fcode","origin-labs-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F347654492?v=4","01M7B0MAD1JMVZ6ME9891AYYYG","Origin","01M7B0MADP3AZS42R4NEF1JTS8",0,"MIT","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fpayloads\u002Fskills\u002Fobservability-phoenix\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: observability-phoenix\ndescription: Open-source AI observability platform for LLM tracing, evaluation, and monitoring. Use when debugging LLM applications with detailed traces, running evaluations on datasets, or monitoring production AI systems with real-time insights.\nversion: 1.0.0\nauthor: Orchestra Research\nlicense: MIT\ntags: [Observability, Phoenix, Arize, Tracing, Evaluation, Monitoring, LLM Ops, OpenTelemetry]\ndependencies: [arize-phoenix>=12.0.0]\n---\n\n# Phoenix - AI Observability Platform\n\nOpen-source AI observability and evaluation platform for LLM applications with tracing, evaluation, datasets, experiments, and real-time monitoring.\n\n## When to use Phoenix\n\n**Use Phoenix when:**\n- Debugging LLM application issues with detailed traces\n- Running systematic evaluations on datasets\n- Monitoring production LLM systems in real-time\n- Building experiment pipelines for prompt\u002Fmodel comparison\n- Self-hosted observability without vendor lock-in\n\n**Key features:**\n- **Tracing**: OpenTelemetry-based trace collection for any LLM framework\n- **Evaluation**: LLM-as-judge evaluators for quality assessment\n- **Datasets**: Versioned test sets for regression testing\n- **Experiments**: Compare prompts, models, and configurations\n- **Playground**: Interactive prompt testing with multiple models\n- **Open-source**: Self-hosted with PostgreSQL or SQLite\n\n**Use alternatives instead:**\n- **LangSmith**: Managed platform with LangChain-first integration\n- **Weights & Biases**: Deep learning experiment tracking focus\n- **Arize Cloud**: Managed Phoenix with enterprise features\n- **MLflow**: General ML lifecycle, model registry focus\n\n## Quick start\n\n### Installation\n\n```bash\npip install arize-phoenix\n\n# With specific backends\npip install arize-phoenix[embeddings]  # Embedding analysis\npip install arize-phoenix-otel         # OpenTelemetry config\npip install arize-phoenix-evals        # Evaluation framework\npip install arize-phoenix-client       # Lightweight REST client\n```\n\n### Launch Phoenix server\n\n```python\nimport phoenix as px\n\n# Launch in notebook (ThreadServer mode)\nsession = px.launch_app()\n\n# View UI\nsession.view()  # Embedded iframe\nprint(session.url)  # http:\u002F\u002Flocalhost:6006\n```\n\n### Command-line server (production)\n\n```bash\n# Start Phoenix server\nphoenix serve\n\n# With PostgreSQL\nexport PHOENIX_SQL_DATABASE_URL=\"postgresql:\u002F\u002Fuser:pass@host\u002Fdb\"\nphoenix serve --port 6006\n```\n\n### Basic tracing\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.openai import OpenAIInstrumentor\n\n# Configure OpenTelemetry with Phoenix\ntracer_provider = register(\n    project_name=\"my-llm-app\",\n    endpoint=\"http:\u002F\u002Flocalhost:6006\u002Fv1\u002Ftraces\"\n)\n\n# Instrument OpenAI SDK\nOpenAIInstrumentor().instrument(tracer_provider=tracer_provider)\n\n# All OpenAI calls are now traced\nfrom openai import OpenAI\nclient = OpenAI()\nresponse = client.chat.completions.create(\n    model=\"gpt-4o\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello!\"}]\n)\n```\n\n## Core concepts\n\n### Traces and spans\n\nA **trace** represents a complete execution flow, while **spans** are individual operations within that trace.\n\n```python\nfrom phoenix.otel import register\nfrom opentelemetry import trace\n\n# Setup tracing\ntracer_provider = register(project_name=\"my-app\")\ntracer = trace.get_tracer(__name__)\n\n# Create custom spans\nwith tracer.start_as_current_span(\"process_query\") as span:\n    span.set_attribute(\"input.value\", query)\n\n    # Child spans are automatically nested\n    with tracer.start_as_current_span(\"retrieve_context\"):\n        context = retriever.search(query)\n\n    with tracer.start_as_current_span(\"generate_response\"):\n        response = llm.generate(query, context)\n\n    span.set_attribute(\"output.value\", response)\n```\n\n### Projects\n\nProjects organize related traces:\n\n```python\nimport os\nos.environ[\"PHOENIX_PROJECT_NAME\"] = \"production-chatbot\"\n\n# Or per-trace\nfrom phoenix.otel import register\ntracer_provider = register(project_name=\"experiment-v2\")\n```\n\n## Framework instrumentation\n\n### OpenAI\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.openai import OpenAIInstrumentor\n\ntracer_provider = register()\nOpenAIInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n### LangChain\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.langchain import LangChainInstrumentor\n\ntracer_provider = register()\nLangChainInstrumentor().instrument(tracer_provider=tracer_provider)\n\n# All LangChain operations traced\nfrom langchain_openai import ChatOpenAI\nllm = ChatOpenAI(model=\"gpt-4o\")\nresponse = llm.invoke(\"Hello!\")\n```\n\n### LlamaIndex\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.llama_index import LlamaIndexInstrumentor\n\ntracer_provider = register()\nLlamaIndexInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n### Anthropic\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.anthropic import AnthropicInstrumentor\n\ntracer_provider = register()\nAnthropicInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n## Evaluation framework\n\n### Built-in evaluators\n\n```python\nfrom phoenix.evals import (\n    OpenAIModel,\n    HallucinationEvaluator,\n    RelevanceEvaluator,\n    ToxicityEvaluator,\n    llm_classify\n)\n\n# Setup model for evaluation\neval_model = OpenAIModel(model=\"gpt-4o\")\n\n# Evaluate hallucination\nhallucination_eval = HallucinationEvaluator(eval_model)\nresults = hallucination_eval.evaluate(\n    input=\"What is the capital of France?\",\n    output=\"The capital of France is Paris.\",\n    reference=\"Paris is the capital of France.\"\n)\n```\n\n### Custom evaluators\n\n```python\nfrom phoenix.evals import llm_classify\n\n# Define custom evaluation\ndef evaluate_helpfulness(input_text, output_text):\n    template = \"\"\"\n    Evaluate if the response is helpful for the given question.\n\n    Question: {input}\n    Response: {output}\n\n    Is this response helpful? Answer 'helpful' or 'not_helpful'.\n    \"\"\"\n\n    result = llm_classify(\n        model=eval_model,\n        template=template,\n        input=input_text,\n        output=output_text,\n        rails=[\"helpful\", \"not_helpful\"]\n    )\n    return result\n```\n\n### Run evaluations on dataset\n\n```python\nfrom phoenix import Client\nfrom phoenix.evals import run_evals\n\nclient = Client()\n\n# Get spans to evaluate\nspans_df = client.get_spans_dataframe(\n    project_name=\"my-app\",\n    filter_condition=\"span_kind == 'LLM'\"\n)\n\n# Run evaluations\neval_results = run_evals(\n    dataframe=spans_df,\n    evaluators=[\n        HallucinationEvaluator(eval_model),\n        RelevanceEvaluator(eval_model)\n    ],\n    provide_explanation=True\n)\n\n# Log results back to Phoenix\nclient.log_evaluations(eval_results)\n```\n\n## Datasets and experiments\n\n### Create dataset\n\n```python\nfrom phoenix import Client\n\nclient = Client()\n\n# Create dataset\ndataset = client.create_dataset(\n    name=\"qa-test-set\",\n    description=\"QA evaluation dataset\"\n)\n\n# Add examples\nclient.add_examples_to_dataset(\n    dataset_name=\"qa-test-set\",\n    examples=[\n        {\n            \"input\": {\"question\": \"What is Python?\"},\n            \"output\": {\"answer\": \"A programming language\"}\n        },\n        {\n            \"input\": {\"question\": \"What is ML?\"},\n            \"output\": {\"answer\": \"Machine learning\"}\n        }\n    ]\n)\n```\n\n### Run experiment\n\n```python\nfrom phoenix import Client\nfrom phoenix.experiments import run_experiment\n\nclient = Client()\n\ndef my_model(input_data):\n    \"\"\"Your model function.\"\"\"\n    question = input_data[\"question\"]\n    return {\"answer\": generate_answer(question)}\n\ndef accuracy_evaluator(input_data, output, expected):\n    \"\"\"Custom evaluator.\"\"\"\n    return {\n        \"score\": 1.0 if expected[\"answer\"].lower() in output[\"answer\"].lower() else 0.0,\n        \"label\": \"correct\" if expected[\"answer\"].lower() in output[\"answer\"].lower() else \"incorrect\"\n    }\n\n# Run experiment\nresults = run_experiment(\n    dataset_name=\"qa-test-set\",\n    task=my_model,\n    evaluators=[accuracy_evaluator],\n    experiment_name=\"baseline-v1\"\n)\n\nprint(f\"Average accuracy: {results.aggregate_metrics['accuracy']}\")\n```\n\n## Client API\n\n### Query traces and spans\n\n```python\nfrom phoenix import Client\n\nclient = Client(endpoint=\"http:\u002F\u002Flocalhost:6006\")\n\n# Get spans as DataFrame\nspans_df = client.get_spans_dataframe(\n    project_name=\"my-app\",\n    filter_condition=\"span_kind == 'LLM'\",\n    limit=1000\n)\n\n# Get specific span\nspan = client.get_span(span_id=\"abc123\")\n\n# Get trace\ntrace = client.get_trace(trace_id=\"xyz789\")\n```\n\n### Log feedback\n\n```python\nfrom phoenix import Client\n\nclient = Client()\n\n# Log user feedback\nclient.log_annotation(\n    span_id=\"abc123\",\n    name=\"user_rating\",\n    annotator_kind=\"HUMAN\",\n    score=0.8,\n    label=\"helpful\",\n    metadata={\"comment\": \"Good response\"}\n)\n```\n\n### Export data\n\n```python\n# Export to pandas\ndf = client.get_spans_dataframe(project_name=\"my-app\")\n\n# Export traces\ntraces = client.list_traces(project_name=\"my-app\")\n```\n\n## Production deployment\n\n### Docker\n\n```bash\ndocker run -p 6006:6006 arizephoenix\u002Fphoenix:latest\n```\n\n### With PostgreSQL\n\n```bash\n# Set database URL\nexport PHOENIX_SQL_DATABASE_URL=\"postgresql:\u002F\u002Fuser:pass@host:5432\u002Fphoenix\"\n\n# Start server\nphoenix serve --host 0.0.0.0 --port 6006\n```\n\n### Environment variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PHOENIX_PORT` | HTTP server port | `6006` |\n| `PHOENIX_HOST` | Server bind address | `127.0.0.1` |\n| `PHOENIX_GRPC_PORT` | gRPC\u002FOTLP port | `4317` |\n| `PHOENIX_SQL_DATABASE_URL` | Database connection | SQLite temp |\n| `PHOENIX_WORKING_DIR` | Data storage directory | OS temp |\n| `PHOENIX_ENABLE_AUTH` | Enable authentication | `false` |\n| `PHOENIX_SECRET` | JWT signing secret | Required if auth enabled |\n\n### With authentication\n\n```bash\nexport PHOENIX_ENABLE_AUTH=true\nexport PHOENIX_SECRET=\"your-secret-key-min-32-chars\"\nexport PHOENIX_ADMIN_SECRET=\"admin-bootstrap-token\"\n\nphoenix serve\n```\n\n## Best practices\n\n1. **Use projects**: Separate traces by environment (dev\u002Fstaging\u002Fprod)\n2. **Add metadata**: Include user IDs, session IDs for debugging\n3. **Evaluate regularly**: Run automated evaluations in CI\u002FCD\n4. **Version datasets**: Track test set changes over time\n5. **Monitor costs**: Track token usage via Phoenix dashboards\n6. **Self-host**: Use PostgreSQL for production deployments\n\n## Common issues\n\n**Traces not appearing:**\n```python\nfrom phoenix.otel import register\n\n# Verify endpoint\ntracer_provider = register(\n    project_name=\"my-app\",\n    endpoint=\"http:\u002F\u002Flocalhost:6006\u002Fv1\u002Ftraces\"  # Correct endpoint\n)\n\n# Force flush\nfrom opentelemetry import trace\ntrace.get_tracer_provider().force_flush()\n```\n\n**High memory in notebook:**\n```python\n# Close session when done\nsession = px.launch_app()\n# ... do work ...\nsession.close()\npx.close_app()\n```\n\n**Database connection issues:**\n```bash\n# Verify PostgreSQL connection\npsql $PHOENIX_SQL_DATABASE_URL -c \"SELECT 1\"\n\n# Check Phoenix logs\nphoenix serve --log-level debug\n```\n\n## References\n\n- **[Advanced Usage](references\u002Fadvanced-usage.md)** - Custom evaluators, experiments, production setup\n- **[Troubleshooting](references\u002Ftroubleshooting.md)** - Common issues, debugging, performance\n\n## Resources\n\n- **Documentation**: https:\u002F\u002Fdocs.arize.com\u002Fphoenix\n- **Repository**: https:\u002F\u002Fgithub.com\u002FArize-ai\u002Fphoenix\n- **Docker Hub**: https:\u002F\u002Fhub.docker.com\u002Fr\u002Farizephoenix\u002Fphoenix\n- **Version**: 12.0.0+\n- **License**: Apache 2.0\n","# Phoenix - AI Observability Platform\n\nOpen-source AI observability and evaluation platform for LLM applications with tracing, evaluation, datasets, experiments, and real-time monitoring.\n\n## When to use Phoenix\n\n**Use Phoenix when:**\n- Debugging LLM application issues with detailed traces\n- Running systematic evaluations on datasets\n- Monitoring production LLM systems in real-time\n- Building experiment pipelines for prompt\u002Fmodel comparison\n- Self-hosted observability without vendor lock-in\n\n**Key features:**\n- **Tracing**: OpenTelemetry-based trace collection for any LLM framework\n- **Evaluation**: LLM-as-judge evaluators for quality assessment\n- **Datasets**: Versioned test sets for regression testing\n- **Experiments**: Compare prompts, models, and configurations\n- **Playground**: Interactive prompt testing with multiple models\n- **Open-source**: Self-hosted with PostgreSQL or SQLite\n\n**Use alternatives instead:**\n- **LangSmith**: Managed platform with LangChain-first integration\n- **Weights & Biases**: Deep learning experiment tracking focus\n- **Arize Cloud**: Managed Phoenix with enterprise features\n- **MLflow**: General ML lifecycle, model registry focus\n\n## Quick start\n\n### Installation\n\n```bash\npip install arize-phoenix\n\n# With specific backends\npip install arize-phoenix[embeddings]  # Embedding analysis\npip install arize-phoenix-otel         # OpenTelemetry config\npip install arize-phoenix-evals        # Evaluation framework\npip install arize-phoenix-client       # Lightweight REST client\n```\n\n### Launch Phoenix server\n\n```python\nimport phoenix as px\n\n# Launch in notebook (ThreadServer mode)\nsession = px.launch_app()\n\n# View UI\nsession.view()  # Embedded iframe\nprint(session.url)  # http:\u002F\u002Flocalhost:6006\n```\n\n### Command-line server (production)\n\n```bash\n# Start Phoenix server\nphoenix serve\n\n# With PostgreSQL\nexport PHOENIX_SQL_DATABASE_URL=\"postgresql:\u002F\u002Fuser:pass@host\u002Fdb\"\nphoenix serve --port 6006\n```\n\n### Basic tracing\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.openai import OpenAIInstrumentor\n\n# Configure OpenTelemetry with Phoenix\ntracer_provider = register(\n    project_name=\"my-llm-app\",\n    endpoint=\"http:\u002F\u002Flocalhost:6006\u002Fv1\u002Ftraces\"\n)\n\n# Instrument OpenAI SDK\nOpenAIInstrumentor().instrument(tracer_provider=tracer_provider)\n\n# All OpenAI calls are now traced\nfrom openai import OpenAI\nclient = OpenAI()\nresponse = client.chat.completions.create(\n    model=\"gpt-4o\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello!\"}]\n)\n```\n\n## Core concepts\n\n### Traces and spans\n\nA **trace** represents a complete execution flow, while **spans** are individual operations within that trace.\n\n```python\nfrom phoenix.otel import register\nfrom opentelemetry import trace\n\n# Setup tracing\ntracer_provider = register(project_name=\"my-app\")\ntracer = trace.get_tracer(__name__)\n\n# Create custom spans\nwith tracer.start_as_current_span(\"process_query\") as span:\n    span.set_attribute(\"input.value\", query)\n\n    # Child spans are automatically nested\n    with tracer.start_as_current_span(\"retrieve_context\"):\n        context = retriever.search(query)\n\n    with tracer.start_as_current_span(\"generate_response\"):\n        response = llm.generate(query, context)\n\n    span.set_attribute(\"output.value\", response)\n```\n\n### Projects\n\nProjects organize related traces:\n\n```python\nimport os\nos.environ[\"PHOENIX_PROJECT_NAME\"] = \"production-chatbot\"\n\n# Or per-trace\nfrom phoenix.otel import register\ntracer_provider = register(project_name=\"experiment-v2\")\n```\n\n## Framework instrumentation\n\n### OpenAI\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.openai import OpenAIInstrumentor\n\ntracer_provider = register()\nOpenAIInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n### LangChain\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.langchain import LangChainInstrumentor\n\ntracer_provider = register()\nLangChainInstrumentor().instrument(tracer_provider=tracer_provider)\n\n# All LangChain operations traced\nfrom langchain_openai import ChatOpenAI\nllm = ChatOpenAI(model=\"gpt-4o\")\nresponse = llm.invoke(\"Hello!\")\n```\n\n### LlamaIndex\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.llama_index import LlamaIndexInstrumentor\n\ntracer_provider = register()\nLlamaIndexInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n### Anthropic\n\n```python\nfrom phoenix.otel import register\nfrom openinference.instrumentation.anthropic import AnthropicInstrumentor\n\ntracer_provider = register()\nAnthropicInstrumentor().instrument(tracer_provider=tracer_provider)\n```\n\n## Evaluation framework\n\n### Built-in evaluators\n\n```python\nfrom phoenix.evals import (\n    OpenAIModel,\n    HallucinationEvaluator,\n    RelevanceEvaluator,\n    ToxicityEvaluator,\n    llm_classify\n)\n\n# Setup model for evaluation\neval_model = OpenAIModel(model=\"gpt-4o\")\n\n# Evaluate hallucination\nhallucination_eval = HallucinationEvaluator(eval_model)\nresults = hallucination_eval.evaluate(\n    input=\"What is the capital of France?\",\n    output=\"The capital of France is Paris.\",\n    reference=\"Paris is the capital of France.\"\n)\n```\n\n### Custom evaluators\n\n```python\nfrom phoenix.evals import llm_classify\n\n# Define custom evaluation\ndef evaluate_helpfulness(input_text, output_text):\n    template = \"\"\"\n    Evaluate if the response is helpful for the given question.\n\n    Question: {input}\n    Response: {output}\n\n    Is this response helpful? Answer 'helpful' or 'not_helpful'.\n    \"\"\"\n\n    result = llm_classify(\n        model=eval_model,\n        template=template,\n        input=input_text,\n        output=output_text,\n        rails=[\"helpful\", \"not_helpful\"]\n    )\n    return result\n```\n\n### Run evaluations on dataset\n\n```python\nfrom phoenix import Client\nfrom phoenix.evals import run_evals\n\nclient = Client()\n\n# Get spans to evaluate\nspans_df = client.get_spans_dataframe(\n    project_name=\"my-app\",\n    filter_condition=\"span_kind == 'LLM'\"\n)\n\n# Run evaluations\neval_results = run_evals(\n    dataframe=spans_df,\n    evaluators=[\n        HallucinationEvaluator(eval_model),\n        RelevanceEvaluator(eval_model)\n    ],\n    provide_explanation=True\n)\n\n# Log results back to Phoenix\nclient.log_evaluations(eval_results)\n```\n\n## Datasets and experiments\n\n### Create dataset\n\n```python\nfrom phoenix import Client\n\nclient = Client()\n\n# Create dataset\ndataset = client.create_dataset(\n    name=\"qa-test-set\",\n    description=\"QA evaluation dataset\"\n)\n\n# Add examples\nclient.add_examples_to_dataset(\n    dataset_name=\"qa-test-set\",\n    examples=[\n        {\n            \"input\": {\"question\": \"What is Python?\"},\n            \"output\": {\"answer\": \"A programming language\"}\n        },\n        {\n            \"input\": {\"question\": \"What is ML?\"},\n            \"output\": {\"answer\": \"Machine learning\"}\n        }\n    ]\n)\n```\n\n### Run experiment\n\n```python\nfrom phoenix import Client\nfrom phoenix.experiments import run_experiment\n\nclient = Client()\n\ndef my_model(input_data):\n    \"\"\"Your model function.\"\"\"\n    question = input_data[\"question\"]\n    return {\"answer\": generate_answer(question)}\n\ndef accuracy_evaluator(input_data, output, expected):\n    \"\"\"Custom evaluator.\"\"\"\n    return {\n        \"score\": 1.0 if expected[\"answer\"].lower() in output[\"answer\"].lower() else 0.0,\n        \"label\": \"correct\" if expected[\"answer\"].lower() in output[\"answer\"].lower() else \"incorrect\"\n    }\n\n# Run experiment\nresults = run_experiment(\n    dataset_name=\"qa-test-set\",\n    task=my_model,\n    evaluators=[accuracy_evaluator],\n    experiment_name=\"baseline-v1\"\n)\n\nprint(f\"Average accuracy: {results.aggregate_metrics['accuracy']}\")\n```\n\n## Client API\n\n### Query traces and spans\n\n```python\nfrom phoenix import Client\n\nclient = Client(endpoint=\"http:\u002F\u002Flocalhost:6006\")\n\n# Get spans as DataFrame\nspans_df = client.get_spans_dataframe(\n    project_name=\"my-app\",\n    filter_condition=\"span_kind == 'LLM'\",\n    limit=1000\n)\n\n# Get specific span\nspan = client.get_span(span_id=\"abc123\")\n\n# Get trace\ntrace = client.get_trace(trace_id=\"xyz789\")\n```\n\n### Log feedback\n\n```python\nfrom phoenix import Client\n\nclient = Client()\n\n# Log user feedback\nclient.log_annotation(\n    span_id=\"abc123\",\n    name=\"user_rating\",\n    annotator_kind=\"HUMAN\",\n    score=0.8,\n    label=\"helpful\",\n    metadata={\"comment\": \"Good response\"}\n)\n```\n\n### Export data\n\n```python\n# Export to pandas\ndf = client.get_spans_dataframe(project_name=\"my-app\")\n\n# Export traces\ntraces = client.list_traces(project_name=\"my-app\")\n```\n\n## Production deployment\n\n### Docker\n\n```bash\ndocker run -p 6006:6006 arizephoenix\u002Fphoenix:latest\n```\n\n### With PostgreSQL\n\n```bash\n# Set database URL\nexport PHOENIX_SQL_DATABASE_URL=\"postgresql:\u002F\u002Fuser:pass@host:5432\u002Fphoenix\"\n\n# Start server\nphoenix serve --host 0.0.0.0 --port 6006\n```\n\n### Environment variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PHOENIX_PORT` | HTTP server port | `6006` |\n| `PHOENIX_HOST` | Server bind address | `127.0.0.1` |\n| `PHOENIX_GRPC_PORT` | gRPC\u002FOTLP port | `4317` |\n| `PHOENIX_SQL_DATABASE_URL` | Database connection | SQLite temp |\n| `PHOENIX_WORKING_DIR` | Data storage directory | OS temp |\n| `PHOENIX_ENABLE_AUTH` | Enable authentication | `false` |\n| `PHOENIX_SECRET` | JWT signing secret | Required if auth enabled |\n\n### With authentication\n\n```bash\nexport PHOENIX_ENABLE_AUTH=true\nexport PHOENIX_SECRET=\"your-secret-key-min-32-chars\"\nexport PHOENIX_ADMIN_SECRET=\"admin-bootstrap-token\"\n\nphoenix serve\n```\n\n## Best practices\n\n1. **Use projects**: Separate traces by environment (dev\u002Fstaging\u002Fprod)\n2. **Add metadata**: Include user IDs, session IDs for debugging\n3. **Evaluate regularly**: Run automated evaluations in CI\u002FCD\n4. **Version datasets**: Track test set changes over time\n5. **Monitor costs**: Track token usage via Phoenix dashboards\n6. **Self-host**: Use PostgreSQL for production deployments\n\n## Common issues\n\n**Traces not appearing:**\n```python\nfrom phoenix.otel import register\n\n# Verify endpoint\ntracer_provider = register(\n    project_name=\"my-app\",\n    endpoint=\"http:\u002F\u002Flocalhost:6006\u002Fv1\u002Ftraces\"  # Correct endpoint\n)\n\n# Force flush\nfrom opentelemetry import trace\ntrace.get_tracer_provider().force_flush()\n```\n\n**High memory in notebook:**\n```python\n# Close session when done\nsession = px.launch_app()\n# ... do work ...\nsession.close()\npx.close_app()\n```\n\n**Database connection issues:**\n```bash\n# Verify PostgreSQL connection\npsql $PHOENIX_SQL_DATABASE_URL -c \"SELECT 1\"\n\n# Check Phoenix logs\nphoenix serve --log-level debug\n```\n\n## References\n\n- **[Advanced Usage](references\u002Fadvanced-usage.md)** - Custom evaluators, experiments, production setup\n- **[Troubleshooting](references\u002Ftroubleshooting.md)** - Common issues, debugging, performance\n\n## Resources\n\n- **Documentation**: https:\u002F\u002Fdocs.arize.com\u002Fphoenix\n- **Repository**: https:\u002F\u002Fgithub.com\u002FArize-ai\u002Fphoenix\n- **Docker Hub**: https:\u002F\u002Fhub.docker.com\u002Fr\u002Farizephoenix\u002Fphoenix\n- **Version**: 12.0.0+\n- **License**: Apache 2.0\n",{"name":5,"tags":24,"author":33,"license":15,"version":34,"description":7,"dependencies":35},[25,26,27,28,29,30,31,32],"Observability","Phoenix","Arize","Tracing","Evaluation","Monitoring","LLM Ops","OpenTelemetry","Orchestra Research","1.0.0",[36],"arize-phoenix>=12.0.0","main","1e72c52e0f3ffd72fbc6ba994fda0f4a6d63911a","payloads\u002Fskills\u002Fobservability-phoenix","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai","2026-11-14 20:35:25",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add origin-labs-ai\u002Fcode --skill observability-phoenix",{"tool":49,"command":50},"bunx","bunx skills add origin-labs-ai\u002Fcode --skill observability-phoenix",{"tool":52,"command":53},"pnpm","pnpm dlx skills add origin-labs-ai\u002Fcode --skill observability-phoenix","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fpayloads\u002Fskills\u002Fobservability-phoenix\u002FSKILL.md",true,[57,63],{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Fadvanced-usage.md","REFERENCE","参考文档",15277,"https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fpayloads\u002Fskills\u002Fobservability-phoenix\u002Freferences\u002Fadvanced-usage.md",{"path":64,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Ftroubleshooting.md",10944,"https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fpayloads\u002Fskills\u002Fobservability-phoenix\u002Freferences\u002Ftroubleshooting.md",[68,76,84,92,100,109],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":72,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7BP6Z7NBQXMB8Y5ZRR7PGCF","web-search","Implement web search capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to search for real-time information from the web, retrieve up-to-date content beyond the knowledge cutoff, or find the latest news and data. Returns structured search results with URLs, snippets, and metadata.","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fweb-search\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fweb-search\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":80,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7BP6T13CWYHZSHGYG0RT885","web-reader","Implement web page content extraction capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to scrape web pages, extract article content, retrieve page metadata, or build applications that process web content. Supports automatic content extraction with title, HTML, and publication time retrieval.","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fweb-reader\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fweb-reader\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7BP6GM9Z301PPT4ZRV049AN","video-understand","Implement specialized video understanding capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze video content, understand motion and temporal sequences, extract information from video frames, describe video scenes, or perform video-based AI analysis. Optimized for MP4, AVI, MOV, and other common video formats.","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fvideo-understand\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fvideo-understand\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7BP6ANRHQ1K7PVS11RBZCC7","Video Generation","Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fvideo-generation\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fvideo-generation\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":104,"licenseFileUrl":105,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7BP56W5SX2MMJWKMJVC66F0","skill-creator","Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fskill-creator\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":104,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M7BP503HPG0DBCN4K0JKCA88","seo-content-writer","Use when the user asks to \"write SEO content\", \"create a blog post\", \"write an article\", \"content writing\", \"draft optimized content\", \"write me an article\", \"create a blog post about\", \"help me write SEO content\", or \"draft content for\". Creates high-quality, SEO-optimized content that ranks in search engines. Applies on-page SEO best practices, keyword optimization, and content structure for maximum visibility and engagement. For AI citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.","https:\u002F\u002Fgithub.com\u002Forigin-labs-ai\u002Fcode\u002Fblob\u002Fmain\u002Fwindows\u002Fsonar\u002Fmerger\u002Fcode-fusion-dead-20261101\u002Fskills\u002Fseo-content-writer\u002FSKILL.md",[],[]]