[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FCQMEVPCS2E1AA3K04C3RZ":3,"skill-same:01M7FCQMEVPCS2E1AA3K04C3RZ":69},{"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":40,"repositoryHtmlUrl":41,"repositoryHomepageUrl":6,"ownerHtmlUrl":42,"ownerBlogUrl":6,"ownerDescription":43,"updatedAt":44,"install":45,"resources":58},"01M7FCQMEVPCS2E1AA3K04C3RZ","phoenix-observability",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.","CZX-LBJ\u002Fdeepseek-science","CZX-LBJ","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F204594689?v=4","01M7FC59WQ9PFXT04MKGJDCFFT","czx","01M7FC59XB2GW0BKWN9JTDBQS7",1,"MIT","https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Fai-research-skills\u002F17-observability\u002Fphoenix\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: phoenix-observability\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","18193d71ea3441d7c033dbf195b8a7c75ac96f75","packages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Fai-research-skills\u002F17-observability\u002Fphoenix",0,"https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science","https:\u002F\u002Fgithub.com\u002FCZX-LBJ","一个没事喜欢随便写点代码的小菜鸡\r\n","2026-10-22 09:48:04",{"source":8,"skillName":5,"commands":46,"prompt":56,"zipAvailable":57},[47,50,53],{"tool":48,"command":49},"npx","npx skills add CZX-LBJ\u002Fdeepseek-science --skill phoenix-observability",{"tool":51,"command":52},"bunx","bunx skills add CZX-LBJ\u002Fdeepseek-science --skill phoenix-observability",{"tool":54,"command":55},"pnpm","pnpm dlx skills add CZX-LBJ\u002Fdeepseek-science --skill phoenix-observability","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Fai-research-skills\u002F17-observability\u002Fphoenix\u002FSKILL.md",true,[59,65],{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fadvanced-usage.md","REFERENCE","参考文档",15277,"https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Fai-research-skills\u002F17-observability\u002Fphoenix\u002Freferences\u002Fadvanced-usage.md",{"path":66,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Ftroubleshooting.md",10944,"https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Fai-research-skills\u002F17-observability\u002Fphoenix\u002Freferences\u002Ftroubleshooting.md",[70,77,84,91,98,105],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7FEEKSNMRMKW6JEK93PFDFY","bio-free-energy-calculations","Performs alchemical free-energy calculations including relative binding free energy (RBFE \u002F FEP+) and absolute binding free energy (ABFE) via OpenFE, FEP+, GROMACS, AMBER pmemd, and OpenMM with explicit lambda scheduling, soft-core potentials, MBAR\u002FBAR analysis, cycle-closure validation, and protocol-appropriate enhanced sampling. Compares ML alternatives (Boltz-2 affinity, DeepDock). Use when ranking analogs by binding affinity beyond docking accuracy, performing prospective lead optimization, or validating SAR predictions.","https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Fbioskills\u002Fchemoinformatics\u002Ffree-energy-calculations\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7FEE5CTE5QK55CEMXNNVWY9","bio-conformer-generation","Generates 3D conformer ensembles using RDKit ETKDGv3 with knowledge-enhanced distance geometry, MMFF94\u002FUFF force-field optimization, CREST + GFN2-xTB semi-empirical refinement, and macrocycle-aware torsion preferences. Provides explicit decision rules for single vs ensemble conformer use, RMSD pruning, energy windows, conformer count, and force-field choice. Use when preparing 3D ligands for docking, generating descriptor input for 3D QSAR, or sampling macrocycle\u002Fpeptide conformational ensembles.","https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Fbioskills\u002Fchemoinformatics\u002Fconformer-generation\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":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7FEDNGFEMFWD1MSEDR5H7CY","bio-admet-prediction","Predicts ADMET properties using ADMETlab 3.0 (119 platform features, including 77 prediction models with modeled-endpoint uncertainty), ADMET-AI, DeepChem MolNet, and chemprop D-MPNN with explicit handling of OECD QSAR principles, applicability domain assessment, calibration, hERG\u002FCYP\u002FAMES endpoints, and PAINS \u002F Lipinski \u002F Ro5 \u002F Veber \u002F BBB druglikeness filters. Use when filtering compounds for drug-likeness, prioritizing leads by predicted safety, or building an in-house ADMET QSAR model.","https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Fbioskills\u002Fchemoinformatics\u002Fadmet-prediction\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M7FED69GFB54FRF7AV5066DN","writing-systems-papers","Paragraph-level structural blueprint for 10-12 page systems papers targeting OSDI, SOSP, ASPLOS, NSDI, and EuroSys. Provides page allocation, paragraph templates, and writing patterns. Use when user says \"写系统论文\", \"systems paper structure\", \"OSDI paper\", \"SOSP paper\", or wants fine-grained structural guidance for a systems conference submission.","https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Faris\u002Fskills\u002Fwriting-systems-papers\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M7FECVVDWZ0X0VEDTCE4B4DZ","wiki-enrich","Fill in the per-paper TODO sections of research-wiki\u002Fpapers\u002F\u003Cslug>.md pages that literature-ingest skills leave as bare scaffolds. Use when user says 'enrich wiki', 'fill paper TODOs', 'wiki body 補完', '把 paper 摘要寫進 wiki', 'research-wiki 自動填', or after a batch ingest that left papers\u002F as TODO scaffolds.","https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Faris\u002Fskills\u002Fwiki-enrich\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M7FECD4BCJ2MTSBDDSE3ZAJ5","web-debug-search","Search GitHub, Stack Exchange, Chinese technical communities, official documentation, and general developer web sources for software errors, compatibility problems, API usage questions, and real-world workarounds. Use for debugging and discovery only; results are not paper-citation evidence.","https:\u002F\u002Fgithub.com\u002FCZX-LBJ\u002Fdeepseek-science\u002Fblob\u002Fmain\u002Fpackages\u002Fskill\u002Fskill-science\u002Fassets\u002Fsources\u002Faris\u002Fskills\u002Fweb-debug-search\u002FSKILL.md",[],[]]