Dashboard logs missing due to span name schema error

Summary

Issue: Dashboard logs appear missing or incomplete when viewing spans in the Braintrust UI accompanied by the following error:

Internal error: 'Schema error: 'Expected 1 column for path span_attributes_jsononame, but received more.'

Cause: Invalid data types (such as JSON objects) are being passed to the name field of spans, which causes schema validation failures that silently hide affected logs from the dashboard view.

Resolution: Append additional valid logs to trigger a view refresh, and ensure span names are always strings.

Resolution Steps

Immediate Workaround

Step 1: Append new valid logs

Log additional spans to the same project to trigger a dashboard view refresh and display previously hidden logs.

Permanent Fix

Step 1: Validate span name data types

Ensure all span name fields are strings, not objects or other data types.

  # Correct: name is a string                                                                                                                                        
  with experiment.start_span(name="retrieval-step") as span:                                                                                                            
      span.log(input="What is the capital of France?", output="Paris")

  # Incorrect: name must be a string, not an object
  with experiment.start_span(name={"step": "retrieval"}) as span:  # type: ignore
      span.log(input="What is the capital of France?", output="Paris")

Step 2: Check existing logging code

Review your codebase for any instances where non-string values are passed to the name parameter.