For the complete documentation index, see llms.txt. This page is also available as Markdown.

Vision Events

Record, search, and analyze what your deployed computer vision models see in production.

Overview

Vision Events is a Roboflow datastore that can capture important events, like the detection of defect or a count of inventory, alongside visual information from your deployed computer vision model. This gives you a searchable, filterable history of everything your vision system observes in production.

What is a Vision Event?

A Vision Event is a timestamped record created when a model processes an image. Each event can optionally capture:

  • Images: The original images that were processed and associated output images

  • Predictions: Object detections, classifications, instance segmentations, or keypoints returned by the model

  • Source metadata: Which device, stream, or workflow generated the event

  • Custom metadata: Key-value pairs you define for your domain (e.g. line_number, shift, part_number)

For programmatic access, see the Vision Events API Reference.

Key Concepts

Use Cases

A Use Case groups events that share a common purpose and custom metadata structure. Events in the same Use Case typically send similar metadata fields so you can filter and query them consistently.

For example, a "Defect Detection" Use Case might always include line_id, shift, and part_number even if events come from multiple factories or camera locations. Create separate Use Cases when the metadata structure is fundamentally different (e.g. "PPE Compliance" tracks zone and alert_type instead).

Last updated

Was this helpful?