アクティビティログ

アクティビティログは、直近のAPI requestをリアルタイムで表示します。個々のrequestのデバッグ、responseコードの確認、インテグレーションが正常に動作しているかの検証に使用します。

表示される情報

ログには過去1時間以内に行われたrequestが、最新のものを上にして表示されます。各エントリーには以下が含まれます。

フィールド	説明
タイムスタンプ	requestが送信された日時
メソッド	ターゲットに送信されたHTTPメソッド（GET、POSTなど）
ルート	使用されたFourAのendpoint（single、proxy、またはbrowser）
ドメイン	request URLから抽出されたターゲットドメイン
ステータス	ターゲットから返されたHTTPステータスコード
アプリステータス	response bodyで返されたアプリケーションレベルのステータス
結果	requestの分類（success、client_error、rate_limitなど）
所要時間	ミリ秒単位の総response時間
送信バイト数	requestペイロードのサイズ
受信バイト数	responseペイロードのサイズ
キー名	使用されたAPIキー
クライアントIP	requestを送信したIPアドレス

フィルタリング

3つのコントロールでログを絞り込むことができます。

APIキーによる絞り込み

APIキーのドロップダウンを使用して、特定のキーからのrequestを表示します。アクセス権限の範囲内にあるキーのみがドロップダウンに表示されます。

プロダクトによる絞り込み

single / proxy / browserセレクターを使用して、特定のendpointにフィルターを適用します。single requestとは別に、browserのみの失敗をデバッグしたい場合に便利です。

表示件数による絞り込み

アクティビティログのデフォルト表示件数は50件です。表示件数セレクターを使用して、表示するエントリー数を変更できます。

表示件数	備考
10	クイックスキャン
50	デフォルト
100	拡張表示
200	最大

すべてのエントリーは過去1時間以内のものです。過去の履歴データについては、数日または数週間単位でデータを集計するMetricsセクションを使用してください。

Requestの詳細表示

任意の行をクリックすると、詳細ダイアログが開き、完全なrequestおよびresponseペイロードのプレビューが表示されます。ダイアログには以下が表示されます。

メタグリッド: タイムスタンプ、キー、HTTPステータス、アプリステータス、結果、所要時間、およびrequestのX-Foura-Request-Id。
Request: 送信された正確なbodyを整形したJSON。コピーボタン付き。
Response: メタ情報とbodyのプレビュー。必要に応じて、切り捨て（truncated）やバイナリ（binary）のバッジが表示されます。

ペイロードは24時間保存され、APIキーごとに直近の200件までに制限されます。それより古い行は行のみが表示され、詳細ダイアログは開きません。

Bodyペインのメッセージ

Bodyペインは、状況に応じて異なるプレースホルダーテキストを表示します。

メッセージ	意味
`(no body — the request failed: <error>)`	ターゲットがbodyを返す前にrequestがエラーになりました
`(no body captured)`	ペイロードの保存期間が経過したか、保存されませんでした
`(empty body — the server returned 0 bytes)`	ターゲットが実際に空のresponseを返しました

Playgroundで開く

詳細ダイアログにはOpen in Playgroundボタンがあります。これをクリックすると、アーカイブされたrequestとアーカイブされたresponseの両方がPlaygroundフォームに読み込まれます。そこからパラメータを調整して本番APIに対して再実行（replay）したり、requestを再実行せずに返ってきた内容を確認したりできます。

このボタンは、再実行できないペイロード（サイズ超過のrequestスタブや非APIルート）の場合には無効化され、その理由を説明するヒントが表示されます。

Request IDの使用

すべてのAPI responseにはX-Foura-Request-Idheaderが含まれています。これを開発者側でログに記録しておけば、サポートチケットに貼り付けて、アクティビティログ内の正確なrequestを特定することができます。このIDはダイアログで使用されているものと同じであり、APIから返されるX-Foura-Request-Idと一致します。詳細については、API Endpointsリファレンスを参照してください。