What it does
Fire a peepshow run into Sentry as a single event: tags are populated from video metadata (title, director, duration), frames are attached as screenshots, the fingerprint keeps related runs grouped.
When to reach for it
- Agent crash on a specific video → surface the exact frames in Sentry
- Automated soak-tests of media pipelines with video evidence in error reports
- Environment-specific debugging: tag events by `which video made the agent fail`
Install
npm i -g peepshowUse it
peepshow ./trigger.mp4 --sink sentry \
--sink-arg dsn=https://...ingest.sentry.io/...Make it automatic
Register the sink once — every run fires it afterward. Scope by--whenso it only runs for matching videos.
peepshow sinks add sentry
peepshow sinks add sentry --when extension=mp4,mov
peepshow sinks add sentry --when path=/Volumes/Work/Configuration
PEEPSHOW_SENTRY_DSNSentry DSN.requiredPEEPSHOW_SENTRY_ENVEnvironment tag. Default `peepshow`.
Write your own
A sink is any executable that reads the--emit jsonpayload on stdin. Shell, Node, Python, Go — the spec's indocs/PLUGINS.md. Register persistent ones withpeepshow sinks add-cmd 'your-command'.