# Vision Events

## 개요

Vision Events는 배포된 컴퓨터 비전 모델의 시각적 정보와 함께, 결함 감지나 재고 수량과 같은 중요한 이벤트를 캡처할 수 있는 Roboflow datastore입니다. 이를 통해 프로덕션에서 비전 시스템이 관찰하는 모든 항목에 대한 검색 가능하고 필터링 가능한 기록을 제공합니다.

{% hint style="info" %}
Vision Events는 Model Monitoring을 대체합니다. 현재 Model Monitoring을 사용 중이라면, 이전 문서는 [(Legacy) Model Monitoring](https://docs.roboflow.com/roboflow/roboflow-ko/deploy/model-monitoring) 을(를) 참조하세요.
{% endhint %}

## Vision Event란 무엇인가요?

Vision Event는 모델이 이미지를 처리할 때 생성되는 타임스탬프가 있는 기록입니다. 각 이벤트는 선택적으로 다음을 캡처할 수 있습니다:

* **이미지**: 처리된 원본 이미지와 연결된 출력 이미지
* **예측**: 모델이 반환한 객체 탐지, 분류, 인스턴스 세분화 또는 keypoints
* **소스 메타데이터**: 이벤트를 생성한 디바이스, 스트림 또는 workflow
* **사용자 지정 메타데이터**: 도메인에 대해 정의하는 키-값 쌍(예: `line_number`, `shift`, `part_number`)

프로그래밍 방식 접근은 다음을 참조하세요. [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events).

## 핵심 개념

### 사용 사례

하나의 **Use Case** 는 공통 목적과 사용자 지정 메타데이터 구조를 공유하는 이벤트를 그룹화합니다. 같은 Use Case의 이벤트는 일반적으로 유사한 메타데이터 필드를 전송하므로 일관되게 필터링하고 쿼리할 수 있습니다.

예를 들어, "Defect Detection" Use Case에는 항상 `line_id`, `shift`, 그리고 `part_number` 를 포함할 수 있습니다. 이벤트가 여러 공장이나 카메라 위치에서 오더라도 마찬가지입니다. 메타데이터 구조가 근본적으로 다른 경우에는 별도의 Use Case를 만드세요(예: "PPE Compliance"는 `zone` 및 `alert_type` 를 추적합니다).