Developer Hub の Request logs タブには、貴組織の /v1 API トラフィックが表示されます。検索可能な個別リクエストのログの上部に、過去 24 時間の概要統計（リクエスト数、エラー率、レート制限されたリクエスト数）が表示されます。
各エントリに記録される内容
ログテーブルには、各呼び出しの時刻、HTTP メソッド、パス、レスポンスステータス、ポリシー判定、レイテンシ、リクエスト ID が表示されます。エントリを開くと、呼び出しを行ったサービスアカウントと API キー、送信元 IP、適用されていた権限など、詳細をすべて確認できます。
ポリシー判定は、リクエストがどのように処理されたかを示します。
- Allowed — リクエストは認証され、認可されました。
- Denied — リクエストは拒否されました。たとえば、キーに必要な権限がない、有効期限が切れている、または失効されているなどの場合です。
- Rate limited — リクエストがリクエスト上限を超えたため、
429 で拒否されました。レート制限を参照してください。
フィルタリングと検索
ログは、サービスアカウント、API キー、HTTP メソッド、ステータスクラス（2xx～5xx）、ポリシー判定、時間範囲、またはパスのプレフィックス（例：/v1/entities）で絞り込むことができます。
リクエスト ID でエラーを追跡する
すべての API レスポンスには Request-Id ヘッダーが含まれており、すべてのエラー本文の request_id フィールドにも同じ値が含まれています。この値をリクエストログの検索に貼り付けると、該当するエントリに直接移動し、リクエストがどのように処理されたかを正確に確認できます。
インテグレーションでエラーが報告された場合は、エラーレスポンスに含まれる request_id を確認してください。これは、お客様側で発生した症状から、実際に何が起きたかを示す正式な記録にたどり着くための最も迅速な手段であり、Living Security サポートにお問い合わせいただく際に併せてお知らせいただきたい値でもあります。
問題の早期発見
- エラー率が上昇している場合は、通常、キーの有効期限切れ、失効、または必要な権限の喪失が原因です。判定でフィルタリングして、失敗している認証情報を特定してください。
- レート制限されたリクエスト数が増加している場合は、ワークロードの負荷が高くなっています。平準化の方法については、レート制限を参照してください。
- 本来アイドル状態であるはずのサービスアカウントからトラフィックが発生している場合は、その認証情報が想定どおりの場所にあるかどうかを確認する必要があります。調査中は、アカウントを無効化してください。
