이벤트 쿼리

대시보드와 API를 통해 Vision Events를 검색, 필터링, 탐색하세요.

이벤트 쿼리 및 필터링

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

대시보드에서 이벤트 탐색

사용 사례 선택

Vision Events 페이지에서 사용 사례를 클릭하여 해당 이벤트를 확인하세요. 이벤트는 최신순으로 표시됩니다.

이벤트 필터링

이벤트 목록 상단의 필터 컨트롤을 사용해 다음 기준으로 결과를 좁히세요:

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

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

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

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

• 워크플로우 — 이벤트를 생성한 워크플로우로 필터링

• 탐지 클래스 — 특정 감지 객체 클래스로 필터링

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

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

이벤트 세부정보 보기

목록의 아무 이벤트나 클릭하여 전체 세부정보를 확인하세요:

• 예측이 오버레이된 원본 이미지(탐지, 분류, 세그멘테이션)

• 모든 소스 메타데이터(디바이스, 스트림, 워크플로우)

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

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

API를 통해 이벤트 쿼리

query 엔드포인트는 대시보드와 동일한 필터를 지원하며, 커서 기반 페이지네이션도 제공합니다.

기본 쿼리

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",
      "solution": "assembly-line-qa",
      "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"]
}

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

다음을 사용하세요 customMetadataFilters 를 사용해 자체 메타데이터 필드로 이벤트를 필터링하세요:

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