> 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/roboflow/roboflow-jp/depuroi/vision-events/query-events.md).

# イベントをクエリ

## Events のクエリとフィルタリング

Vision Events ダッシュボードのフィルターを使って特定のイベントを検索するか、REST API 経由でプログラム的にクエリできます。

### Dashboard で Events を参照

#### Use Case を選択

Vision Events ページで Use Case をクリックすると、その Events を表示できます。Events は新しい順に表示されます。

<figure><img src="/files/7edb5cb53e115468c51a739a7d680c3decb80316" alt="" width="375"><figcaption></figcaption></figure>

#### Events をフィルタリング

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

* **日付範囲** — 開始・終了タイムスタンプ
* **Event type** — quality\_check、inventory\_count、safety\_alert、custom、operator\_feedback
* **Device** — device ID でフィルタリング
* **Stream** — stream または camera ID でフィルタリング
* **Workflow** — Events を生成した Workflow でフィルタリング
* **Detection** — 検出されたオブジェクトクラスでフィルタリング（任意で信頼度しきい値を指定可能）
* **Feedback status** — correct、incorrect、inconclusive、またはフィードバックなし
* **Custom metadata** — 任意のカスタムメタデータフィールドと値でフィルタリング
* **Warnings** — 取り込み警告があった Events のみを表示

Event detail sidebar の値（device ID、stream、quality check result、またはカスタムメタデータの値など）をクリックして、フィルターとしてすばやく追加することもできます。

Filter chips are editable -- アクティブなフィルターチップをクリックすると、削除して再追加しなくても値や演算子を変更できます。

フィルターが適用されると、 **合計件数** 一致する Events の件数が結果一覧の上部に表示されます。この件数は Events 一覧とは別に更新されるため、Events が読み込み中でも、フィルターに一致する Events 数を確認できます。

<figure><img src="/files/00d41330baaf4b32a4e1b3531b87a99a9d4be841" alt="" width="375"><figcaption></figcaption></figure>

#### Event 詳細を表示

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

* ソース画像と出力画像
* すべてのソースメタデータ（device、stream、workflow）
* オブジェクト検出、分類、セグメンテーションと、その信頼度スコア
* Event type 固有のデータ（例: pass/fail の結果、アイテム数、アラートの重大度）
* カスタムメタデータのキー・値ペア

**検出を描画**

イベントに予測データ（オブジェクト検出、インスタンスセグメンテーション、またはキーポイント）が含まれている場合、画像の上に "Draw Detections" チェックボックスが表示されます。これを有効にすると、バウンディングボックス、セグメンテーションポリゴン、ラベルと信頼度スコアをソース画像上に重ねて表示します。

これは、パイプラインが元の入力画像のみを保存していて、別の出力画像を保存せずにモデルが検出した内容を可視化したい場合に便利です。

{% hint style="info" %}
別の出力画像を表示している場合は、すでに検出結果が描画されているため、このチェックボックスは非表示になります。
{% endhint %}

**自動確定された Event**

auto-finalized としてフラグ付けされた Event は、動画のアップロードが完了する前に edge device 上で自動的に閉じられたため、動画はありません。Event には結果と静止画は残ります。Event カードにはインジケーターが表示され、詳細ビューには確定時刻が表示されます。これは、次を通じて同期された Event にのみ適用されます [Edge Device Backup](/roboflow/roboflow-jp/depuroi/vision-events/send-events.md#edge-device-backup).

### API 経由で Events をクエリ

クエリエンドポイントはダッシュボードと同じフィルターに加え、cursor ベースのページネーションをサポートします。パラメータとレスポンスフィールドの完全な一覧は、次を参照してください。 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events).

#### 基本クエリ

```bash
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
  }'
```

**レスポンス:**

```json
{
  "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
}
```

#### ページネーション

結果は cursor を使ってページネーションされます。レスポンスに `nextCursor` 値と `hasMore` が `true`の場合は、次のリクエストで cursor を渡して次のページを取得します:

```bash
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 をクエリ:

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

または複数の Event type（最大20件）:

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

#### Feedback status でフィルタリング

使用 `feedbackStatus` を使って、オペレーターがレビューしたかどうかと評価に基づいて Event を検索します:

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

有効な値: `correct`, `incorrect`, `inconclusive`, `none`。使用 `none` まだレビューされていない Event を検索します。

#### Custom Metadata でフィルタリング

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

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