> 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/summary-reports.md).

# 요약 보고서

주요 수치와 전체 보고서 링크를 포함한 Vision Events 사용 사례의 정기 요약을 팀에 이메일로 보내세요.

요약 보고서는 팀에 반복적으로 요약 내용을 이메일로 보내며, [Use Case](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/use-cases.md)의 핵심 수치를 이메일에 표시하고, Roboflow에서 차트와 표가 포함된 전체 보고서로 연결되는 링크를 제공합니다. 보고서 내용을 일상적인 언어로 설명하면, [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) 가 이벤트에서 이미 전송 중인 데이터를 바탕으로 보고서를 작성합니다. 일정(매일, 매주, 격주 또는 매월)과 보고서를 받을 Workspace 구성원을 선택할 수 있습니다.

Use Case 대시보드에는 카메라가 기록한 모든 내용이 표시되지만, 대시보드를 여는 사람만 볼 수 있습니다. 보고서는 수치를 바탕으로 조치를 취하는 사람에게 전달됩니다(예: 매주 월요일 아침 라인별로 지난주의 합격 및 불합격 건수를 확인하려는 공장 관리자). 각 보고서는 전송 당시의 상태로 저장되므로, 어느 기간이든 다시 확인해 팀에 표시된 내용을 정확히 볼 수 있습니다.

