elsa-core/specs/006-diagnostics-console-logs/data-model.md

Data Model: Diagnostics Console Logs

ConsoleLogLine

Redacted raw stdout or stderr line exposed by Core.

• Id: unique event identifier.
• Timestamp: timestamp associated with the write when available.
• ReceivedAt: backend receive timestamp.
• Sequence: source-local monotonic sequence.
• Stream: stdout or stderr.
• Text: redacted line text after ANSI default handling.
• Source: ConsoleLogSource descriptor.
• Truncated: whether the line exceeded the configured maximum line length.
• Dropped: optional dropped-line metadata associated with the source or subscriber.

ConsoleLogSource

Backend process, pod, container, machine, or provider source that produced console output.

• Id: stable source identifier.
• DisplayName: operator-facing name.
• ServiceName: service or application name.
• ProcessId: process identifier when available.
• MachineName: machine or host name.
• PodName, ContainerName, Namespace, NodeName: container/orchestrator metadata when available.
• LastSeen: most recent line or heartbeat timestamp.
• Health: connected, stale, or disconnected.
• Metadata: optional redacted provider metadata.

ConsoleLogFilter

Criteria applied to recent queries and live subscriptions.

• SourceId: optional source filter.
• Stream: optional stdout or stderr filter.
• Query: optional free-text search over redacted line text and source fields.
• From, To: optional received-time range.
• Limit: requested recent count, clamped by server options.

RecentConsoleLogsResult

Backfill response returned by the recent lines endpoint.

• Items: ordered ConsoleLogLine collection.
• Dropped: dropped-line summaries relevant to the result when known.
• Sources: optional source status snapshot if the endpoint chooses to include it.

ConsoleLogDroppedSummary

Bounded-buffer or subscriber overflow summary.

• SourceId: affected source when known.
• Stream: affected stream when known.
• Reason: buffer overflow, subscriber overflow, provider unavailable, or other safe reason.
• Count: number of dropped lines.
• From, To: optional time span covered by the summary.

ConsoleLogProvider

Replaceable provider facade for redacted console logs.

• Stores redacted recent lines in bounded history.
• Streams redacted live lines and dropped summaries.
• Lists redacted sources and source health.
• Does not receive or retain unredacted line text or sensitive source metadata.

ConsoleCaptureTee

Capture boundary that observes stdout/stderr writes while preserving original destinations.

• Buffers partial writes until newline, maximum line length, or idle flush timeout.
• Emits one truncated event when a line exceeds maximum length.
• Avoids recursively capturing diagnostics generated by this feature unless explicitly enabled.

ConsoleRedactionRule

Configured matching rule for sensitive line text or source metadata.

• Name: rule identifier.
• Pattern: configured match expression or equivalent matcher.
• Replacement: redaction marker.
• AppliesTo: line text, source metadata, or both.

ConsoleLogSubscription

Live SignalR subscription state.

• ConnectionId: SignalR connection identifier.
• Filter: active ConsoleLogFilter.
• QueueCapacity: bounded subscriber queue capacity.
• DroppedCount: subscriber-local dropped-line count.
• Cancellation: cancellation state for unsubscribe/disconnect.