監査ログ

このページの内容

監査ログは、組織内で Performance Hub に対して行われたリクエストの記録です。ブラウザーやアプリで Performance Hub を使用するユーザーからのリクエストと、API キー、MCP 経由で接続された AI エージェント、モデルルーターなどの接続されたツールからのリクエストが対象です。オフィス、店舗、カフェ、会場、クリニック、キャンパス、ジムなど、拠点の種類を問わず、誰がドアを解錠したか、変更が保存されなかったのはなぜか、連携が停止したのはいつかといった疑問に答えるために使用します。

クイックリファレンス

場所： 設定（左下の歯車アイコン） → 監査ログ

使用できるユーザー： 組織内で、組織管理者など、監査ログと ID & アクセス管理を含むロールが必要です。監査ログを使用できるユーザーを参照してください。

目的： Performance Hub で誰が何をしたかを確認し、リクエストが失敗した理由を調べます

Window ボタン、5 つの主要な数値、Request Timeline グラフが表示された監査ログのダッシュボード

図 1：監査ログのダッシュボード。時間枠、主要な数値、リクエストのタイムライン

記録される内容

各ログエントリは、Performance Hub に対して行われた 1 つのリクエストです。次の内容が表示されます。

誰がリクエストを行ったか：ユーザーのメールアドレスです。
どこから： IP アドレスと、リクエストを送信したブラウザーまたはツールです。
何が呼び出されたか： メソッド（たとえば、読み取りの GET や作成の POST）とエンドポイントです。エンドポイントは、/api/door-gate-access/doors/front-entrance/unlock のように、リクエストの対象となった Performance Hub の部分です。
結果： レスポンスステータスです。たとえば、成功の場合は 200、権限がなかった場合は 403 です。
所要時間（ミリ秒単位）です。
送信元： ソースバッジです。たとえば、Performance Hub を使用しているユーザーの場合は web、連携の場合は api-key です。ソースバッジを参照してください。

最近のリクエストについては、送信された内容と返された内容もログエントリに保持されます。ログエントリの読み方を参照してください。

2 つのタブ

タブ	用途
ダッシュボード	時間枠ごとの合計、エラー率、グラフと、最もリクエストの多いエンドポイントとユーザーを表示します。グラフや行をクリックすると、該当するログが開きます。
Logs	リクエストそのものです。一覧を絞り込んで検索し、ログエントリを開いて詳細を確認し、CSV にエクスポートできます。

監査ログを使用できるユーザー

組織内で、組織管理者など、監査ログと ID & アクセス管理を含むロールが必要です。設定メニューに 監査ログ が表示されない場合は、ロールに含まれていません。

表示される組織： ロールに監査ログと ID & アクセス管理の両方が含まれている組織です。Logs タブには、"Viewing logs for 1 organisation" のように組織の数が表示されます。
ロールテンプレート： 組織管理者 テンプレートには監査ログが含まれています。サイトマネージャー と サイトオーナー のテンプレートには含まれていません。ロールテンプレートを参照してください。
カスタムロール： カスタムロールで監査ログを使用できるようにするには、そのモジュールアクセスに監査ログと ID & アクセス管理の両方を含めます。アクセス範囲とモジュールアクセスを参照してください。

監査ログにはユーザーのメールアドレス、IP アドレス、送信内容が表示されるため、必要な人にだけ付与してください。

ログの保持期間

監査ログの保持期間設定により、監査ログを保持する期間が決まります。各ログエントリは 90 日間、その完全なリクエストとレスポンスのペイロードは 7 日間保持されます。

Logs タブの Range メニューには、次のように表示されます。

「監査ログは90日間保持されます。リクエストとレスポンスの完全なペイロードは7日間保持され、その後は短いプレビューのみが残ります。より長い履歴が必要な場合は、サポートにお問い合わせください（追加料金が適用されます）。」

つまり、90 日前までさかのぼって確認できます。最初の 7 日間は、ログエントリに完全なリクエストとレスポンスが保持されます。それ以降は、長い本文は短いプレビューに切り詰められます。7 日経過後：プレビューを参照してください。

できること

ダッシュボードを読む：時間枠ごとのリクエスト量、エラー率、最もリクエストの多いエンドポイントとユーザーを確認します。
リクエストを検索する：時間範囲、メールアドレス、IP アドレス、エンドポイント、組織、施設、メソッド、ステータスで絞り込み、絞り込んだビューを共有します。
ログエントリを読む：誰がどこからリクエストを行い、何が送信されて何が返されたかを確認します。失敗したリクエストについては、エラーのわかりやすい要約を確認できます。
ログをエクスポートする：読み込んだログを CSV ファイルとしてダウンロードします。
調査の例に従う：誰がドアを解錠したか、連携の同期が停止したのはなぜかなど、よくある疑問に対する手順を追った回答です。
よくある質問

ロールテンプレート：監査ログを含むテンプレート
アクセス範囲とモジュールアクセス：カスタムロールに監査ログを付与します
ドア/ゲートアクセス：アクセスログ：すべてのドアとゲートの解錠試行を記録する別の記録です