반복 보고서 대신 한 번만 답변을 받으려면 [Agent에게 이벤트에 관해 물어보세요](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/query-events.md#ask-the-agent).

## 보고서 이메일

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-46751d3dae5b1ffc7b222fbb0bf766abaa2b9dd0%2Fsummary-report-email.png?alt=media" alt="A Summary Report email with Pass, Fail, and Avg people in zone headline numbers and a View Full Report button" width="375"><figcaption><p>이메일에는 핵심 수치와 전체 보고서 링크가 표시됩니다.</p></figcaption></figure>

보고서가 실행될 때마다 모든 수신자에게 다음 내용이 포함된 이메일이 전송됩니다.

* 제목에 보고서 이름과 해당 기간이 표시됩니다.
* 핵심 수치는 최대 4개까지 표시됩니다. 여기에는 "전체 이벤트 수", Use Case에 [이벤트 값](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/use-cases.md#event-value)이 설정된 경우 "생성된 가치", 그리고 보고서의 단일 수치 섹션(예: "합격" 및 "불합격")이 포함됩니다.
* "전체 보고서 보기" 버튼이 표시됩니다.

이메일에는 차트가 포함되지 않습니다. "전체 보고서 보기"를 클릭하면 Roboflow에서 전체 보고서가 열리며, 수신자는 로그인하여 모든 섹션을 확인할 수 있습니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2f2637c1c6fa69f3c424d10f9c211da58f997036%2Fsummary-report-viewer.png?alt=media" alt="A full Summary Report in Roboflow with Pass, Fail, and Avg people in zone numbers and a daily events chart"><figcaption><p>전체 보고서가 Roboflow에서 열립니다.</p></figcaption></figure>

## 보고서 만들기

보고서를 만들려면 Vision Events Reports 관리 [권한이 필요합니다](#permissions) . Use Case에서 보고서에 사용할 필드가 포함된 이벤트를 이미 받고 있어야 합니다. 이벤트 전송을 시작하는 방법은 다음을 참조하세요. [이벤트 전송](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/send-events.md).

1. 왼쪽 사이드바에서 "Vision Events"를 클릭한 다음 Use Case를 엽니다.
2. "Reports" 탭을 엽니다.
3. "Create Report"를 클릭합니다(Use Case에 보고서가 이미 있는 경우에는 "Create With AI"를 클릭합니다). 아이디어를 바탕으로 시작하려면 다음 제안 중 하나를 클릭하세요. "Weekly Volume & Trend", "Top Categories" 또는 "By Device or Location".
4. "What should the report cover?" 아래에 보고서의 대상과 전송 빈도를 포함해 보고서 내용을 설명합니다. 비워 둔 다음 채팅에서 설명할 수도 있습니다.
5. "Create Report"를 클릭합니다. Agent가 새 브라우저 탭에서 열리고 보고서 초안을 작성합니다.
6. "Preview"를 클릭하여 실제 이벤트 데이터로 작성된 보고서를 확인합니다. 원하는 결과가 나올 때까지 채팅에서 수정을 요청하세요.
7. "Save & Schedule"을 클릭합니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-dcc3bae7807f1b205cfc2b0b263065bd6f1b524b%2Fsummary-report-empty.png?alt=media" alt="The Reports tab of a Use Case with no reports, showing the Create Report button and three suggestions"><figcaption><p>보고서가 없는 Use Case에는 "Create Report"와 세 가지 제안이 표시됩니다.</p></figcaption></figure>

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-7227c1b1633583efa35d1a61b78e7bc6bdef0e71%2Fsummary-report-create.png?alt=media" alt="The Create a Summary Report dialog with a description of a weekly summary for a site manager" width="375"><figcaption><p>보고서에 포함할 내용을 설명합니다.</p></figcaption></figure>

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-92b5e83e7b32107423081a6644fea39062cabe41%2Fsummary-report-agent.png?alt=media" alt="The Roboflow Agent with the chat on the left and the report on the right, with Preview, Email Now, and Scheduled buttons"><figcaption><p>채팅에서 보고서를 다듬은 다음 저장합니다.</p></figcaption></figure>

이후 Use Case의 "Reports" 탭에 보고서가 표시됩니다. 일정을 지정하지 않으면 Agent가 매주 월요일 오전 9시를 제안합니다.

다음과 같이 요청할 수 있습니다.

* "공장 관리자에게 매주 월요일 오전 8시에 보낼 요약: 검사한 병 수, 합격 및 불합격 건수, 라인별 불합격 건수."
* "일별 불량 건수를 보여주는 선형 차트를 추가해 줘."
* "가장 최근의 불합격 이벤트 10개를 라인과 결함 유형과 함께 표시해 줘."
* "기기별로 그룹화하고, 열 제목을 'device\_id' 대신 'Line'으로 표시해 줘."
* "격주로 설정해 줘."

Agent는 이벤트에 실제로 포함된 필드만 사용합니다. 보고서에 필요한 필드가 없으면 추측하지 않고 알려줍니다. Agent는 쿼리가 아니라 보고서 정의를 작성하며, 예약된 보고서가 실행될 때마다 AI 없이 이벤트 데이터에서 수치를 계산합니다.

## 보고서에 포함되는 내용

보고서에는 1\~8개의 섹션이 포함되며, 각 섹션은 다음 중 하나입니다.

* 통계(단일 수치), 막대형, 선형, 영역형, 원형, 도넛형 차트 또는 표로 표시되는 지표입니다. 지표는 이벤트 수를 세거나, 조건에 일치하는 이벤트 수를 세거나, 합계 또는 평균을 계산하거나, 최솟값, 최댓값 또는 고유 값의 개수를 찾을 수 있습니다. 또한 [운영자 피드백](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/operator-feedback.md) 판정이 포함된 이벤트의 비율(예: 부정확으로 표시된 비율)을 보여줄 수도 있습니다. 이벤트 필드, 사용자 지정 메타데이터, 이미지 메타데이터 또는 일별·주별로 그룹화할 수 있습니다.
* 최근 이벤트 목록입니다. 최대 25개 행과 12개 열까지 표시할 수 있습니다. 열에는 기본 이벤트 필드나 이벤트와 함께 전송되는 사용자 지정 메타데이터를 표시할 수 있습니다.
* 요약 [운영자 피드백](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/operator-feedback.md).

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-4cfa717440581e2503d419edd24cd0b3199ea34d%2Fsummary-report-viewer-tables.png?alt=media" alt="A report section with events grouped by site and a list of the 10 most recent quality check events"><figcaption><p>사이트별로 그룹화된 표와 최근 이벤트 목록입니다.</p></figcaption></figure>

Agent에 열 이름을 바꾸거나 원시 값 대신 알아보기 쉬운 이름을 표시해 달라고 요청할 수 있습니다(예: 스트림 ID "lane-1"을 "Lane 1"로 표시). 기기별로 그룹화된 지표나 열에는 기기 인벤토리의 기기 이름이 표시되며, 이름이 없으면 원시 기기 ID가 표시됩니다. 기기 이름은 보고서가 실행될 때 불러오므로 나중에 기기 이름을 바꿔도 이미 발송된 보고서는 변경되지 않습니다.

## 일정 및 수신자

보고서 실행 시점이나 수신자를 변경하려면 "Reports" 탭을 열고 보고서 카드의 일정을 클릭합니다(예: "매주 월요일 09:00(America/New\_York)"). 설정을 변경한 다음 "Apply Changes"를 클릭합니다. Agent에 요청할 수도 있습니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-e86feca9b28b65cc8edbf78f39dae51186eff687%2Fsummary-report-schedule.png?alt=media" alt="The Schedule and Recipients dialog set to Weekly, Monday, 09:00, America/New_York, a 7 day lookback, and one recipient" width="375"><figcaption><p>보고서 자체는 변경하지 않고 일정과 수신자를 변경합니다.</p></figcaption></figure>

<table data-search="false"><thead><tr><th width="200">설정</th><th>옵션</th></tr></thead><tbody><tr><td>주기</td><td>매일, 매주, 격주 또는 매월</td></tr><tr><td>요일</td><td>매주 및 격주 보고서에 적용</td></tr><tr><td>날짜</td><td>매월 보고서에 적용됩니다. 해당 월에 날짜가 없으면 마지막 날에 보고서가 발송됩니다.</td></tr><tr><td>발송 시간</td><td>보고서 발송 시각</td></tr><tr><td>시간대</td><td>발송 시간, 각 보고서의 집계 기간, 차트의 일별 또는 주별 구간에 적용됩니다.</td></tr><tr><td>조회 기간(일)</td><td>각 실행에서 조회할 일수(1~90일)입니다. Workspace의 <a href="https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events.md#data-retention">데이터 보존 기간</a> (기본값: 14일)을 초과할 수 없습니다.</td></tr><tr><td>수신자</td><td>Workspace 구성원을 최대 25명까지 추가할 수 있습니다. 이름이나 이메일로 검색하세요.</td></tr></tbody></table>

### 각 보고서의 집계 범위

각 보고서는 온전한 하루 단위로 집계됩니다. 보고서 시간대를 기준으로 발송일 이전의 조회 기간을 자정부터 자정까지 집계합니다. 이벤트는 이벤트 자체의 타임스탬프를 기준으로 계산됩니다.

* 화요일 9시에 발송되는 일일 보고서에는 월요일 하루 전체가 포함됩니다. 화요일 오전의 이벤트는 수요일 보고서에 포함됩니다.
* 조회 기간이 7일인 주간 보고서가 월요일에 발송되면 이전 월요일부터 일요일까지의 데이터가 포함됩니다.

누락되는 날이 없도록 조회 기간을 주기에 맞추세요(일일은 1일, 주간은 7일, 격주는 14일). 조회 기간이 보고서 발송 간격보다 짧으면 Agent가 알려줍니다. 월간 보고서의 조회 기간은 데이터 보존 기간을 초과할 수 없습니다. 따라서 기본값인 14일을 사용하면 해당 월의 마지막 14일이 포함됩니다.

### 보고서 도착 시점

보고서는 설정한 시각에서 몇 분 뒤에 발송됩니다. 보고서 발송 예정일에 오늘의 발송 시각이 지난 뒤 보고서를 저장하면 첫 보고서는 한 시간 이내에 발송됩니다. 그렇지 않으면 다음 발송 예정일에 발송됩니다. 인도처럼 UTC 오프셋이 30분 또는 45분인 시간대에서는 정각으로부터 최대 45분 뒤에 보고서가 도착할 수 있습니다.

### 수신자

수신자는 Workspace 구성원이어야 합니다. Roboflow는 발송 전에 매번 구성원 여부를 다시 확인하고, Workspace를 나간 사용자는 수신 대상에서 제외합니다. 저장된 수신자가 더 이상 구성원이 아니면 대화상자에 경고가 표시됩니다.

모든 구성원이 이메일을 받을 수 있지만 전체 보고서를 열려면 Vision Events Reports 보기 권한이 있어야 합니다. 각 수신자의 역할에 해당 권한이 있는지 확인하세요.

이메일은 Workspace 주소인 `roboflow.email` (예: `acme-foods@roboflow.email`)에서 발송되며, 모든 수신자가 한 이메일에 함께 표시됩니다. 보고서가 스팸함에 도착하면 IT 팀에 해당 주소를 허용 목록에 추가해 달라고 요청하세요.

## 보고서 관리

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-acb9d5832dbf192f4b09ce85608887f0a7642534%2Fsummary-report-card.png?alt=media" alt="A report card in the Reports tab showing its schedule, recipient count, lookback, and last send, with See More, Pin, Open With AI, and Delete buttons"><figcaption><p>각 카드에는 보고서가 마지막으로 발송된 시점과 수신자 수가 표시됩니다.</p></figcaption></figure>

"Reports" 탭에서 다음 작업을 할 수 있습니다.

* 제목을 클릭해 보고서 이름을 바꿉니다.
* 카드의 스위치로 보고서를 일시 중지합니다. "Paused" 표시가 나타나며, 다시 켤 때까지 이메일이 발송되지 않습니다. 일시 중지 중 건너뛴 실행분은 나중에 발송되지 않습니다.
* Use Case당 최대 5개의 보고서를 고정할 수 있습니다. 고정된 보고서는 Use Case에 전용 탭으로 표시되며, 최신 결과를 Workspace의 모든 구성원이 볼 수 있습니다.
* "Open With AI"를 클릭하면 Agent에서 보고서를 다시 열어 채팅으로 수정할 수 있습니다. 수정이 끝나면 "Save Changes"를 클릭하세요. 그전까지는 저장된 버전이 계속 실행됩니다.
* 보고서를 삭제합니다.

{% hint style="warning" %}
보고서를 삭제하면 해당 보고서가 생성한 과거 보고서도 모두 삭제됩니다. 이메일 발송을 중단하면서 기록은 보존하려면 보고서를 일시 중지하세요.
{% endhint %}

카드에는 마지막 실행 결과가 표시됩니다. "Sent"와 함께 발송 시각 및 수신자 수가 표시되거나, "Last report failed to generate" 또는 이메일 발송 실패 사유와 함께 "Generated"가 표시됩니다.

Vision Events 페이지의 Use Case 표에는 각 Use Case의 보고서 수를 보여 주는 "Reports" 열이 있습니다. 이 열을 클릭하면 "Reports" 탭이 열립니다. 보고서가 없는 Use Case에는 "Add"가 표시됩니다.

## 과거 보고서

실행할 때마다 발송 당시의 보고서가 저장됩니다. 저장된 보고서는 나중에 변경되지 않으며, 보고서에 포함된 이벤트가 데이터 보존 기간을 벗어난 뒤에도 그대로 유지됩니다.

<figure><img src="https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-6017d862c87f88995686b173455d42c95d455e52%2Fsummary-report-history.png?alt=media" alt="Report history with a Nov 2 to Nov 9 run marked Notified, its headline numbers, and View report and Re-notify buttons"><figcaption><p>각 실행 결과는 주요 수치와 함께 저장됩니다.</p></figcaption></figure>

보고서 카드에서 "더 보기"를 클릭하면 기록을 확인할 수 있습니다. 이전 보고서마다 다음 작업을 할 수 있습니다.

* "보고서 보기"를 클릭해 엽니다.
* "다시 알림"을 클릭하면 현재 보고서 수신자에게 링크를 이메일로 다시 보냅니다.

이전 보고서를 보는 중에 "최신 데이터로 새로 고침"을 클릭하면 최신 데이터로 같은 보고서를 실행합니다. 새로 고친 보기는 저장되거나 이메일로 전송되지 않습니다.

예약된 시간을 기다리지 않고 지금 보고서를 보내려면 "AI로 열기"를 클릭한 다음 "지금 이메일 보내기"를 클릭합니다. 보고서에는 지금까지의 Lookback Days가 포함되고, 기록에 "요청 시"로 저장되며, 다음 예약 전송에는 영향을 주지 않습니다.

## 제한 및 비용

* 섹션: 보고서당 1\~8개입니다. 이벤트 목록에는 최대 25개 행이 표시됩니다.
* 수신자: Workspace 구성원을 최대 25명까지 지정할 수 있습니다.
* 조회 기간: 1\~90일이며, Workspace의 데이터 보존 기간을 초과할 수 없습니다. 나중에 보존 기간이 단축되면 보고서에는 단축된 기간이 적용되고 그 사실이 표시됩니다.
* 고정 항목: Use Case당 최대 5개입니다.
* 재시도: 보고서 생성에 실패하거나 이메일 전송에 실패하면 Roboflow는 해당 날짜가 끝날 때까지 매시간 다시 시도합니다. 한 섹션이 실패하더라도 보고서는 전송되며, 누락된 섹션이 표시됩니다.
* 보관된 Use Case: Use Case가 보관된 동안 보고서 전송이 중단되고, 보관을 해제하면 다시 시작됩니다.
* Workspace 이메일 제한: 각 Workspace는 분당 이메일 10개, 하루 이메일 1,000개를 보낼 수 있으며, 다음 이메일과 한도를 공유합니다. [이벤트 없음 알림](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/no-events-alerts.md), [자동화](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/automations.md) 이메일 및 Workflow 이메일 블록. 한도에 도달한 보고서는 다음 시간에 다시 시도합니다. 한 Workspace에서 여러 보고서의 전송 시간이 같다면 서로 다른 시간대로 분산하세요.
* 크레딧: Agent에서 보고서를 만들고 수정하면 다른 Agent 대화와 마찬가지로 Agent 크레딧을 사용합니다. 예약 실행에는 AI가 사용되지 않습니다. 보고서 이메일 한 통당 수신자 수와 관계없이 크레딧 0.01개가 사용됩니다. Workspace 사용량이 일시 중지되었거나 크레딧이 부족하면 이메일이 전송되지 않습니다.
* 보고서는 Roboflow 웹 앱이나 Agent를 통해 설정합니다. API를 통해서는 만들 수 없습니다.

## 권한

두 가지 [권한이](https://docs.roboflow.com/platform/enterprise-features/role-based-access-control) 보고서를 제어합니다.

* Vision Events 보고서 보기: "보고서" 탭, 보고서 및 기록을 확인하고 이메일 링크를 통해 전체 보고서를 볼 수 있습니다.
* Vision Events 보고서 관리: 보고서를 만들고, 수정하고, 이름을 변경하고, 고정하고, 일시 중지하고, 삭제하고, 다시 알리고, 지금 이메일로 보낼 수 있습니다.

Workspace 소유자는 기본적으로 두 권한을 모두 가집니다. Agent는 사용자의 권한으로 작업하므로 사용자가 할 수 있는 경우에만 보고서를 저장하거나 전송할 수 있습니다. 보고서 생성, 변경, 삭제, 재전송 및 요청 시 전송은 Workspace [감사 로그](https://docs.roboflow.com/platform/enterprise-features/audit-logs-and-siem-export).

## 자주 묻는 질문

### Workspace 외부 사람에게 보고서를 보낼 수 있나요?

직접 보낼 수는 없습니다. 수신자는 Workspace 구성원이어야 합니다. Vision Events 보고서 보기 권한이 있는 역할로 초대하거나 이메일을 전달하세요. 주요 수치는 이메일에 표시되며, 링크를 열려면 Roboflow에 로그인해야 합니다.

### 일일 보고서에 오늘 아침 이벤트가 포함되지 않는 이유는 무엇인가요?

각 보고서에는 이미 끝난 날짜의 전체 이벤트가 포함됩니다. 오전 9시에 전송되는 일일 보고서는 어제의 이벤트를 다루므로 오늘 아침 이벤트는 내일 보고서에 표시됩니다. 자세한 내용은 [각 보고서에 포함되는 내용](#what-each-report-covers).

### 보고서가 전송된 후에 일부 이벤트가 도착했습니다. 보고서가 업데이트되나요?

아니요. 전송된 보고서는 고정된 스냅샷입니다. 보고서를 열고 "최신 데이터로 새로 고침"을 클릭하면 이후에 수신된 모든 이벤트를 포함할 수 있습니다. 이벤트는 해당 이벤트의 타임스탬프를 기준으로 분류되므로 늦게 도착한 이벤트(예: 오프라인 상태였던 엣지 기기에서 온 이벤트)는 실제 발생한 날짜에 포함됩니다.

### 보고서를 더 이상 받지 않으려면 어떻게 해야 하나요?

Vision Events 보고서 관리 권한이 있는 사람에게 수신자 목록에서 본인을 삭제해 달라고 요청하세요. 수신자가 이메일에서 직접 구독을 취소할 수는 없습니다.

### 보고서에 통과율이나 실패율을 백분율로 표시할 수 있나요?

보고서에는 통과 횟수와 실패 횟수를 나란히 표시할 수 있습니다. 표시되는 유일한 백분율은 Operator Feedback 판정(예: 잘못된 것으로 표시됨)이 있는 이벤트의 비율입니다.

### 보고서 하나에 여러 Use Case를 포함할 수 있나요?

아니요. 보고서 하나에는 Use Case 하나만 포함됩니다. 각 Use Case에 보고서를 만들거나 [Agent에 요청해](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/query-events.md#ask-the-agent) 여러 Use Case를 대상으로 한 번만 질문하세요.
