peepshow/sinks/sentry

Reel #13Observability

peepshow sink / sentry

SentrySend the run as a Sentry event with full context.

Frames as attachments, metadata as tags, peepshow run ID as fingerprint.

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 peepshow

Use 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.required
  • PEEPSHOW_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'.