リクエストの検索

Logs タブには、組織内で行われたリクエストが新しい順に一覧表示されます。上部のフィルターを使用して、一覧を 1 人のユーザー、1 つの IP アドレス、Performance Hub の 1 つの部分、または 1 種類の結果に絞り込み、リクエストをクリックすると詳細が表示されます。

クイックリファレンス

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

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

目的： 誰が何かを変更したか、なぜ何かが失敗したかといった疑問の背景にあるリクエストを見つけます

図 1：Logs タブ。上部にフィルター、左側に一致するリクエスト、右側に選択したリクエスト

Logs タブ

• フィルターバー： 上部に並ぶフィルターです。右側に Live、更新、CSVをエクスポート があります。
• 一覧： 一致するリクエストが新しい順に表示されます。その上には "Viewing logs for 1 organisation"（または表示できる組織の数）が表示されます。各行には、ステータスコード、メソッド、ソースバッジ、日時、エンドポイント、ユーザーのメールアドレス、ミリ秒単位の応答時間が表示されます。
• 詳細： 選択したリクエストです。ログエントリの読み方 を参照してください。

一覧はスクロールすると追加のリクエストを読み込みます。一覧の最後には、"End of results · 5 logs" のように一致したリクエストの数が表示されます。

一覧を絞り込む

1. フィルターバーでフィルターをクリックします（例：Endpoint）。
2. オプションを選択するか、値を入力します。たとえば、Endpoint に /api/door-gate-access/* と入力して Apply をクリックします。
3. フィルターに選択した値が表示され、一覧が更新されます。さらにフィルターを追加して絞り込むことができます。リクエストが表示されるには、すべてのフィルターに一致する必要があります。
4. 1 つのフィルターを解除するには、その × をクリックします。すべて解除するには、フィルターを設定すると表示される Clear をクリックします。

図 2：フィルターバー。Range、Email、IP、Endpoint、Org、施設、Method、Status、続いて Live、更新、Export CSV

Email と IP には完全な値が必要

Email と IP は完全一致のみを検索します。ruby.castellano@example.com のようにメールアドレス全体、または IP アドレス全体を入力してください。ruby や 203.0.113 のようなアドレスの一部では何も見つかりません。

完全なアドレスがわからないユーザーを探すには、ダッシュボード の Top Users を使用するか、そのユーザーのリクエストを 1 つ開いて User フィールドからアドレスをコピーします。

範囲

Range をクリックして、どこまでさかのぼって確認するかを選択します。

• プリセット： Last 15 minutes、Last hour、Last 12 hours、Last 24 hours、Last 7 days、Last 30 days、Last 90 days です。
• 日付： 2 か月分のカレンダーで開始日と終了日を選択し、Apply をクリックします。範囲を変更せずにメニューを閉じるには Cancel をクリックします。90 日より前の日付は選択できません。

メニュー下部の注記には、ログの保持期間が "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)." と表示されます。

図 3：Range。プリセットまたはカレンダーで日付を選択します。注記にはログの保持期間が表示されます

エンドポイントとワイルドカード

エンドポイントは、/api/door-gate-access/doors/front-entrance/unlock のように、リクエストの送信先のパスです。リクエストの対象となった Performance Hub の部分がわかります。

• * を使用しない場合、パスのどの部分でも一致します。たとえば、unlock と入力すると、パスに "unlock" を含むすべてのリクエストが見つかります。
• * を使用する場合、星と星の間にある各部分がすべてパスに含まれている必要があります。たとえば、/api/door-gate-access/* ではドア/ゲートアクセスのすべてのリクエストが、/partner/v1/* では Partner API を使用する連携からのすべてのリクエストが見つかります。

図 4：Endpoint では * ワイルドカードを使用できます（例：すべてのドアのリクエスト）

図 5：エンドポイントのパターンで絞り込んだ後の一覧

どのエンドポイントを使用すればよいかわからない場合は、自分で解錠したドアなど、内容がわかっているリクエストを開き、詳細からエンドポイントの先頭部分をコピーします。

ステータス

Status をクリックして、レスポンスステータスで絞り込みます。Search… に入力すると、ステータスをすばやく見つけられます（例："403"）。すべてのステータスを表示するには Any を選択します。

ステータスは、200 OK、201 Created、400 Bad Request、401 Unauthorised、403 Forbidden、404 Not Found、409 Conflict、429 Too Many Requests、500 Server Error、503 Service Unavailable のように名前付きで一覧表示されます。それぞれの意味については、ステータスコード を参照してください。

図 6：レスポンスステータスで絞り込む

Live と更新

Logs タブでは、Live は既定で Off になっているため、調査中に一覧が動くことはありません。新しいリクエストが届く様子を確認するには、Live をオンにして一覧の更新間隔を選択します。一覧を 1 回だけ再読み込みするには、更新ボタン（円形の矢印）をクリックします。

絞り込んだビューを共有またはブックマークする

フィルターはページのアドレスに保存されます。同じビューに戻るにはページをブックマークし、同僚にはアドレスを送信します。同僚が監査ログと同じ組織にアクセスできる場合は、同じ絞り込み済みの一覧が表示されます。

たとえば、末尾が /audit-logs/logs?email=priya.shah%40example.com のアドレスはそのユーザーで絞り込んだ一覧を開き、末尾が /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* のアドレスはすべてのドアのリクエストを開きます。

一覧内を移動する

• リクエストをクリックすると、右側に詳細が開きます。
• 上 と 下 の矢印キーを使用すると、一覧の前または次のリクエストに移動します。
• 幅の狭い画面では、詳細は一覧の上に重ねて開きます。一覧に戻るには、閉じるボタンをクリックします。

結果がない場合

一致するものがない場合、一覧には "No logs match these filters" と "Try widening the time range or clearing a filter." と表示されます。

図 7：一致するリクエストがありません。範囲を広げるか、フィルターを解除してください

探しているものを見つけるには、次のようにします。

• Last 7 days など、より長い Range を選択します。
• Email と IP にアドレス全体が入力されていることを確認します。アドレスの一部では何も見つかりません。
• × でフィルターを 1 つずつ解除するか、Clear をクリックします。

関連ページ

• ログエントリの読み方：各リクエストに表示される内容
• ログのエクスポート：一覧を CSV ファイルとしてダウンロードします
• 調査の例：よくある疑問に使用するフィルター
• ダッシュボード：グラフをクリックすると、該当するログが開きます