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 |
count | Count events over time intervals |
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 --filter 'timestamp[gte]=-1h' --filter 'type[prefix]=user.' --limit 50
snug timeline query -s events --sort -timestamp --limit 10
snug timeline count -s events --start -24h --end now --interval hour
snug timeline query -s events --filter 'data.amount[gt]=100' --sort -timestamp
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.