Events 조회

dashboard와 API에서 Vision Events를 검색, 필터링, 탐색하세요

이벤트 쿼리 및 필터링

Vision Events 대시보드의 필터를 사용해 특정 이벤트를 찾거나 REST API를 통해 프로그래밍 방식으로 쿼리할 수 있습니다.

대시보드에서 이벤트 탐색

Use Case 선택

Vision Events 페이지에서 Use Case를 클릭해 해당 이벤트를 확인하세요. 이벤트는 역시간순으로 표시됩니다.

이벤트 필터링

이벤트 목록 상단의 필터 컨트롤을 사용해 결과를 다음 기준으로 좁힐 수 있습니다:

• 날짜 범위 — 시작 및 종료 타임스탬프

• 이벤트 유형 — quality_check, inventory_count, safety_alert, custom, operator_feedback

• 디바이스 — 디바이스 ID로 필터링

• 스트림 — 스트림 또는 카메라 ID로 필터링

• Workflow — 이벤트를 생성한 workflow로 필터링

• 탐지 — 탐지된 객체 클래스로 필터링하며, 선택적으로 confidence threshold를 지정할 수 있습니다

• 피드백 상태 — correct, incorrect, inconclusive 또는 피드백 없음

• 사용자 지정 메타데이터 — 모든 사용자 지정 메타데이터 필드와 값으로 필터링

• 경고 — 수집 경고가 있었던 이벤트만 표시

또한 이벤트 세부 정보 사이드바의 값(예: 디바이스 ID, 스트림, 품질 검사 결과 또는 사용자 지정 메타데이터 값)을 클릭하면 이를 필터로 빠르게 추가할 수 있습니다.

필터 칩은 편집할 수 있습니다 -- 활성 필터 칩을 클릭하면 제거했다가 다시 추가하지 않고도 값이나 연산자를 수정할 수 있습니다.

필터가 적용되면, 총 개수 일치하는 이벤트 수가 결과 목록 상단에 표시됩니다. 이 개수는 이벤트 목록과 별도로 업데이트되므로, 이벤트가 아직 로드 중이더라도 필터에 일치하는 이벤트 수를 확인할 수 있습니다.

이벤트 세부 정보 보기

목록의 아무 이벤트나 클릭하면 전체 세부 정보를 볼 수 있습니다:

• 소스 이미지와 모든 출력 이미지

• 모든 소스 메타데이터(디바이스, 스트림, workflow)

• 신뢰도 점수와 함께 표시되는 객체 탐지, 분류, 세그멘테이션

• 이벤트 유형별 데이터(예: 통과/실패 결과, 항목 수, 경고 심각도)

• 사용자 지정 메타데이터 키-값 쌍

Draw Detections

이벤트에 예측 데이터(객체 탐지, 인스턴스 세그멘테이션 또는 키포인트)가 포함되어 있으면 이미지 위에 "Draw Detections" 체크박스가 표시됩니다. 이를 활성화하면 소스 이미지 위에 신뢰도 점수가 포함된 바운딩 박스, 세그멘테이션 폴리곤, 레이블을 오버레이할 수 있습니다.

이 기능은 파이프라인이 원본 입력 이미지만 저장하고 별도의 출력 이미지를 저장하지 않으면서 모델이 탐지한 내용을 시각화하고 싶을 때 유용합니다.

별도의 출력 이미지를 볼 때는 이미 탐지가 렌더링되어 있으므로 체크박스가 숨겨집니다.

API를 통해 이벤트 쿼리

쿼리 엔드포인트는 대시보드와 동일한 필터를 지원하며, 커서 기반 페이지네이션도 지원합니다. 매개변수 및 응답 필드의 전체 목록은 Vision Events API Reference.

기본 쿼리

curl -X POST "https://api.roboflow.com/vision-events/query" \\
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "useCaseId": "assembly-line-qa",
    "startTime": "2026-03-01T00:00:00Z",
    "endTime": "2026-03-31T23:59:59Z",
    "limit": 25
  }'

응답:

{
  "events": [
    {
      "eventId": "evt-789ghi",
      "eventType": "quality_check",
      "timestamp": "2026-03-30T14:30:00.000Z",
      "deviceId": "factory-cam-01",
      "streamId": "line-3",
      "images": [],
      "eventData": { "result": "fail" },
      "customMetadata": {
        "line_id": "line-3",
        "shift": "morning",
        "part_number": "PN-4421"
      }
    }
  ],
  "nextCursor": "eyJ0cyI6IjIwMjYtMDMtMzAifQ==",
  "hasMore": true
}

페이지네이션

결과는 커서를 사용해 페이지네이션됩니다. 응답에 nextCursor 값과 hasMore 가 true포함되어 있으면, 다음 페이지를 가져오기 위해 다음 요청에 커서를 전달하세요:

curl -X POST "https://api.roboflow.com/vision-events/query" \\
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "useCaseId": "assembly-line-qa",
    "limit": 25,
    "cursor": "eyJ0cyI6IjIwMjYtMDMtMzAifQ=="
  }'

계속하려면 hasMore 가 false.

이벤트 유형별 필터링

단일 이벤트 유형을 쿼리합니다:

{
  "useCaseId": "assembly-line-qa",
  "eventType": "quality_check"
}

또는 여러 이벤트 유형을 쿼리합니다(최대 20개):

{
  "useCaseId": "assembly-line-qa",
  "eventTypes": ["quality_check", "operator_feedback"]
}

피드백 상태별 필터링

사용해 feedbackStatus 운영자가 검토했는지와 평가 결과에 따라 이벤트를 찾습니다:

{
  "useCaseId": "assembly-line-qa",
  "feedbackStatus": ["incorrect", "none"]
}

유효한 값: correct, incorrect, inconclusive, none. 사용 none 아직 검토되지 않은 이벤트를 찾습니다.

사용자 지정 메타데이터별 필터링

사용해 customMetadataFilters 를 사용해 사용자 지정 메타데이터 필드로 이벤트를 필터링합니다:

{
  "useCaseId": "assembly-line-qa",
  "customMetadataFilters": [
    { "key": "line_id", "operator": "eq", "value": "line-3" },
    { "key": "shift", "operator": "eq", "value": "morning" }
  ]
}