arize-phoenix 10.11.0__py3-none-any.whl → 10.13.0__py3-none-any.whl

{arize_phoenix-10.11.0.dist-info → arize_phoenix-10.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arize-phoenix
-Version: 10.11.0
+Version: 10.13.0
 Summary: AI Observability and Evaluation
 Project-URL: Documentation, https://arize.com/docs/phoenix/
 Project-URL: Issues, https://github.com/Arize-ai/phoenix/issues

{arize_phoenix-10.11.0.dist-info → arize_phoenix-10.13.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
 phoenix/__init__.py,sha256=xkpXH76HFbEDCq8IhiFp-2GnEHx39xPMdOpV5Skew1w,5481
 phoenix/auth.py,sha256=yW78f1xWNjTE30ACGUM14nOd5BzkukhlzA9B45kSUkM,11053
-phoenix/config.py,sha256=zgir90pfb2aAqPm-scG73B30Z-1UppSrxKCPAuGtLbM,57004
+phoenix/config.py,sha256=1K086wVZDsu8GC1qwk3EBe2Uuw0ZSAhiZhI62PlspaU,57463
 phoenix/datetime_utils.py,sha256=iJzNG6YJ6V7_u8B2iA7P2Z26FyxYbOPtx0dhJ7kNDHA,3398
 phoenix/exceptions.py,sha256=n2L2KKuecrdflB9MsCdAYCiSEvGJptIsfRkXMoJle7A,169
 phoenix/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 phoenix/services.py,sha256=ngkyKGVatX3cO2WJdo2hKdaVKP-xJCMvqthvga6kJss,5196
-phoenix/settings.py,sha256=x87BX7hWGQQZbrW_vrYqFR_izCGfO9gFc--JXUG4Tdk,754
-phoenix/version.py,sha256=QlkUWf1vZWZO1B4-0PjOW339CFFq5tlWz3teIz9l6-E,24
+phoenix/settings.py,sha256=2kHfT3BNOVd4dAO1bq-syEQbHSG8oX2-7NhOwK2QREk,896
+phoenix/version.py,sha256=ZCckrFpi-O_8Vaq7PPbDoo6WhScFhLb8iXD_3Rb_SpY,24
 phoenix/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/core/embedding_dimension.py,sha256=zKGbcvwOXgLf-yrJBpQyKtd-LEOPRKHnUToyAU8Owis,87
 phoenix/core/model.py,sha256=qBFraOtmwCCnWJltKNP18DDG0mULXigytlFsa6YOz6k,4837
@@ -89,14 +89,14 @@ phoenix/pointcloud/pointcloud.py,sha256=SN_1wXZcwKrtSnHGZLDZGx71orqE1WyVF7E-D58d
 phoenix/pointcloud/projectors.py,sha256=TQgwc9cJDjJkin1WZyZzgl3HsYrLLiyWD7Czy4jNW3U,1088
 phoenix/pointcloud/umap_parameters.py,sha256=db_WEPoamuWtopZx7tQfAXPnoE0MS8FkAV0_ThjEx_Q,1735
 phoenix/server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/app.py,sha256=1N7OWYQ3obWhdb_Qbrg8mSuexvNk_oT1Taq8smfmMiU,41265
+phoenix/server/app.py,sha256=PFXCs_lGUr_LxLktje4dYI3TZmw8VC3KgXzZexfVQ8Q,41497
 phoenix/server/authorization.py,sha256=fofeRwuoodCUB3DQYPCuAgIyeiwopXW0tkH_KZvU0Rg,1848
 phoenix/server/bearer_auth.py,sha256=b2iHV2nwvWlZJ2O_nWOzHctJ0aUrEIOygIDrO7VOCSw,6700
 phoenix/server/dml_event.py,sha256=MjJmVEKytq75chBOSyvYDusUnEbg1pHpIjR3pZkUaJA,2838
 phoenix/server/dml_event_handler.py,sha256=EZLXmCvx4pJrCkz29gxwKwmvmUkTtPCHw6klR-XM8qE,8258
 phoenix/server/grpc_server.py,sha256=dod29zE_Zlir7NyLcdVM8GH3P8sy-9ykzfaBfVifyE4,4656
 phoenix/server/jwt_store.py,sha256=B6uVildN_dQDTG_-aHHvuVSI7wIVK1yvED-_y6se2GU,16905
-phoenix/server/main.py,sha256=ZL9cCqhaawTWOr6DIs6x09QjZ2xDk-jdoiyJcrjJFMc,18294
+phoenix/server/main.py,sha256=j00TIU7QYOIXaJW9EpqsjEACKtwtSy70s0zWdwfuPw0,18436
 phoenix/server/oauth2.py,sha256=GvUqZBoZ5dG-l2G1RMl1SUcN10jNAjaMXFznMSWz2Zs,3336
 phoenix/server/prometheus.py,sha256=1KjvSfjSa2-BPjDybVMM_Kag316CsN-Zwt64YNr_snc,7825
 phoenix/server/rate_limiters.py,sha256=cFc73D2NaxqNZZDbwfIDw4So-fRVOJPBtqxOZ8Qky_s,7155
@@ -110,7 +110,7 @@ phoenix/server/api/auth.py,sha256=cvKH2FQLL7PasiqZMHgu9P4qchhEG7a7P9Nxy35FoIQ,15
 phoenix/server/api/context.py,sha256=oxNmVIIyycl22iQZjv59lU1inwlo-Povxe2Ok7t54mw,6954
 phoenix/server/api/exceptions.py,sha256=TA0JuY2YRnj35qGuMSQ8d0ToHum9gWm9W--3fSKHrX0,1171
 phoenix/server/api/interceptor.py,sha256=ykDnoC_apUd-llVli3m1CW18kNSIgjz2qZ6m5JmPDu8,1294
-phoenix/server/api/queries.py,sha256=_Ae8W6Y9O3_6gFdWjwVXIiX2kVvN8Ev_VcIQgO4x_88,41278
+phoenix/server/api/queries.py,sha256=J2OU59r6Jq5zs4fFl_nawj56dcBXH8iz5Ze_02YjVog,41606
 phoenix/server/api/schema.py,sha256=fcs36xQwFF_Qe41_5cWR8wYpDvOrnbcyTeo5WNMbDsA,1702
 phoenix/server/api/subscriptions.py,sha256=73s6TzwI2M_bjIZDYwgohdI_13iv7pgpLCvZYNuExnw,23777
 phoenix/server/api/utils.py,sha256=quCBRcusc6PUq9tJq7M8PgwFZp7nXgVAxtbw8feribY,833
@@ -158,7 +158,7 @@ phoenix/server/api/helpers/__init__.py,sha256=m2-xaSPqUiSs91k62JaRDjFNfl-1byxBfY
 phoenix/server/api/helpers/annotations.py,sha256=9gMXKpMTfWEChoSCnvdWYuyB0hlSnNOp-qUdar9Vono,262
 phoenix/server/api/helpers/dataset_helpers.py,sha256=DoMBTg-qXTnC_K4Evx1WKpCCYgRbITpVqyY-8efJRf0,8984
 phoenix/server/api/helpers/experiment_run_filters.py,sha256=DOnVwrmn39eAkk2mwuZP8kIcAnR5jrOgllEwWSjsw94,29893
-phoenix/server/api/helpers/playground_clients.py,sha256=ycvccG8bzwtIeU0LQpR6IMOn3B3DftmCwqfuYYZ7YYM,47957
+phoenix/server/api/helpers/playground_clients.py,sha256=laFDXVnj-n5-nze5OeJSLT5nwdz2IWFTVccKNcLqK7U,47932
 phoenix/server/api/helpers/playground_registry.py,sha256=CPLMziFB2wmr-dfbx7VbzO2f8YIG_k5RftzvGXYGQ1w,2570
 phoenix/server/api/helpers/playground_spans.py,sha256=QpXwPl_fFNwm_iA1A77XApUyXMl1aDmonw8aXuNZ_4k,17132
 phoenix/server/api/helpers/prompts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -242,7 +242,7 @@ phoenix/server/api/routers/v1/experiments.py,sha256=V9_sxqLTE1MKGFu9H3FEdGKr70lY
 phoenix/server/api/routers/v1/models.py,sha256=p3gJN-9SWiUYTUTft4bZMsZVCBNTb4nN1Foy68eRZzQ,1997
 phoenix/server/api/routers/v1/projects.py,sha256=LFWxHYPRZy-1EvroNylL635vU1UuDbcuRo1oD26yBnw,12551
 phoenix/server/api/routers/v1/prompts.py,sha256=aBOUBwLDzZDIzJQkxJcR8ZKnakNJOLMwzsLKINSs1mA,26545
-phoenix/server/api/routers/v1/spans.py,sha256=MxZ9RvZqc8JGgcDAgH_S9rTc9YfXOEF_j9kqBf3z4qY,38379
+phoenix/server/api/routers/v1/spans.py,sha256=HhZtXsNTdOmMXWtMkz3VUb3aqpGsVAU5XOYi2KfvGMc,44106
 phoenix/server/api/routers/v1/traces.py,sha256=DfzeszQvtlrVxvurJLaWJJAhkCZ4BodLwpFuBYPwN5Q,8206
 phoenix/server/api/routers/v1/users.py,sha256=ZcW3if0L8-lUusTzET7fhlhvnmiCICDrGimzB7i3irc,11947
 phoenix/server/api/routers/v1/utils.py,sha256=oXIOGPzPTkE0ZWUTRCoRIQQ7wTzoSwtWFaUSjlGBqts,4960
@@ -295,7 +295,7 @@ phoenix/server/api/types/MimeType.py,sha256=Zpi6zCalkSFgsvhzvOs-O1gYA04usAi9H__Q
 phoenix/server/api/types/Model.py,sha256=8UIFqMe1q-2ufBNg-gxHusV8wM1h-KbfLUeJjyVcMvQ,8081
 phoenix/server/api/types/NumericRange.py,sha256=afEjgF97Go_OvmjMggbPBt-zGM8IONewAyEiKEHRds0,192
 phoenix/server/api/types/PerformanceMetric.py,sha256=KFkmJDqP43eDUtARQOUqR7NYcxvL6Vh2uisHWU6H3ko,387
-phoenix/server/api/types/Project.py,sha256=akRLgsKHboF1bBLByopizfr1hqErvUIjG205iOVK1bg,29155
+phoenix/server/api/types/Project.py,sha256=FulRsgTWcvZEyiV3lzJ505HMa9Eq7aoQr3OkbPWH2Ws,29864
 phoenix/server/api/types/ProjectSession.py,sha256=fyfVtpUpFOTnBx8DFnH3dr7WXAssN0ooAgrQSSi7kEI,4677
 phoenix/server/api/types/ProjectTraceRetentionPolicy.py,sha256=tYy2kgalPDyuaYZr0VUHjH0YpXaiF_QOzg5yfaV_c7c,3782
 phoenix/server/api/types/Prompt.py,sha256=ccP4eq1e38xbF0afclGWLOuDpBVpNbJ3AOSRClF8yFQ,4955
@@ -350,19 +350,19 @@ phoenix/server/static/apple-touch-icon-76x76.png,sha256=CT_xT12I0u2i0WU8JzBZBuOQ
 phoenix/server/static/apple-touch-icon.png,sha256=fOfpjqGpWYbJ0eAurKsyoZP1EAs6ZVooBJ_SGk2ZkDs,3801
 phoenix/server/static/favicon.ico,sha256=bY0vvCKRftemZfPShwZtE93DiiQdaYaozkPGwNFr6H8,34494
 phoenix/server/static/modernizr.js,sha256=mvK-XtkNqjOral-QvzoqsyOMECXIMu5BQwSVN_wcU9c,2564
-phoenix/server/static/.vite/manifest.json,sha256=837OSh-IivU2fHSnxu_J0lAxevm63ybzAVP1FWmfznk,2165
-phoenix/server/static/assets/components-DGavuwFF.js,sha256=tdDtY9b8Ea0izLG8C_lurQVeumIHzgk4zGb-RlkInTU,565838
-phoenix/server/static/assets/index-DNmPxkEL.js,sha256=0TQaN2Tox98yiKfS6N6VkbJO0XpbnFUcpfZPRp5aolU,61125
-phoenix/server/static/assets/pages-Bns7xROJ.js,sha256=6q_I_rjaJi27n58102xzSN16fL7DWWZTMhxAaMQPCnQ,1054513
-phoenix/server/static/assets/vendor-ARQZvmz5.js,sha256=U_VQSuHOpuX7DxntJS2ckfxW2a4hV-E3MCqeJSxwdCY,2735976
+phoenix/server/static/.vite/manifest.json,sha256=FX0jH9ulkLFAOYFQ_fY2V_eLblREsX4bRMst-NAYskU,2165
+phoenix/server/static/assets/components-37rV35eH.js,sha256=bkm_c7mVyxDrVczT2PTykcER8YdFKEhJOWilzyoZj7c,566746
+phoenix/server/static/assets/index-CdNW7TcY.js,sha256=VUdSy0fh-bRVlI9kH5irs9iJknpeEJvE4V7C8xgq-IM,61125
+phoenix/server/static/assets/pages-BWWAYqfd.js,sha256=dVpjKI0o-nl6MgAi4HZvQwixBPWSQimxYNrKjSkkTDI,1061332
+phoenix/server/static/assets/vendor-BKYy4SMr.js,sha256=lUYFHNxWckrqWult9uTiNwc6-Qv5Bfr1IcjrHoos1oU,2735976
 phoenix/server/static/assets/vendor-WIZid84E.css,sha256=spZD2r7XL5GfLO13ln-IuXfnjAref8l6g_n_AvxxOlI,5517
-phoenix/server/static/assets/vendor-arizeai-Ct6kvW4e.js,sha256=n_v4BAgm9-OaJMlQTf0OtLfPmPBdagnu85gVuds43sM,181771
-phoenix/server/static/assets/vendor-codemirror-BxoXtD6f.js,sha256=Gcja1za7lbo8aPTmdl_GxXszEVLxofqj8QpL6Y99RIo,781264
-phoenix/server/static/assets/vendor-recharts-Cl8AO7Np.js,sha256=CGhGfasxVd1a2RK1hDy3ePvfFXGL_pnm4eCPmvjXsio,282150
-phoenix/server/static/assets/vendor-shiki-BpqODMgR.js,sha256=A-kILnWoORSTVGyjSr71swRchewgMYGmkKigXoKJ5_g,8980312
+phoenix/server/static/assets/vendor-arizeai-hGVPFFRq.js,sha256=pcKvIP_UPEeg-UJpM4DKz0bQQ1X1eIfmwz16Uu7pTY4,178469
+phoenix/server/static/assets/vendor-codemirror-BlmFw5CA.js,sha256=QODyQdDaw_c_n-qaHcjfGxzU2ECerJcAVtnaF-8L6O4,781264
+phoenix/server/static/assets/vendor-recharts-Bz7zqjbW.js,sha256=c7rl5xi-366k-e16Udyr6M_ZADAZGELnUOJrBR-1PBc,282150
+phoenix/server/static/assets/vendor-shiki-BitvudxD.js,sha256=cVscU0RuS8MzpAVyJc4N28iswI9hNRUM_9rUO0RR0ug,8980312
 phoenix/server/static/assets/vendor-three-C5WAXd5r.js,sha256=ELkg06u70N7h8oFmvqdoHyPuUf9VgGEWeT4LKFx4VWo,620975
 phoenix/server/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-phoenix/server/templates/index.html,sha256=NpJ83DULqcStXFbShNamX4_NPDtnnucuBxppvUYjJa8,4409
+phoenix/server/templates/index.html,sha256=TxaZTZKUz7-xQ3XlPO3DAPMj6S1rMEr5v6g1UmgaW70,6761
 phoenix/session/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/session/client.py,sha256=uw5WlCuFcN_eEj7Ko2bhJVcaihEIp7Evy50KnL6Sq-k,35602
 phoenix/session/data_extractor.py,sha256=Y0RzYFaNy9fQj8PEIeQ76TBZ90_E1FW7bXu3K5x0EZY,2782
@@ -400,9 +400,9 @@ phoenix/utilities/project.py,sha256=auVpARXkDb-JgeX5f2aStyFIkeKvGwN9l7qrFeJMVxI,
 phoenix/utilities/re.py,sha256=6YyUWIkv0zc2SigsxfOWIHzdpjKA_TZo2iqKq7zJKvw,2081
 phoenix/utilities/span_store.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 phoenix/utilities/template_formatters.py,sha256=gh9PJD6WEGw7TEYXfSst1UR4pWWwmjxMLrDVQ_CkpkQ,2779
-arize_phoenix-10.11.0.dist-info/METADATA,sha256=CMrCkCw3Kjk4rgC8KbjvXGUU-WMgURw4cbfXBI-f_qk,27006
-arize_phoenix-10.11.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-arize_phoenix-10.11.0.dist-info/entry_points.txt,sha256=Pgpn8Upxx9P8z8joPXZWl2LlnAlGc3gcQoVchb06X1Q,94
-arize_phoenix-10.11.0.dist-info/licenses/IP_NOTICE,sha256=JBqyyCYYxGDfzQ0TtsQgjts41IJoa-hiwDrBjCb9gHM,469
-arize_phoenix-10.11.0.dist-info/licenses/LICENSE,sha256=HFkW9REuMOkvKRACuwLPT0hRydHb3zNg-fdFt94td18,3794
-arize_phoenix-10.11.0.dist-info/RECORD,,
+arize_phoenix-10.13.0.dist-info/METADATA,sha256=-62CQ8KNaGaN5BH9v0396cVRQ0hiBNE1ZYq6YUJ5jFM,27006
+arize_phoenix-10.13.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+arize_phoenix-10.13.0.dist-info/entry_points.txt,sha256=Pgpn8Upxx9P8z8joPXZWl2LlnAlGc3gcQoVchb06X1Q,94
+arize_phoenix-10.13.0.dist-info/licenses/IP_NOTICE,sha256=JBqyyCYYxGDfzQ0TtsQgjts41IJoa-hiwDrBjCb9gHM,469
+arize_phoenix-10.13.0.dist-info/licenses/LICENSE,sha256=HFkW9REuMOkvKRACuwLPT0hRydHb3zNg-fdFt94td18,3794
+arize_phoenix-10.13.0.dist-info/RECORD,,

phoenix/config.py

@@ -50,6 +50,11 @@ ENV_PHOENIX_PROJECT_NAME = "PHOENIX_PROJECT_NAME"
 """
 The project name to use when logging traces and evals. defaults to 'default'.
 """
+ENV_PHOENIX_FULLSTORY_ORG = "PHOENIX_FULLSTORY_ORG"
+"""
+The FullStory organization ID for web analytics tracking. When set, FullStory tracking
+will be enabled in the Phoenix web interface.
+"""
 ENV_PHOENIX_SQL_DATABASE_URL = "PHOENIX_SQL_DATABASE_URL"
 """
 The SQL database URL to use when logging traces and evals.
@@ -1520,6 +1525,16 @@ def get_env_allowed_origins() -> Optional[list[str]]:
     return allowed_origins.split(",")
 
 
+def get_env_fullstory_org() -> Optional[str]:
+    """
+    Get the FullStory organization ID from environment variables.
+
+    Returns:
+        Optional[str]: The FullStory organization ID if set, None otherwise.
+    """
+    return getenv(ENV_PHOENIX_FULLSTORY_ORG)
+
+
 def verify_server_environment_variables() -> None:
     """Verify that the environment variables are set correctly. Raises an error otherwise."""
     get_env_root_url()

phoenix/server/api/helpers/playground_clients.py

@@ -359,7 +359,6 @@ class OpenAIBaseStreamingClient(PlaygroundStreamingClient):
         ):
             if (usage := chunk.usage) is not None:
                 token_usage = usage
-                continue
             if not chunk.choices:
                 # for Azure, initial chunk contains the content filter
                 continue

phoenix/server/api/queries.py

@@ -319,6 +319,16 @@ class Query:
         after: Optional[CursorString] = UNSET,
         filter_condition: Optional[str] = UNSET,
     ) -> Connection[ExperimentComparison]:
+        # Handle empty experiment_ids gracefully
+        if not experiment_ids:
+            return connection_from_list(
+                data=[],
+                args=ConnectionArgs(
+                    first=first,
+                    after=after if isinstance(after, CursorString) else None,
+                ),
+            )
+
         experiment_ids_ = [
             from_global_id_with_expected_type(experiment_id, OrmExperiment.__name__)
             for experiment_id in experiment_ids

phoenix/server/api/routers/v1/spans.py

@@ -1,3 +1,4 @@
+import json
 import warnings
 from asyncio import get_running_loop
 from collections.abc import AsyncIterator
@@ -12,7 +13,12 @@ from pydantic import BaseModel, Field
 from sqlalchemy import select
 from starlette.requests import Request
 from starlette.responses import Response, StreamingResponse
-from starlette.status import HTTP_404_NOT_FOUND, HTTP_422_UNPROCESSABLE_ENTITY
+from starlette.status import (
+    HTTP_202_ACCEPTED,
+    HTTP_400_BAD_REQUEST,
+    HTTP_404_NOT_FOUND,
+    HTTP_422_UNPROCESSABLE_ENTITY,
+)
 from strawberry.relay import GlobalID
 
 from phoenix.config import DEFAULT_PROJECT_NAME
@@ -26,6 +32,19 @@ from phoenix.server.bearer_auth import PhoenixUser
 from phoenix.server.dml_event import SpanAnnotationInsertEvent
 from phoenix.trace.attributes import flatten
 from phoenix.trace.dsl import SpanQuery as SpanQuery_
+from phoenix.trace.schemas import (
+    Span as SpanForInsertion,
+)
+from phoenix.trace.schemas import (
+    SpanContext as InsertionSpanContext,
+)
+from phoenix.trace.schemas import (
+    SpanEvent as InternalSpanEvent,
+)
+from phoenix.trace.schemas import (
+    SpanKind,
+    SpanStatusCode,
+)
 from phoenix.utilities.json import encode_df_as_json_string
 
 from .models import V1RoutesBaseModel
@@ -393,7 +412,9 @@ class SpanEvent(V1RoutesBaseModel):
 
 
 class Span(V1RoutesBaseModel):
-    id: str = Field(description="Span Global ID, distinct from the OpenTelemetry span ID")
+    id: str = Field(
+        default="", description="Span Global ID, distinct from the OpenTelemetry span ID"
+    )
     name: str = Field(description="Name of the span operation")
     context: SpanContext = Field(description="Span context containing trace_id and span_id")
     span_kind: str = Field(description="Type of work that the span encapsulates")
@@ -440,7 +461,7 @@ async def query_spans_handler(
     )
     end_time = request_body.end_time or request_body.stop_time
     try:
-        span_queries = [SpanQuery_.from_dict(query.dict()) for query in queries]
+        span_queries = [SpanQuery_.from_dict(query.model_dump()) for query in queries]
     except Exception as e:
         raise HTTPException(
             detail=f"Invalid query: {e}",
@@ -956,3 +977,143 @@ async def annotate_spans(
             for id_ in inserted_ids
         ]
     )
+
+
+class CreateSpansRequestBody(RequestBody[list[Span]]):
+    data: list[Span]
+
+
+class CreateSpansResponseBody(V1RoutesBaseModel):
+    total_received: int = Field(description="Total number of spans received")
+    total_queued: int = Field(description="Number of spans successfully queued for insertion")
+
+
+@router.post(
+    "/projects/{project_identifier}/spans",
+    operation_id="createSpans",
+    summary="Create spans",
+    description=(
+        "Submit spans to be inserted into a project. If any spans are invalid or "
+        "duplicates, no spans will be inserted."
+    ),
+    responses=add_errors_to_responses([HTTP_404_NOT_FOUND, HTTP_400_BAD_REQUEST]),
+    status_code=HTTP_202_ACCEPTED,
+)
+async def create_spans(
+    request: Request,
+    request_body: CreateSpansRequestBody,
+    project_identifier: str = Path(
+        description=(
+            "The project identifier: either project ID or project name. If using a project name, "
+            "it cannot contain slash (/), question mark (?), or pound sign (#) characters."
+        )
+    ),
+) -> CreateSpansResponseBody:
+    def convert_api_span_for_insertion(api_span: Span) -> SpanForInsertion:
+        """
+        Convert from API Span to phoenix.trace.schemas.Span
+        Note: The 'id' field has a default empty string and is ignored during insertion.
+        """
+        try:
+            span_kind = SpanKind(api_span.span_kind.upper())
+        except ValueError:
+            span_kind = SpanKind.UNKNOWN
+
+        try:
+            status_code = SpanStatusCode(api_span.status_code.upper())
+        except ValueError:
+            status_code = SpanStatusCode.UNSET
+
+        internal_events: list[InternalSpanEvent] = []
+        for event in api_span.events:
+            if event.timestamp:
+                internal_events.append(
+                    InternalSpanEvent(
+                        name=event.name, timestamp=event.timestamp, attributes=event.attributes
+                    )
+                )
+
+        # Add back the openinference.span.kind attribute since it's stored separately in the API
+        attributes = dict(api_span.attributes)
+        attributes["openinference.span.kind"] = api_span.span_kind
+
+        # Create span for insertion - note we ignore the 'id' field as it's server-generated
+        return SpanForInsertion(
+            name=api_span.name,
+            context=InsertionSpanContext(
+                trace_id=api_span.context.trace_id, span_id=api_span.context.span_id
+            ),
+            span_kind=span_kind,
+            parent_id=api_span.parent_id,
+            start_time=api_span.start_time,
+            end_time=api_span.end_time,
+            status_code=status_code,
+            status_message=api_span.status_message,
+            attributes=attributes,
+            events=internal_events,
+            conversation=None,  # Unused
+        )
+
+    async with request.app.state.db() as session:
+        project = await _get_project_by_identifier(session, project_identifier)
+
+    total_received = len(request_body.data)
+    duplicate_spans: list[dict[str, str]] = []
+    invalid_spans: list[dict[str, str]] = []
+    spans_to_queue: list[tuple[SpanForInsertion, str]] = []
+
+    existing_span_ids: set[str] = set()
+    span_ids = [span.context.span_id for span in request_body.data]
+    async with request.app.state.db() as session:
+        existing_result = await session.execute(
+            select(models.Span.span_id).where(models.Span.span_id.in_(span_ids))
+        )
+        existing_span_ids = {row[0] for row in existing_result}
+
+    for api_span in request_body.data:
+        # Check if it's a duplicate
+        if api_span.context.span_id in existing_span_ids:
+            duplicate_spans.append(
+                {
+                    "span_id": api_span.context.span_id,
+                    "trace_id": api_span.context.trace_id,
+                }
+            )
+            continue
+
+        try:
+            span_for_insertion = convert_api_span_for_insertion(api_span)
+            spans_to_queue.append((span_for_insertion, project.name))
+        except Exception as e:
+            invalid_spans.append(
+                {
+                    "span_id": api_span.context.span_id,
+                    "trace_id": api_span.context.trace_id,
+                    "error": str(e),
+                }
+            )
+
+    # If there are any duplicates or invalid spans, reject the entire request
+    if duplicate_spans or invalid_spans:
+        error_detail = {
+            "error": "Request contains invalid or duplicate spans",
+            "total_received": total_received,
+            "total_queued": 0,  # No spans are queued when there are validation errors
+            "total_duplicates": len(duplicate_spans),
+            "total_invalid": len(invalid_spans),
+            "duplicate_spans": duplicate_spans,
+            "invalid_spans": invalid_spans,
+        }
+        raise HTTPException(
+            status_code=HTTP_400_BAD_REQUEST,
+            detail=json.dumps(error_detail),
+        )
+
+    # All spans are valid, queue them all
+    for span_for_insertion, project_name in spans_to_queue:
+        await request.state.queue_span_for_bulk_insert(span_for_insertion, project_name)
+
+    return CreateSpansResponseBody(
+        total_received=total_received,
+        total_queued=len(spans_to_queue),
+    )

phoenix/server/api/types/Project.py

@@ -326,8 +326,27 @@ class Project(Node):
         after: Optional[CursorString] = UNSET,
         sort: Optional[ProjectSessionSort] = UNSET,
         filter_io_substring: Optional[str] = UNSET,
+        session_id: Optional[str] = UNSET,
     ) -> Connection[ProjectSession]:
         table = models.ProjectSession
+        if session_id:
+            async with info.context.db() as session:
+                ans = await session.scalar(
+                    select(table).filter_by(
+                        session_id=session_id,
+                        project_id=self.project_rowid,
+                    )
+                )
+            if ans:
+                return connection_from_list(
+                    data=[to_gql_project_session(ans)],
+                    args=ConnectionArgs(),
+                )
+            elif not filter_io_substring:
+                return connection_from_list(
+                    data=[],
+                    args=ConnectionArgs(),
+                )
         stmt = select(table).filter_by(project_id=self.project_rowid)
         if time_range:
             if time_range.start:

phoenix/server/app.py

@@ -214,6 +214,8 @@ class AppConfig(NamedTuple):
     oauth2_idps: Sequence[OAuth2Idp]
     basic_auth_disabled: bool = False
     auto_login_idp_name: Optional[str] = None
+    fullstory_org: Optional[str] = None
+    """ FullStory organization ID for web analytics tracking """
 
 
 class Static(StaticFiles):
@@ -279,6 +281,7 @@ class Static(StaticFiles):
                     "oauth2_idps": self._app_config.oauth2_idps,
                     "basic_auth_disabled": self._app_config.basic_auth_disabled,
                     "auto_login_idp_name": self._app_config.auto_login_idp_name,
+                    "fullstory_org": self._app_config.fullstory_org,
                 },
             )
         except Exception as e:
@@ -964,6 +967,7 @@ def create_app(
                     oauth2_idps=oauth2_idps,
                     basic_auth_disabled=basic_auth_disabled,
                     auto_login_idp_name=auto_login_idp_name,
+                    fullstory_org=Settings.fullstory_org,
                 ),
             ),
             name="static",

phoenix/server/main.py

@@ -25,6 +25,7 @@ from phoenix.config import (
     get_env_db_logging_level,
     get_env_disable_migrations,
     get_env_enable_prometheus,
+    get_env_fullstory_org,
     get_env_grpc_port,
     get_env_host,
     get_env_host_root_path,
@@ -484,11 +485,13 @@ def main() -> None:
 
 
 def initialize_settings() -> None:
+    """Initialize the settings from environment variables."""
     Settings.logging_mode = get_env_logging_mode()
     Settings.logging_level = get_env_logging_level()
     Settings.db_logging_level = get_env_db_logging_level()
     Settings.log_migrations = get_env_log_migrations()
     Settings.disable_migrations = get_env_disable_migrations()
+    Settings.fullstory_org = get_env_fullstory_org()
 
 
 if __name__ == "__main__":

phoenix/server/static/.vite/manifest.json

@@ -1,28 +1,28 @@
 {
-  "_components-DGavuwFF.js": {
-    "file": "assets/components-DGavuwFF.js",
+  "_components-37rV35eH.js": {
+    "file": "assets/components-37rV35eH.js",
     "name": "components",
     "imports": [
-      "_vendor-ARQZvmz5.js",
-      "_pages-Bns7xROJ.js",
-      "_vendor-arizeai-Ct6kvW4e.js",
-      "_vendor-codemirror-BxoXtD6f.js",
+      "_vendor-BKYy4SMr.js",
+      "_pages-BWWAYqfd.js",
+      "_vendor-arizeai-hGVPFFRq.js",
+      "_vendor-codemirror-BlmFw5CA.js",
       "_vendor-three-C5WAXd5r.js"
     ]
   },
-  "_pages-Bns7xROJ.js": {
-    "file": "assets/pages-Bns7xROJ.js",
+  "_pages-BWWAYqfd.js": {
+    "file": "assets/pages-BWWAYqfd.js",
     "name": "pages",
     "imports": [
-      "_vendor-ARQZvmz5.js",
-      "_vendor-arizeai-Ct6kvW4e.js",
-      "_components-DGavuwFF.js",
-      "_vendor-codemirror-BxoXtD6f.js",
-      "_vendor-recharts-Cl8AO7Np.js"
+      "_vendor-BKYy4SMr.js",
+      "_vendor-arizeai-hGVPFFRq.js",
+      "_components-37rV35eH.js",
+      "_vendor-codemirror-BlmFw5CA.js",
+      "_vendor-recharts-Bz7zqjbW.js"
     ]
   },
-  "_vendor-ARQZvmz5.js": {
-    "file": "assets/vendor-ARQZvmz5.js",
+  "_vendor-BKYy4SMr.js": {
+    "file": "assets/vendor-BKYy4SMr.js",
     "name": "vendor",
     "imports": [
       "_vendor-three-C5WAXd5r.js"
@@ -35,33 +35,33 @@
     "file": "assets/vendor-WIZid84E.css",
     "src": "_vendor-WIZid84E.css"
   },
-  "_vendor-arizeai-Ct6kvW4e.js": {
-    "file": "assets/vendor-arizeai-Ct6kvW4e.js",
+  "_vendor-arizeai-hGVPFFRq.js": {
+    "file": "assets/vendor-arizeai-hGVPFFRq.js",
     "name": "vendor-arizeai",
     "imports": [
-      "_vendor-ARQZvmz5.js"
+      "_vendor-BKYy4SMr.js"
     ]
   },
-  "_vendor-codemirror-BxoXtD6f.js": {
-    "file": "assets/vendor-codemirror-BxoXtD6f.js",
+  "_vendor-codemirror-BlmFw5CA.js": {
+    "file": "assets/vendor-codemirror-BlmFw5CA.js",
     "name": "vendor-codemirror",
     "imports": [
-      "_vendor-ARQZvmz5.js",
-      "_vendor-shiki-BpqODMgR.js"
+      "_vendor-BKYy4SMr.js",
+      "_vendor-shiki-BitvudxD.js"
     ]
   },
-  "_vendor-recharts-Cl8AO7Np.js": {
-    "file": "assets/vendor-recharts-Cl8AO7Np.js",
+  "_vendor-recharts-Bz7zqjbW.js": {
+    "file": "assets/vendor-recharts-Bz7zqjbW.js",
     "name": "vendor-recharts",
     "imports": [
-      "_vendor-ARQZvmz5.js"
+      "_vendor-BKYy4SMr.js"
     ]
   },
-  "_vendor-shiki-BpqODMgR.js": {
-    "file": "assets/vendor-shiki-BpqODMgR.js",
+  "_vendor-shiki-BitvudxD.js": {
+    "file": "assets/vendor-shiki-BitvudxD.js",
     "name": "vendor-shiki",
     "imports": [
-      "_vendor-ARQZvmz5.js"
+      "_vendor-BKYy4SMr.js"
     ]
   },
   "_vendor-three-C5WAXd5r.js": {
@@ -69,19 +69,19 @@
     "name": "vendor-three"
   },
   "index.tsx": {
-    "file": "assets/index-DNmPxkEL.js",
+    "file": "assets/index-CdNW7TcY.js",
     "name": "index",
     "src": "index.tsx",
     "isEntry": true,
     "imports": [
-      "_vendor-ARQZvmz5.js",
-      "_vendor-arizeai-Ct6kvW4e.js",
-      "_pages-Bns7xROJ.js",
-      "_components-DGavuwFF.js",
+      "_vendor-BKYy4SMr.js",
+      "_vendor-arizeai-hGVPFFRq.js",
+      "_pages-BWWAYqfd.js",
+      "_components-37rV35eH.js",
       "_vendor-three-C5WAXd5r.js",
-      "_vendor-codemirror-BxoXtD6f.js",
-      "_vendor-shiki-BpqODMgR.js",
-      "_vendor-recharts-Cl8AO7Np.js"
+      "_vendor-codemirror-BlmFw5CA.js",
+      "_vendor-shiki-BitvudxD.js",
+      "_vendor-recharts-Bz7zqjbW.js"
     ]
   }
 }