> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/roboflow/roboflow-ko/deploy/vision-events.md).

# Vision Events

## 개요

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

## Vision Event란 무엇인가요?

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

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

프로그래밍 방식 액세스는 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events).

{% embed url="<https://www.youtube.com/watch?v=4HlYG1MacRk>" %}

## 핵심 개념

### 사용 사례

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

예를 들어, "Defect Detection" 사용 사례에는 항상 `line_id`, `shift`그리고 `part_number` 이벤트가 여러 공장이나 카메라 위치에서 발생하더라도 마찬가지입니다. 메타데이터 구조가 근본적으로 다를 때는 별도의 사용 사례를 만드세요(예: "PPE Compliance"는 `zone` 및 `alert_type` 를 추적하는 경우 대신).