traceroot does not auto-instrument TinyFish and does not know your rate. You trace the session with
observe and report its cost yourself, and traceroot stores the cost you report. See Tool and API calls for how reported costs add up.Install
- Python
- TypeScript
traceroot 0.5.0 or later, or @traceroot-ai/traceroot 0.7.0 or later.
Set up
Initialize traceroot once at startup. No integration flag is needed: theobserve wrapper in the next step traces the session.
- Python
- TypeScript
Usage
TinyFish bills remote browsers by the minute and returns no price, so you estimate the cost from the session’s length. To record it:- Wrap the session in a function traced as a tool span (
type="tool"). - Time the session from creation to close.
- Multiply the minutes by your price per minute and report it with
update_current_span(cost=...)(updateCurrentSpanin TypeScript) before the span closes. Afinallyblock reports it even when the session fails.
- Python
- TypeScript
browse from your agent like any other function. Its span nests under the span that called it, and its cost adds to that trace’s total.

Browser minutes at the per-minute rate on the tool span
Verify
Run your code and confirm the trace arrives:- In the traceroot UI: Navigate to Tracing > Traces in traceroot Cloud. You should see a
tinyfish_open_pagespan, at the root or under your agent’s span. Open it to see its cost; the trace’s total cost includes it. - Via the CLI: Run
traceroot traces listto inspect your recent traces from the terminal.
What gets captured
Limitations
- The cost is an estimate: TinyFish bills from its own usage records, which can run a little longer.
Next steps
Python SDK Reference
Explore the full Python SDK reference and instrumentation options.
Time used
Report time used at your price per minute