> 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/deployment/ko/monitoring-and-analytics/vision-events/send-events.md).

# 이벤트 전송

배포된 모델에서 Vision Event를 보내는 세 가지 방법입니다.

## 이벤트 전송

워크플로 블록, HTTP API 또는 에지 디바이스 백업을 사용하여 Vision Event를 전송할 수 있습니다.

* [워크플로 블록](#workflow-block): 모델이 워크플로에서 실행되는 경우 가장 간편한 옵션입니다.
* [HTTP API](#http-api): 워크플로 외부에 배포하는 모델에 사용합니다.
* [에지 디바이스 백업](#edge-device-backup): 디바이스의 로컬 이벤트 저장소에서 이벤트를 백업하는 Roboflow 에지 디바이스에 사용합니다.

### 워크플로 블록

대부분의 사용자에게 권장되는 방법입니다. Roboflow 워크플로에 **Vision Event** 블록을 추가하면 코드 없이 추론 결과에서 이벤트를 자동으로 생성할 수 있습니다.

{% hint style="info" %}
이 설정은 [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) 가 대신할 수 있습니다. 에이전트에 모델을 실행하는 워크플로를 만들어 달라고 요청하면 Vision Events 블록을 자동으로 추가하고 적절한 [사용 사례에 연결합니다.](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/use-cases.md).
{% endhint %}

#### 설정

{% stepper %}
{% step %}
**워크플로 편집기 열기**

워크스페이스에서 **워크플로** 로 이동하여 이벤트를 추가할 워크플로를 엽니다.
{% endstep %}

{% step %}
**Vision Event 블록 추가**

블록 카탈로그에서 "Vision Event"를 검색하여 워크플로에 추가합니다.
{% endstep %}

{% step %}
**입력 연결**

이미지 입력과 모델 예측 출력을 Vision Event 블록에 연결합니다.
{% endstep %}

{% step %}
**사용 사례 구성**

사용 사례 이름(`useCaseId`)을 설정합니다. 앞 단계의 블록에서 사용자 지정 메타데이터를 매핑할 수도 있습니다. 사용 사례를 선택한 후 드롭다운 아래의 "Vision Events에서 열기"를 클릭하면 해당 사용 사례의 이벤트 페이지가 새 탭에서 열립니다.
{% endstep %}

{% step %}
**워크플로 배포**

워크플로를 배포하거나 업데이트합니다. 워크플로가 실행될 때마다 이벤트가 자동으로 생성됩니다.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
워크플로 블록은 이미지 업로드와 이벤트 생성을 한 단계로 처리합니다. 이미지만 첨부할 수 있습니다. 동영상 클립을 첨부하려면 [HTTP API](#http-api) 또는 [에지 디바이스 백업을 사용하세요.](#edge-device-backup).
{% endhint %}

### HTTP API

워크플로에서 실행되지 않는 코드에서 이벤트를 전송하려면 HTTP API를 사용하세요. 각 엔드포인트 페이지에는 필드, 필수 스코프 및 응답이 나와 있습니다.

{% hint style="warning" %}
이벤트를 전송하기 전에 [사용 사례](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/use-cases.md) 를 생성하세요. 워크스페이스에서 활성 상태인 사용 사례가 아닌 `useCaseId` 를 가진 이벤트도 저장되지만 응답에 경고가 포함됩니다.
{% endhint %}

1. 각 이미지를 다음을 사용하여 업로드합니다: [Vision Event 이미지 업로드](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/upload-a-vision-event-image.md#http-api). 응답에는 다음 값이 포함됩니다: `sourceId`.
2. 동영상 클립을 첨부하려면 각 클립을 다음을 사용하여 업로드합니다: [Vision Event 동영상 업로드](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/upload-a-vision-event-video.md#http-api). 다음 값이 반환됩니다: `videoId` 및 클립을 업로드할 서명된 URL. 클립의 크기는 최대 3GB입니다.
3. 다음을 사용해 이벤트를 생성합니다. [Vision 이벤트 생성](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/create-a-vision-event.md#http-api). 각 이미지를 `sourceId` 에는 `images[].sourceId` 에, 각 `videoId` 에는 `videos[].sourceId`.

요청 하나로 최대 100개의 이벤트를 보내려면 다음을 사용합니다. [Vision 이벤트 일괄 생성](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/batch-create-vision-events.md#http-api). 배포 환경에서 클라우드로 연결되는 경로가 없다면 다음을 사용합니다. [Vision 이벤트 번들 업로드](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/upload-a-vision-event-bundle.md#http-api).

### 엣지 디바이스 백업

연결이 간헐적으로 끊길 수 있는 엔터프라이즈 배포 환경에서는 엣지 디바이스가 이벤트를 로컬에 저장하고, 연결이 복구되면 Roboflow와 동기화합니다.

{% hint style="info" %}
엣지 디바이스 백업을 사용하려면 Deployment Manager가 필요합니다. 설정 방법은 [Deployment Manager 문서](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager.md) 를 참조하세요.
{% endhint %}

Vision 이벤트 백업을 사용 설정하려면 다음 단계를 따르세요.

1. Workspace에서 Deployment Manager를 열고 디바이스를 선택합니다.
2. "Configuration" 탭에서 [Event Store](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/services/event-store.md) 카드의 "Configure"를 클릭합니다.
3. "Enable Vision Events Backup"을 켜고, Use Case를 지정하지 않은 이벤트에 적용할 "Default Use Case"를 선택한 다음 "Backup Mode"를 선택합니다.
4. 창에서 "Save Configuration"을 클릭한 다음, "Configuration" 탭에서 "Save Configuration"을 클릭합니다. 디바이스는 이벤트를 로컬 Event Store에 기록하고, 연결이 복구된 후에도 이벤트를 Roboflow와 동기화합니다.

동기화가 완료되면 Vision Events 대시보드에 이벤트가 표시됩니다.

"Backup Mode"가 "Records and Files"이면 디바이스에서 이벤트에 첨부된 비디오 클립도 업로드되어 대시보드에서 재생할 수 있습니다. 이벤트당 최대 4개의 MP4 및 MOV 클립이 업로드됩니다. 다른 형식의 파일은 디바이스에 남습니다. 클립 업로드에 실패하면 재시도할 때마다 해당 이벤트의 동기화가 약 1시간 지연됩니다. 기본적으로 3회 반복 실패하면 클립 없이 이벤트가 동기화됩니다. 파이프라인에서 디바이스의 클립을 이벤트에 첨부하는 방법은 [초안 이벤트 및 비디오](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager/services/event-store.md#draft-events-and-video) 를 참조하세요.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-dad946e36678b43e2fe868c8972b9b8853eb724f%2Fimage%20(455).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
