Struct ObservabilityEvent 

pub struct ObservabilityEvent {
    pub version: u32,
    pub occurred_at_millis: u64,
    pub tick: u64,
    pub conversation_id: String,
    pub span_id: Option<u64>,
    pub kind: EventKind,
}

A single observability event with envelope metadata.

kind is flattened so the wire JSON is a single flat object:

{
  "version": 1,
  "occurred_at_millis": 1715000000000,
  "tick": 42,
  "conversation_id": "thread-1",
  "kind": "prompt.started",
  "model": "gpt-4o",
  "messages_in": 3
}

Fields

version: u32

Schema version. See SCHEMA_VERSION.

occurred_at_millis: u64

Wall-clock timestamp in milliseconds since the Unix epoch.

tick: u64

Monotonic per-process counter. Use to order events without clock skew.

conversation_id: String

Conversation / thread identifier this event belongs to.

span_id: Option<u64>

Numeric id of the tracing::Span that was current when this event was emitted, when one exists. Mirrors tracing::span::Id::into_u64 so consumers using tracing-opentelemetry (or any subscriber that attaches span ids to events) can stitch rig-tap events into the existing span waterfall without conversation-id post-processing. Absent (None) when no span is active at emit time.

kind: EventKind

Event-specific payload. Flattened into the parent object.

Implementations

impl ObservabilityEvent

pub fn new(conversation_id: impl Into<String>, kind: EventKind) -> Self

Build a new envelope around kind using the current schema version. Callers normally use crate::emit::emit which fills in tick and occurred_at_millis automatically.

Trait Implementations

impl Clone for ObservabilityEvent

fn clone(&self) -> ObservabilityEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ObservabilityEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ObservabilityEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ObservabilityEvent

fn eq(&self, other: &ObservabilityEvent) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ObservabilityEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ObservabilityEvent