> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# イベントストリーム

> FailproofAI オブザーバビリティ イベントストリームのドキュメント。

エージェントが何かを実行した瞬間、その動きをリアルタイムで確認できます。イベントストリームは、本番環境で稼働するすべてのエージェントのライブパルスです。待ち時間なし、ログのgrepなし、何が起きたか推測する必要もありません。

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/events-stream.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=dee960f505cf6543f2fe0598c932c5e7" alt="ライブイベントストリーム：色分けされたイベント行がリアルタイムで流れ、環境・エージェント・セッション・イベントタイプ・フリーテキストでフィルタリング可能" width="3200" height="2000" data-path="agenteye/images/events-stream.png" />

*組織内のすべてのエージェントから発生した全イベントが、新しい順に、発生と同時に更新されます。*

## すべてのエージェントのライブパルス

エージェントが実行を開始し、モデルを呼び出し、ツールを起動し、フックを実行し、またはエラーが発生すると、その行が発生した瞬間にストリームの先頭に表示されます。組織内のすべてのエージェントからのすべてのイベントを新しい順にテールするため、常に最新の状況を把握でき、古い情報に悩まされることはありません。

つまり、どこかのサーバーでログファイルをtailする必要も、複数のマシンをまたいでgrepする必要も、タイムスタンプを手作業でつなぎ合わせる必要もありません。1つのページを開くだけで、すでに本番環境を監視できています。

行はタイプ別に色分けされているため、1行ずつ解析しなくても一目でストリームを読み取れます。各行では以下の情報が確認できます：

* **タイプ**（色分け）: `agent_start`、`model_response`、`tool_use`、`hook_completed`、`error` など。
* **何が起きたかの1行サマリー** — 概要を把握するためだけに詳細を開く必要がほとんどありません。
* **ステップのトークン数**。
* **コンテキストウィンドウの使用率バッジ**（該当する場合） — プロンプトの肥大化やコンパクションが近づいていることを、問題が発生する前に把握できます。

ライブで監視することで、問題のあるデプロイ、暴走するループ、エラーの急増を、翌日のログレビューではなくその場で検知できます。

## 問題のある1つの実行を見つける

何かおかしいと感じたとき、膨大なデータの洪水は必要ありません。壊れた1つの実行を特定したいはずです。ストリームは素早くフィルタリングできます：環境、エージェント、セッション、イベントタイプ、またはフリーテキストで絞り込み可能です。

セッションIDまたはエージェントIDでフィルタリングして、最初のイベントから最後のイベントまで1つの実行を追跡できます。イベントタイプでフィルタリングして、特定の種類のアクティビティだけを抽出できます — たとえば、組織全体のすべての `error` を1つのビューで確認するなど。フィルターを組み合わせることで、「すべての環境のすべてのエージェント」から「本番環境でエラーが発生しているこのエージェント」へと数クリックで絞り込み、結果に基づいて対応できます。

フリーテキスト検索で、メッセージ、ツール名、または手元にあるIDに直接アクセスできるため、カスタマーレポートから該当する実行へ数秒で辿り着けます。

## アクセス方法

イベントストリームは組織のホーム画面です。サインインすると最初に表示される画面で、`/<org-slug>/` にあります。到着した瞬間からトリアージを開始できます。

その背後では、エージェントがSDKを通じてイベントを送信し、コレクターがそれをFailproofAI オブザーバビリティサーバーに転送し、ストリームがあなたの管理するインフラストラクチャーに到着したイベントをリアルタイムで表示します。生のイベント履歴ではなく集約されたビューが必要な場合は、各実行のイベントがセッション上の1行にまとめられます（1クリックでアクセス可能）。

これはその他すべてのオブザーバビリティ画面の基盤となる生の真実の情報源です。そのため、他の場所で数値がおかしいと感じたとき、実際に何が起きたかを確認するのはストリームです。

## 関連ドキュメント

* [Sessions](/ja/agenteye/sessions): 同じイベントを実行ごとに1行にまとめ、gitスタイルの実行グラフで表示。
* [Telemetry](/ja/agenteye/telemetry): エージェントが送信する内容とイベントがストリームに届くまでの仕組み。
* [Error tracking](/ja/agenteye/error-tracking): 問題のあるすべての事象を1つのトリアージ画面で管理。
* [Alerts](/ja/agenteye/alerts): 任意のしきい値をアラートルールに変換。
* [CLI and agents](/ja/agenteye/cli-and-agents): ターミナルから同じライブ履歴を確認。
