Skip to main content
Activity Log 監視は BRICKS Foundation デバイスからアプリケーションイベントとスクリーンショットをキャプチャし、クラウドの時系列データベースに保存します。デバイスの動作の分析、ユーザーインタラクションの追跡、アプリケーションの健全性の監視、任意の時点でデバイスに表示されていた内容の視覚的確認に活用できます。
Activity Log 監視は Business プランのワークスペースで利用できます。

ログを有効にする

BRICKS Controller からデバイスの Activity Log を有効にします:
  1. デバイス詳細ページを開く
  2. 設定 > Activity Log に移動する
  3. 有効をオンにする
Device Group タブから Activity Log 設定をデプロイして、グループ内のすべてのデバイスのログを有効にすることもできます。

イベント ID フィルター

イベント ID フィルターフィールドを使って、どのイベントをログに記録するかを制御する正規表現パターンを設定します。ID がパターンに一致するイベントのみがキャプチャされます。空白にするとすべてのイベントがログに記録されます。

ログに記録される内容

イベント

各ログエントリには以下が含まれます: イベントは 3 つのカテゴリに分類されます:

スクリーンショット

スクリーンショットキャプチャが有効な場合、BRICKS Controller からスクリーンショットをトリガーでき、JPEG 画像として Activity Log サーバーにアップロードされます。スクリーンショットはタイムスタンプが付けられデバイスごとに保存されるため、任意の時点でデバイスに表示されていた内容を視覚的に確認できます。 スクリーンショットの用途:
  • 視覚的な監査 — キャンペーンや特定の時間帯に正しいコンテンツが表示されていたことを確認する
  • インシデント調査 — 異常が発生した際にデバイスに何が表示されていたかを確認する
  • リモート監視 — 物理的なアクセスなしにデプロイ済みデバイスの状態を視覚的に確認する

イベントのアップロード方法

イベントはデバイスでキャプチャされ、ローカルにキャッシュされた後、定期的にバッチで Activity Log サーバーにアップロードされます(デフォルト:2 分ごと)。ブラウザ環境では、データ損失を最小限に抑えるためにページのアンロード時に最後のアップロードが自動的にトリガーされます。

スクリーンショット

スクリーンショットキャプチャの仕組み

有効にすると、BRICKS Controller からスクリーンショットをトリガーでき、キャプチャのタイムスタンプが付けられた JPEG 画像として Activity Log サーバーにアップロードされます。サーバーはデバイスごと・タイムスタンプごとに 1 枚の画像を保存します——同じタイムスタンプで再アップロードすると前の画像が上書きされます。 各画像は 5 MB 未満である必要があります。

スクリーンショットの閲覧

スクリーンショットは BRICKS Controller または GraphQL API からタイムスタンプで取得できます。screenshots クエリは利用可能なタイムスタンプのリストを返します。ダウンロード API または BRICKS CLI を使って任意のタイムスタンプの画像を取得してください。

GraphQL でクエリする

Activity Log サーバーはイベントとスクリーンショットをクエリするための GraphQL API を提供します。カスタムダッシュボードの構築、外部分析ツールとの統合、ログ分析の自動化に活用できます。

認証

すべての GraphQL クエリには query_activity_log 権限を持つワークスペース token が必要です。BRICKS Controllerワークスペース設定Tokens で作成してください。

エンドポイント

token を Bearer token として含めます:

クエリ

イベントをクエリする

API はカテゴリ別のクエリ(general_eventsdata_eventslocal_sync_stats)と、カテゴリをまたいだ取得のための統合 events クエリを提供します。同じエンドポイント URL の GraphQL テスト UI でスキーマ全体を確認できます。

利用可能なフィルターフィールド

時間範囲クエリはリクエストあたり 30 日に制限されています。

スクリーンショットをクエリする

BRICKS CLI を使う

BRICKS CLI は一般的なクエリパターンの GraphQL API をラップしています:

Prometheus 互換 API

メトリクスダッシュボード(Grafana など)向けに、Activity Log は Prometheus 互換 API でもクエリできます。エンドポイント URL と使用例はワークスペース設定Activity Log のクエリガイドを参照してください。

データ保持

スクリーンショット

スクリーンショットの保持期間は、アップロード時のワークスペースプランによって決まります: 保持期間を超えたスクリーンショットは自動的に削除されます。プランをアップグレードしても、より低いプランでアップロード済みのスクリーンショットの保持期間は延長されません。

イベント

イベントには固定の保持期間の制限はありません。

ユースケース

  • ユーザー行動分析 — ユーザーが Brick とどのようにインタラクションし Canvas を移動するかを追跡する
  • トラブルシューティング — エラーや予期しない動作の前に何が起きたかを調査する
  • フリート監視 — 複数の展開済みデバイスのイベントパターンを監視する
  • 視覚的な監査 — スクリーンショットを確認して正しいコンテンツが表示されていたことを確認する
  • パフォーマンス追跡 — Generator のレスポンスタイムとイベント頻度を分析する

次のステップ

デバッグパネル

デバイス上のランタイム状態をリアルタイムで検査します。

自動化

デバイスでエンドツーエンドの自動化テストを実行します。