trace()

@contextmanager
def trace(
    name: str,
    tags: list[str] | None = None,
    metadata: dict | None = None,
    user_id: str | None = None,
    session_id: str | None = None,
    version: str | None = None,
    trace_id: str | None = None,
) -> Generator[Trace, None, None]

from rdk import trace
from anthropic import Anthropic

with trace("notebook-experiment", tags=["dev"]) as t:
    print(f"Trace ID: {t.id}")
    client = Anthropic()
    result = client.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=256,
        messages=[{"role": "user", "content": "Hello"}]
    )

from rdk import trace

with trace(
    "batch-job",
    tags=["batch"],
    metadata={"job_id": job_id, "dataset": "q4-2024"},
    user_id="system",
) as t:
    # process items
    ...
    print(f"Completed trace: {t.id}")

import logging
from rdk import trace

logger = logging.getLogger(__name__)

with trace("process-document") as t:
    logger.info("Processing", extra={"trace_id": t.id})
    # LLM calls here are captured