Tags - TraceRoot

Tags are string labels on traces for filtering and categorization — by environment, experiment, feature, or any dimension you care about.

Using `observe`

Pass static tags directly to observe:

Python
TypeScript

from traceroot import observe

@observe(name="run_agent", type="agent", tags=["production", "v2"])
def run_agent(query: str):
    return process(query)

import { observe } from '@traceroot-ai/traceroot';

const result = await observe(
  { name: 'run_agent', type: 'agent', tags: ['production', 'v2'] },
  async () => process(query),
);

Using `using_attributes` / `usingAttributes`

Propagate tags to all traces within a block:

Python
TypeScript

from traceroot import using_attributes

with using_attributes(tags=["staging", "experiment-a"]):
    agent.run(query)

import { usingAttributes } from '@traceroot-ai/traceroot';

await usingAttributes({ tags: ['staging', 'experiment-a'] }, async () => {
  await agent.run(query);
});