stream-inspector

Stream Inspector

目的

Lytics に流入するデータストリームを調査します。利用可能なストリームの一覧表示、統計情報の確認、最近のイベントの閲覧ができます。データ収集のデバッグ、連携の検証、流入データの形式の把握に役立ちます。

環境

認証済みの API アクセスが必要です。認証情報の解決については ../references/auth.md を参照してください。

API エンドポイント

ストリームの一覧表示

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

ストリーム名の取得

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/names" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

ストリームフィールドの取得

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/fields" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

特定のストリームの取得

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/${STREAM_NAME}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

ストリーム統計

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/${STREAM_NAME}/stats" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

最近のイベント

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream/${STREAM_NAME}/events" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

動作

すべての操作は読み取り専用で、ただちに実行されます。

ストリームの一覧表示

すべてのストリームの概要表を表示します。

• ストリーム名、イベント数、最終イベント時刻、フィールド数

ストリーム統計

主な指標を表示します。

• イベント総数、秒・分・時間あたりのイベント数
• エラー率、処理レイテンシ
• アクティブ／非アクティブの状態

最近のイベント

最新のイベントを次の情報とともに表示します。

• タイムスタンプ、主要なフィールド、イベントタイプ
• エラーや異常があれば強調表示します
• イベントが複雑な場合は、概要を表示して個別のイベントを詳しく調べるよう提案します

ユースケース

• 「どのようなデータが流入していますか？」→ ストリームの一覧と統計を表示
• 「連携は機能していますか？」→ ストリーム統計で最近のイベントを確認
• 「データはどのような形式ですか？」→ 最近のイベントを閲覧
• 「プロファイルが更新されないのはなぜですか？」→ ストリームのエラーを確認

エラー処理

• ストリームが見つからない場合：利用可能なストリームを一覧表示します
• イベントがない場合：連携がアクティブかどうかを確認し、ジョブのステータスを確認するよう提案します

依存関係

• 使用するもの：../references/auth.md、../references/api-client.md