アクセスログ
このページの内容
アクセスログタブは監査証跡です。成功、拒否、失敗を問わず、またモバイルアプリからか管理者によるものかを問わず、すべての解錠試行が、誰が、どのドアを、いつ、どこから操作したか、そしてその結果とともに記録されます。このページでは、ログの見方、絞り込み、No visit recorded ビュー、CSV へのエクスポート、イベントの詳細ビューについて説明します。
図 1：アクセスログタブ
イベントは約 13 か月 保持された後、自動的に削除されます。ユーザーを削除しても、そのユーザーのイベントは削除されません。履歴は監査証跡のために保持されます。
アクセスログは、Performance Hub 全体で行われたリクエストを記録する監査ログとは別のものです。
絞り込みと検索
図 2：検索、フィルターチップ、列、エクスポート、ライブ更新、範囲
| コントロール | 機能 |
|---|---|
| Search | "Search door, person, event ID…"：ドア、人、イベント ID、コマンド ID、状態、拒否理由に一致するものを検索します |
| View | Door events（監査証跡）または No visit recorded（下記を参照） |
| State、Result、Door、Source、Partner、Reason | イベントの状態、結果、ドア、リクエストの送信元、連携パートナー、拒否理由で一覧を絞り込むフィルターチップ |
| Columns | 表に表示する列を選択します。ボタンには表示中の列の数が示されます |
| CSVをエクスポート | 現在絞り込まれているイベントをダウンロードします（CSV へのエクスポートを参照） |
| Live | 次の更新までのカウントダウンとともに、一覧を自動的に更新します。横のボタンをクリックすると今すぐ更新されます |
| Range | Last day、Last 7 days、Last 30 days、Last 90 days、またはカスタムの日付 |
ヘッダーには、現在の範囲とフィルターでのイベント数が表示されます。各範囲で読み込まれるのは、最新のイベント最大 500 件です。
イベントの状態
| 状態チップ | 意味 |
|---|---|
| Confirmed unlocked | ドアコントローラーがリレーの解放を確認しました。ドアが実際に解錠されています |
| Unlocked | 解錠が成功したと報告されました |
| Admin Unlocked | 管理者が Performance Hub から解錠を実行しました（管理者による上書き）。コマンドが送信された時点で記録されます |
| Denied | リクエストが拒否されました。Reason 列を参照してください（すべての理由） |
| Pending / Request received | リクエストはまだ処理中です（一時的な状態で、通常は数秒以内に解決します） |
| Timed out | 解錠コマンドは送信されましたが、コントローラーが時間内に確認しませんでした。通常はドアでの接続の問題です |
| Failed | エラーにより解錠を完了できませんでした |
| Locked by staff | 自動解錠スケジュールでドアが開放されている間に、スタッフが 今すぐ施錠 を使用しました。解錠試行ではなく、スケジュールのイベントです |
| Schedule resumed | 次の切り替え時刻になったか、スタッフが Resume schedule を押したことで、自動解錠スケジュールが再び有効になりました。解錠試行ではなく、スケジュールのイベントです |
各行には、タイムスタンプ、状態、ドア、人、ドアからの距離、コマンドのレイテンシー（利用可能な場合）、そして拒否されたイベントの場合は拒否理由が表示されます。
訪問記録なし
図 3：No visit recorded ビュー
View を No visit recorded に設定すると、管理者または連携サービスによって追加された単発の Access Time Windows のうち、対象者がその時間枠内（猶予期間を含む）に一度もドアを解錠しなかったものが一覧表示されます。列は Person、Scheduled period、Source / partner、Status です。記録は約 13 か月保持されます。
たとえばオフィスでは、単発の時間枠を持つ業者のうち、誰が来なかったかを確認できます。
Access Policy の帰属
ポリシーによって許可されたイベントには、名前付きのポリシーと、一致した対象者、ターゲット、スケジュールが示されます。スケジュールによる一致には、有効な具体的な開始時刻と終了時刻が含まれる場合もあります。
管理者が所有する Access Time Windows と連携サービスが所有する Access Time Windows は、それぞれ独自の帰属パス（admin_time_window と source_time_window）を保持し、Access Policies として再ラベル付けされることはありません。ポリシーによる拒否では、ターゲット、対象者、非アクティブなスケジュールの不一致が区別されます。将来の発生には、判明している場合は構造化された利用可能時間とともに outside_access_time_window が使用されます。
イベントの詳細
任意の行をクリックすると、Access Details ダイアログが開きます。
図 4：メンバーによる解錠の Access Details ダイアログ
ヘッダーには、ドア、その場所、結果、該当する場合は Admin override バッジ、拒否された場合は拒否理由が表示されます。利用可能な場合に表示されるフィールドは次のとおりです。
| フィールド | 備考 |
|---|---|
| Date / Time | 試行が行われた日時 |
| Coordinates | スマートフォンが報告した位置と GPS の精度（±N m）。コピーできます |
| Door / Gate | ドアの名前と場所 |
| Person または Admin | 試行したユーザー。管理者による解錠では管理者のアカウントが表示されます |
| Device | 使用したスマートフォンまたはデバイス |
| IP Address | リクエスト元の IP。コピーできます |
| Hold time | ドアが解錠されていた時間 |
| Distance from door | ジオフェンスの中心から計算した距離 |
| Event ID / Command ID | サポートへのエスカレーション用の識別子。コピーできます |
| Latency | コントローラーがコマンドに応答するまでにかかった時間 |
| Authorization source | Access Policy、恒久的な付与、管理者の時間枠、または連携サービスの時間枠 |
| Policy | ポリシーの ID または名前と、一致した対象者、ドアまたはアクセス範囲のターゲット、Anytime/Scheduled のモード |
| Window / Source ID | 有効なスケジュール済みの時間枠またはソースの時間枠の限定的な帰属 |
| Active from / to | 時間枠の判定に使用された具体的な発生時刻（Unix 秒）。終了時刻は含まれません |
Unlock Location には、報告された座標が地図上に Open in Google Maps リンクとともに表示されます。座標がない場合は、"No location captured — unlocked from the Performance Hub."（管理者による上書き）または "No location data was reported for this unlock attempt." と表示されます。
CSV へのエクスポート
CSVをエクスポート をクリックすると、現在絞り込まれているイベントがダウンロードされます。ファイルには、ID、ドア、結果、拒否、コントローラー、連携、ポリシーと時間枠の帰属に関するフィールドが含まれます。絞り込んだ一覧が空の場合、ボタンは無効になります。No visit recorded ビューでは、CSVをエクスポート をクリックするとその一覧がダウンロードされます。
ヒント
- ドアタブの Recent activity カードは、このログの 24 時間分へのショートカットです。そこでイベントをクリックすると、ここにある該当のイベントに直接移動します。
- メンバーからの苦情を調査する場合は、State または Result のチップで拒否された試行を表示し、名前を検索して理由を確認します。その後、理由ごとの対処方法についてトラブルシューティングを参照してください。
- ポリシーに関する苦情の場合は、ポリシー名とその Who/Where/When を確認します。連携サービスの時間枠の場合は、ソースの経過時間と
scope_keyのマッピングも確認します。 - 1 つのドアで Timed out のイベントが続けて発生する場合は、通常、そのドアのコントローラーにネットワークの問題があります。ドアタブでステータスを確認してください。
- AIエージェントは MCP を通じてドアのイベントを読み取ることができます。たとえば、訪問者ごとのオフィスロビーのウェルカム表示に利用できます。ドアのイベントにはユーザー ID が含まれ、名前や生年月日は含まれません。
関連ページ
- リファレンス：すべての状態と拒否理由
- Access Policy のスケジュール
- トラブルシューティング
- ドア