ISO8601 timestamp of when the event occurred.
Logical identifier for a user session or conversation.
Severity level of the event.
Trace context for correlating events.
OptionalproviderThe AI provider SDK that emitted the event.
OptionalmodelThe specific model ID used, if known (e.g., 'gpt-4-turbo').
OptionalrequestThe unique request ID returned by the provider's API.
OptionalserviceThe name of the service emitting the event.
OptionalenvThe deployment environment (e.g., 'production', 'staging').
OptionalregionThe cloud or geographical region.
Optional$extA bucket for vendor-specific or non-standard extensions.
The discriminated union type name for the event.
A descriptive name for the operation (e.g., 'db:query', 'api:call').
The total duration of the operation in milliseconds.
OptionalstatusThe status of the operation.
OptionalattrsA dictionary of arbitrary attributes related to the span.
An event representing a timed operation, similar to a span in OpenTelemetry. Useful for instrumenting non-LLM operations like database queries, API calls, or function executions.
See
https://opentelemetry.io/docs/concepts/signals/traces/#spans