CLICommands
timeline
snug timeline <COMMAND>Timeline Service - Time-series event storage.
Subcommands
| Command | What it does |
|---|---|
create-stream | Create a new stream |
list-streams | List all streams |
delete-stream | Delete a stream |
stream-stats | Get stream statistics |
create-event | Create a single event |
batch-create | Create multiple events in batch |
query | Query events |
latest | Get latest events |
count | Count events over time intervals |
search | Search events with structured filters and sort order |
follow | Follow a stream in real time over a WebSocket until interrupted |
aggregate | Aggregate events over a time range |
Run snug timeline <command> --help for that command's own options.
The global options apply everywhere.
Examples
snug timeline create-stream -n events -d "App activity" -r 30 -t app:web,env:prod
snug timeline list-streams
snug timeline stream-stats -n events
snug timeline delete-stream -n events
snug timeline create-event -s events -t user.login -d '{"user_id":"u123"}' --tags ip:1.2.3.4
snug timeline batch-create -s events -f events.json
snug timeline query -s events --start -1h --end now -t "user.*" -l 50
snug timeline latest -s events -l 10
snug timeline count -s events --start -24h --end now --interval hour
snug timeline search -s events --start 0 --end 9999999999999 -f '[{"field":"amount","operator":"greater_than","value":100}]' --sort timestamp_asc
snug timeline aggregate -s events --start -24h --end now -a sum -f amount -g type
snug timeline follow -s eventsNext
- timeline guide - what the service does and when to reach for it.
- API reference - every endpoint these commands call.
- CLI reference - global options, output modes, and exit codes.