Omni Events

Use omni events for event streams and omni journey for per-message tracing.

Query events

omni events list --since 24h --limit 100 --json
omni events list --instance <id> --type message.received --json
omni events list --chat-id <chatId> --since 24h --json
omni events list --since 24h --until "2026-02-25" --json
omni events search "error" --since 7d --limit 100 --json
omni events timeline <personId> --limit 100 --json

Metrics and analytics

omni events metrics --json
omni events analytics --since 7d --json
omni events analytics --instance <id> --all-time --json

Replay sessions (event replay)

Re-process historical events through the event pipeline. Useful for rerunning automations or backfilling analytics.

# Start
omni events replay --start --since 7d --json
omni events replay --start --since 24h --types message.received,message.sent --speed 2 --json
omni events replay --start --since 7d --dry-run --json
omni events replay --start --since 7d --until "2026-02-20" --json
omni events replay --start --since 24h --instance <id> --json

# Check / cancel
omni events replay --status <sessionId> --json
omni events replay --cancel <sessionId> --json

Message replay (standalone command)

omni replay is a separate, standalone command (not under omni events). It replays missed inbound messages for a specific agent instance — useful when an agent was offline and needs to catch up.

# Replay missed messages since instance's lastSeenAt (default, max 24h)
omni replay <instanceId>

# Replay messages received after a specific timestamp
omni replay wa-main --since 2026-02-27T10:00:00Z

Flags: --since <timestamp> (ISO 8601; default: instance's lastSeenAt, max 24h ago)

Key difference: omni events replay re-processes events through the event bus (analytics, automations). omni replay re-delivers missed inbound messages to an agent instance.

Journey tracing

omni journey show <correlationId> --json
omni journey summary --since 24h --json

Notes

• events list supports --chat-id <id> and --until <time> for precise time-range filtering.
• events replay --start supports --until <time> and --instance <id>.
• events search supports --since and --limit (no --type flag there).
• Event replay management is all through omni events replay flags.
• For replaying missed agent messages, use omni replay <instanceId> (standalone command).