Send your first trace

This quickstart gets you from zero to a visible trace you can click through in Boson.

1) Install and configure

Follow Installation to install the SDK and set:

• BOSON_API_KEY
• BOSON_HOST (optional)

2) Wrap one user request

Pick a single endpoint or function that represents a real user action and wrap it with:

• one trace per request
• spans for retrieval / LLM call / tool calls

3) Add the minimum metadata

Start with:

• env: development / staging / production
• release: git SHA or semver
• userId and sessionId (only if policy allows)

4) Verify

In the Boson UI:

• search for the trace by name
• click into the span tree
• confirm you see input/output artifacts you expect (sanitized)

5) Next steps

• Use Span naming to standardize across services.
• Read Tracing for capture best practices.