Get Started

There are two ways to add Trodo tracing: let a coding agent wire it for you following best practices for your stack, or install it manually. Both end the same way: one init call plus a wrap around your agent, and your runs show up in the dashboard.

Before you start

Grab your site ID from Settings → Project → General in the Trodo app. It's the only credential the SDK needs (and the Bearer token for the OTLP path). Set it as TRODO_SITE_ID in your environment.

Agentic installation

Trodo ships a skill that teaches your coding agent (Claude Code, Cursor, and others) how to detect your stack, pick the right integration path, and wire tracing the way Trodo recommends. There are two ways to get it.

Install the Trodo agent-tracing skill from github.com/trodoai/skills,
then add tracing to my agents. My Trodo site ID is <your-site-id>.
Follow Trodo's best practices for my stack.

npx skills add trodoai/skills --all

Use the Trodo skill to add agent tracing to this project.
My site ID is <your-site-id>.

Either way the skill runs a detect → confirm → install flow: it won't write code until it has shown you a plan and you've approved it.

Install manually

Prefer to do it by hand? The full set of methods, for every language and stack, lives in the Instrumentation Guide. The 90% path is three steps.

npm install trodo-node

import trodo from 'trodo-node';

trodo.init({ siteId: process.env.TRODO_SITE_ID }); // once, at startup

const { result } = await trodo.wrapAgent('my-agent', async (run) => {
  run.setInput({ query });
  const answer = await agent.run(query); // provider calls auto-captured
  run.setOutput(answer);
  return answer;
});

pip install trodo-python

import os, trodo

trodo.init(site_id=os.environ['TRODO_SITE_ID'])  # once, at startup

with trodo.wrap_agent('my-agent') as run:
    run.set_input({'query': query})
    answer = agent.run(query)  # provider calls auto-captured
    run.set_output(answer)

node --import trodo-node/register your-app.js

Pick the path that matches your setup from the guide:

• Wrap your agent: the default
• Frameworks: OpenAI, Anthropic, LangChain, LlamaIndex, and more
• Use your existing OpenTelemetry: already on OTel
• Long-running & background runs, Distributed tracing, Raw HTTP

See your first trace

Run your agent once, then open the Agent Runs dashboard. The row shows tokens in and out, cost, span count, tool count, and error count, plus the full trace tree of every LLM and tool call.

Next

• Concept: how runs, spans, and conversations fit together
• Instrumentation Guide: every way to capture runs and spans
• Curate from production: promote trace spans into dataset rows
• Pricing: how tokens become cost