Skip to main content
To view a trace, select a log from your project’s Logs page or from an experiment on the Experiments page. The trace opens in a panel on the right side of your screen. Log with trace This panel shows a tree of all of the spans that make up the trace. Use the toggle fullscreen trace button to expand it to full screen or the new page button to open the trace in a new page. Select a span to see its metrics, input, output, expected, metadata, and activity.

Timeline view

Select Timeline to view the trace as a timeline. This view shows the spans as a series of bars, with the width of the bar representing the duration of the span. The bars are color-coded by span type. Select a bar to view the span details in the trace view.

Thread view

Select Thread to view the trace as a thread. This view shows the spans as a series of messages, with the messages being color-coded by span type.

Custom view

Select Custom to create a custom view for the trace. Use custom views to highlight specific parts of the trace or visualize the trace in a way that is specific to your use case. To create a custom view, describe how you want to view your trace data using natural language and Loop will create it for you. image of custom view in loop To save the custom view, select Save version, toggle Save as new custom view version, and select Update. The saved view persists when viewing any trace in the project. To edit the custom view, select the ellipsis button in the bottom left of the trace panel and select Edit. This shows the code Loop generated and used to create the custom view. Edit the code directly in the code editor or in the chat prompt below the code. The preview updates in real time. Select Save changes to see a diff of the changes and update the view. Example custom view prompts:
  • “Create a view that renders a list of all tools available in this trace and their outputs”
  • “Render the video url from the trace’s metadata field and show simple thumbs up/down buttons”

Search, filter, and bulk select spans

Select Find in the top right corner of the trace panel or page to find a specific span in a trace. You can then select the filter icon to filter further by span type or span field. Once you’ve found the spans you’re looking for, you can use the checkboxes to select or bulk select them and add them to a new or existing dataset in your project.

Diff traces

Use the Diff toggle on the top right of an experiment page to compare traces across experiments. In the Comparisons panel on the left, use the drop down menu to select which experiments to compare. Each row in the trace view will show a list of the outputs from the selected experiments for that trace. You can select multiple experiments to compare at once.

Share traces

Update trace settings to make a trace public and share it with others. Sharing a trace only shares that individual trace and doesn’t grant access to the Logs or Experiments pages. When a trace is public, anyone with the link can view it. In the top right corner of the trace panel or trace page, select the Share icon to update the trace settings. In the Share trace dialog, select Public to make the trace public and share it with others. Copy the link directly from this dialog or click the View trace as page button to open the page and copy the link. When the trace is public, icon in the top right changes from a lock to a globe and appears green.

Data views

There are several ways to view fields in a span. You can set a default data view type in Settings > Personal or change the view in the span panel.
  • Pretty
    • Parses objects deeply and renders values as Markdown. Optimized for object value readability.
  • LLM
    • Parsed LLM messages and tools with Markdown formatting
  • LLM raw
    • LLM messages and tools without Markdown formatting
  • JSON
    • JSON highlighting and folding
  • YAML
    • YAML highlighting and folding
  • HTML
    • Render HTML content

Re-run a prompt

Select Run to edit and re-run any chat completion span inside a trace. In the Run prompt window, make any changes you’d like to the prompt and select Test to see the output. You can also give this prompt a name and select Save as custom prompt to save it to your project’s prompt library.