Metadata - TraceRoot

Metadata is key-value pairs attached to traces or spans — useful for model versions, request IDs, feature flags, or any structured context you want to search on.

Using `observe`

Pass static metadata to observe for values known at definition time:

Python
TypeScript

from traceroot import observe

@observe(name="process", type="agent", metadata={"version": "v2", "tier": "premium"})
def process(query: str):
    return result

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

const result = await observe(
  { name: 'process', type: 'agent', metadata: { version: 'v2', tier: 'premium' } },
  async () => doWork(query),
);

Using `using_attributes` / `usingAttributes`

Propagate metadata to all traces and spans within a block:

Python
TypeScript

from traceroot import using_attributes

with using_attributes(metadata={"deploy": "canary", "region": "us-west-2"}):
    agent.run(query)

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

await usingAttributes({ metadata: { deploy: 'canary', region: 'us-west-2' } }, async () => {
  await agent.run(query);
});

⌘I