Troubleshooting Fetching Spans with Annotations in Phoenix

Prerit S. · 2025-08-22T14:29:45.514Z

Hello, None of this code works for me despite using the latest versions packages from Phoenix when I try to fetch annotations span dataframe..Any idea why this is happening? What can I do to fetch spans along with annotations in Phoenix?

RunLLM
APP
·
To fetch spans and their annotations in Phoenix, you must first retrieve the spans (e.g., using get_spans_dataframe), then separately fetch annotations using get_span_annotations_dataframe by passing either the spans dataframe or a list of span IDs. There is no single API call that returns both spans and their annotations together; you must join the two dataframes yourself. See the example below: LBKSfrom phoenix.client import Client client = Client() spans = client.spans.get_spans_dataframe(project_identifier="default") annotations = client.spans.get_span_annotations_dataframe(spans_dataframe=spans, project_identifier="default") result = annotations.join(spans, how="left")LBKSIf you are not seeing annotations, ensure you are using the correct project identifier and that your spans actually have annotations. Also, check that you are not filtering out annotation names unintentionally. For more, see the official Exporting Annotated Spans guide.Would you like a step-by-step troubleshooting guide?Sources: - Exporting Annotated Spans guide - Phoenix Annotations API Reference
💡 Hint: Mention RunLLM in the thread for followups.
Prerit S.
·
Implementation for fetching annotated spans as described in Phoenix docs does not work..
👀1
Prerit S.
·
I want all spans with annotations...Not just one specific filtered type of annotation information
Prerit S.
·
How can I get all annotations?
Dustin N.
·
Try leaving out the where clause in the span query
Prerit S.
·
So just like this and no where clause? query = spans.SpanQuery()
Prerit S.
·
Like I mentioned in my first message...I get error saying client does not have attribute spans
Prerit S.
·
My client is defined like this: client = px.Client(endpoint=endpoint)
Prerit S.
·
How can I specifiy my endpoint in my client? We have self-hosted pheonix on Kubernetes
Prerit S.
·
If I provide endpoint, it does not like that parameter and if I don't provide endpoint, then it doesn't connect with my pheonix instance..
Prerit S.
·
My imports that worked for me were like this (which works for get_spans_df but not for annotation_dataframe).. import phoenix as px client = px.Client(endpoint=endpoint)
Prerit S.
·
what is the ENV variable I need to set for endpoint?
Prerit S.
·
Now it worked..Thank you
Dustin N.
·
it's surprising that setting the endpoint didn't work for you
Prerit S.
·
After setting the endpoint as Env variable, client worked for me as Sanjana mentioned..but could not specify endpoint as a parameter in client

17 comments