イベントをクエリする

ダッシュボードおよび API 経由で Vision Events を検索、フィルター、閲覧します

Query と Event のフィルタリング

Vision Events ダッシュボードのフィルタを使って特定の Event を見つけるか、REST API 経由でプログラム的に問い合わせます。

ダッシュボードで Event を閲覧する

Use Case を選択する

Vision Events ページで、Use Case をクリックしてその Event を表示します。Event は新しいものから順に表示されます。

Event をフィルタする

Event 一覧の上部にあるフィルタコントロールを使って、次の条件で結果を絞り込みます:

• 日付範囲 — 開始時刻と終了時刻

• Event Type — quality_check、inventory_count、safety_alert、custom、operator_feedback

• デバイス — デバイス ID でフィルタ

• Stream — stream または camera ID でフィルタ

• Workflow — Event を生成した Workflow でフィルタ

• 検出クラス — 特定の検出オブジェクトクラスでフィルタ

• カスタムメタデータ — 任意のカスタムメタデータのフィールドと値でフィルタ

• 警告 — 取り込み警告があった Event のみを表示

Event 詳細を表示する

一覧内の任意の Event をクリックすると、その詳細全体を表示できます:

• 予測結果を重ねた元画像（検出、分類、セグメンテーション）

• すべてのソースメタデータ（デバイス、stream、Workflow）

• Event Type 固有のデータ（例: 合格/不合格結果、アイテム数、警告の重大度）

• カスタムメタデータのキーと値のペア

API 経由で Event を Query する

query エンドポイントはダッシュボードと同じフィルタに加えて、カーソルベースのページネーションをサポートします。

基本 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.

Event Type でフィルタする

単一の Event Type を Query します:

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

または複数の Event Type（最大 20 個）:

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

カスタムメタデータでフィルタする

使用 customMetadataFilters を使って、独自のメタデータフィールドで Event をフィルタします:

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