アクティビティログ

Activity Logは、最新のAPIリクエストをリアルタイムで表示します。個別のリクエストのデバッグ、レスポンスコードの確認、インテグレーションの動作検証に使用します。

表示内容

ログには過去1時間に行われたリクエストが、最新のものを一番上にして表示されます。各行は以下の9つの列で構成されます:

列	表示内容
Time	リクエストが行われた時間
Key	使用されたAPIキー
Request	コールそのもの: 色付きのプロダクトドット(single、proxy、browser)、HTTPメソッド、ターゲットドメイン。ドメインでソートされます。
Status	1つのセルに2つの値がスラッシュ区切りで表示されます: FourAへのコールのHTTPステータス、次にターゲットが返したステータス。ハイフンはターゲットが応答しなかったことを意味します。
Outcome	リクエストの分類(Success、Client Error、Rate Limitedなど)
Duration	総レスポンス時間(ミリ秒)
Bytes	1つのセルに双方向の転送量: リクエストペイロードは下向き矢印、レスポンスは上向き矢印
Credits	コールで消費されたクレジット(Response Headersを参照)
Client IP	リクエスト元のIPアドレス

列ヘッダーをクリックすると、その列でテーブルをソートします。方向は降順、昇順、オフの順に切り替わります。CtrlまたはCmdクリックでデフォルト(最新順)にリセットされます。

フィルタリング

3つのコントロールでログを絞り込みます。

APIキーによる絞り込み

APIキーのドロップダウンを使用して、特定のキーからのリクエストを表示します。アクセススコープ内のキーのみがドロップダウンに表示されます。

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

single / proxy / browser セレクタを使用して特定のエンドポイントにフィルタリングします。browser固有のエラーをsingleリクエストから切り離してデバッグする場合に便利です。

件数制限による絞り込み

Activity Logはデフォルトで50件のエントリを表示します。制限セレクタを使用して、表示するエントリ数を変更します:

Limit	備考
10	クイックスキャン
50	デフォルト
100	拡張ビュー
200	最大

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

リクエストを開く

任意の行をクリックすると詳細パネルが開き、完全なリクエストとレスポンスペイロードのプレビューが表示されます。パネルは行自体から構築されたメタグリッド上に開くため、保存されたペイロードが古くなった後でも有用性を維持します(timestamp、key、HTTP status、app status、outcome、duration、credits、proxy、およびリクエストのX-FourA-Request-Id)。

グリッドの下には、タブで選択されたペインが1つずつ表示されます:

Tab	表示内容
Request	送信された正確な本文の整形済みJSON
Response headers	ターゲットが返したヘッダー(タブにカウントが表示されます)
Response body	保存された本文のプレビュー(該当する場合はtruncatedやbinaryバッジが表示されます)
Other fields	ステータス、タイミング、プロキシ、ヘッダー以外でエンジンが返したその他の内容。追加項目がない場合は非表示になります。

Copyボタンは、現在開いているペインをコピーします。ペイロードは24時間保持され、APIキーごとに直近200件まで保存されます。それより古い行は、ペイロードなしで行のみが表示されます。

Bodyペインのメッセージ

発生した状況に応じて、Bodyペインでは異なるプレースホルダーテキストが使用されます。

メッセージ	意味
`(no body — the request failed: <error>)`	ターゲットがボディを返す前にrequestがエラーになった
`(no body captured for this request)`	ペイロードが期限切れになったか、保存されなかった
`(empty body — the server returned 0 bytes)`	ターゲットが実際に空のresponseを返した

Playgroundで開く

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

リプレイ不可能なペイロード(サイズ超過のrequestスタブや非APIルート)の場合、このボタンは無効になり、理由を説明するヒントが表示されます。

Request IDの使用

すべてのAPI responseにはX-Foura-Request-Id headerが含まれます。これを自身の側でログに記録しておけば、サポートチケットに貼り付けてActivity Log内の特定のrequestを指摘できます。このIDは、このダイアログで使用されているものと同じであり、APIによって返されるX-Foura-Request-Idと一致します。詳細はResponse Headersを参照してください。