> 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/workflows/ja/burokku/blocks/advanced-blocks/detection-event-log.md).

# 検出イベントログ

このブロックは、追跡対象オブジェクトからの検出イベントのログを保持します。各追跡対象オブジェクトについて、クラス名、最初と最後に検出されたフレーム番号、絶対的な壁時計時刻のタイムスタンプ（frame\_timestamp メタデータから導出した Unix エポックの浮動小数点数、またはフォールバックとして time.time()）、および動画開始からの経過秒数での相対タイムスタンプを記録します。オブジェクトは、'pending' から 'logged' ステータスに移される前に、最小フレーム数（frame\_threshold）だけ検出されている必要があります。古いイベント（stale\_frames フレームの間検出されなかったもの）は、定期的なクリーンアップ（flush\_interval フレームごと）で削除されます。ログ済みイベントが古くなると、complete\_events 出力に送出されます。これは、十分な長さ追跡されてログに記録され、その後シーンから離れたオブジェクトの完全なイベントデータを含みます。reference\_timestamp パラメータは非推奨で、もはや使用されません。

### 型識別子

ステップで次の識別子を使用してください `"type"` フィールド： `roboflow_core/detection_event_log@v1` ワークフローにこのブロックをステップとして追加するには。

### プロパティ

| **名前**                | **型**   | **説明**                                                                                    | 参照 |
| --------------------- | ------- | ----------------------------------------------------------------------------------------- | -- |
| `name`                | `str`   | このステップの一意の識別子を入力してください。                                                                   | ❌  |
| `frame_threshold`     | `int`   | オブジェクトがログに記録される前に検出されている必要があるフレーム数。                                                       | ✅  |
| `flush_interval`      | `int`   | 古いイベントに対してクリーンアップ処理を実行する頻度（フレーム単位）。                                                       | ✅  |
| `stale_frames`        | `int`   | このフレーム数の間検出されなかったイベントを削除します。                                                              | ✅  |
| `reference_timestamp` | `float` | 非推奨で、もはや使用されません。絶対タイムスタンプは現在、frame\_timestamp メタデータから直接取得されます（またはフォールバックとして time.time()）。 | ✅  |
| `fallback_fps`        | `float` | 動画メタデータに FPS 情報がない場合に使用するフォールバック FPS。相対タイムスタンプの計算に使用されます。                                 | ✅  |

この **参照** 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します `ワークフロー` 実行時。参照 *バインディング* 詳細は。

### ランタイム互換性

`soft` - ランタイム `hosted_serverless`, `dedicated_deployment`；実行 `リモート`；入力 `動画` - 動画入力: ブロックは、プロセスメモリ内で動画ごとの状態を保持します（video\_metadata.video\_identifier でキー付け）。ステートレスまたは複数レプリカの HTTP ランタイムでリモートステップ実行を行うと、連続するリクエストが異なるワーカープロセスで処理される可能性があるため、呼び出し間で状態がリセットされ、出力は追跡／カウント／集計には意味を持ちません。安定したフレーム間結果を得るには、永続的な WebRTC セッションでローカルステップ実行を使用してください。

`soft` - 入力 `画像` - 画像入力: ブロックは動画または連続フレームのワークフローからの時間的コンテキストに依存します。静止画像／写真では、追跡、比較、集計、可視化に意味のある履歴がないため、このブロックの利点はほとんど、あるいはまったくありません。

### 入力と出力のバインディング

利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `検出イベントログ` のバージョン `v1` あるか確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* 入力
  * `画像` ([*`画像`*](/workflows/ja/gaido/developer-guide/kinds/image.md)）：動画メタデータ（フレーム番号、タイムスタンプ）用の画像への参照。
  * `検出` (*Union\[*[*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*]*）：byte tracker による追跡検出（tracker\_id が必要）。
  * `frame_threshold` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：オブジェクトがログに記録される前に検出されている必要があるフレーム数。
  * `flush_interval` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：古いイベントに対してクリーンアップ処理を実行する頻度（フレーム単位）。
  * `stale_frames` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：このフレーム数の間検出されなかったイベントを削除します。
  * `reference_timestamp` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)）：非推奨で、もはや使用されません。絶対タイムスタンプは現在、frame\_timestamp メタデータから直接取得されます（またはフォールバックとして time.time()）。
  * `fallback_fps` ([*`float`*](/workflows/ja/gaido/developer-guide/kinds/float.md)）：動画メタデータに FPS 情報がない場合に使用するフォールバック FPS。相対タイムスタンプの計算に使用されます。
* 出力
  * `event_log` ([`辞書`](/workflows/ja/gaido/developer-guide/kinds/dictionary.md)）：辞書。
  * `検出` (*Union\[*[*`object_detection_prediction`*](/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`instance_segmentation_prediction`*](/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*]*）：sv.Detections(...) 形式の検出バウンディングボックスを含む予測。 `object_detection_prediction` または、sv.Detections(...) 形式の検出バウンディングボックスとセグメンテーションマスクを含む予測。 `instance_segmentation_prediction`.
  * `total_logged` ([`整数`](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：整数値。
  * `total_pending` ([`整数`](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：整数値。
  * `complete_events` ([`辞書`](/workflows/ja/gaido/developer-guide/kinds/dictionary.md)）：辞書。

</details>

<details>

<summary>JSON 定義の例</summary>

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/detection_event_log@v1",
	    "image": "$inputs.image",
	    "detections": "$steps.byte_tracker.tracked_detections",
	    "frame_threshold": 5,
	    "flush_interval": 30,
	    "stale_frames": 150,
	    "reference_timestamp": 1726570875.0,
	    "fallback_fps": 1.0
	}
```

</details>