Skip to main content

Display Trace Links

Open In GitHub

When developing, adding a trace link in your UI can help you save time debugging.

In this walkthrough, you will share a link to your LangSmith trace using the following pattern:

from langchain.callbacks import tracing_v2_enabled
from langsmith import Client

client = Client()

with tracing_v2_enabled() as cb:
chain.invoke({"input": "<user-input>"})
url = cb.get_run_url()

The tracing_v2_enabled callback collects the latest trace in-memory and returns a (private) link to the trace details for easy debugging.

The demo app will look like this:

streamlit-app

Setup

First, creating a python virtual environment, activate it, and install the project requirements requirements.

python -m virtualenv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Next, set your API keys. The demo uses Anthropic (and LangSmith):

export LANGCHAIN_API_KEY=...
export ANTHROPIC_API_KEY=...

After setup is done, run the application!

ENVIRONMENT=dev python -m streamlit run app.py

This will spin up the local streamlit application. Try saying hello and clicking the trace URL!

trace url

Conclusion

This completes the tutorial! Displaying URLs inline is an easy way to avoid having to search through your project to replay or analyze a run.