Trace

Definition

class Trace(CamelModel):
    id: str
    name: str
    spans: list[Span]
    start_time: int
    end_time: int | None
    tags: list[str]
    metadata: dict
    user_id: str | None
    session_id: str | None
    version: str | None  # stored in metadata["version"]

Fields

string

Unique identifier for the trace. Auto-generated UUID if not provided.

string

required

Name describing the operation being traced.

list[Span]

List of spans belonging to this trace.

integer

Unix timestamp in milliseconds when the trace started.

integer

Unix timestamp in milliseconds when the trace ended. None if still running.

list[string]

Tags for categorizing the trace.

dict

Arbitrary metadata attached to the trace. The version field from @observe is stored here as metadata["version"].

string

Optional user identifier.

string

Optional session identifier.

JSON Serialization

Traces serialize with camelCase field names:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "customer-support",
  "spans": [...],
  "startTime": 1708444800000,
  "endTime": null,
  "tags": ["production"],
  "metadata": {"channel": "web", "version": "2.1.0"},
  "userId": "user_123",
  "sessionId": "session_abc"
}

Core

Synthetic Worlds

Utilities

PII Redaction

Models

Definition

Fields

JSON Serialization

See Also

​Definition

​Fields

​JSON Serialization

​See Also

Definition

Fields

JSON Serialization

See Also