アクティビティログ
Activity Logには最新のトラフィックが表示されます。ページを開いたときに読み込まれます。最新の行を取得するには、タイトルの横にある更新ボタンをクリックしてください。個々の呼び出しのデバッグ、response codeの確認、新しい連携の動作確認に使用します。
プロダクト
ページを開くとProductスイッチが表示されます。API endpointに送信するrequestにはAPI、proxy.foura.ai経由で独自のツールが開くトンネルにはProxyを選択します。どちらのフィードも直近1時間を対象とし、同じ件数セレクターを使用します。スイッチの状態は記憶され、#activity/proxyとしてディープリンク可能です。
本ページの以降のセクションでは、まずAPIフィードについて説明し、その後にProxyフィードについて説明します。
APIフィードの表示内容
ログには直近1時間以内に行われたrequestが表示され、最新のものが先頭に並びます。各行は次の9列で構成されます。
| 列 | 表示内容 |
|---|---|
| Time | requestが実行された日時 |
| Key | 使用されたAPI key |
| Request | 呼び出し自体の情報。色分けされたendpointマーク(Single、Proxy、Browser、またはAuto)、HTTPメソッド、ターゲットドメイン。ドメイン順でソートされます。 |
| Status | スラッシュで区切られた1つのセル内の2つの値。FourAへの呼び出しのHTTP status、続いてターゲットが返したstatus。ダッシュはターゲットからの応答がなかったことを示します。 |
| Outcome | requestの分類(Success、Client Error、Rate Limitedなど) |
| Duration | ミリ秒単位の合計response時間 |
| Bytes | 1つのセルでの双方向の転送量。下矢印はrequestペイロード、上矢印はresponseを示します。プレミアムトラフィックを使用した行には、このセルにpremiumマークが付きます。これにはプレミアム出口を試行して標準プールが応答した場合も含まれ、そのトラフィックはプレミアムトラフィックとしてカウントされます。 |
| Credits | 呼び出しで消費されたクレジット(Response Headersを参照) |
| Client IP | requestを送信したアドレス。PlaygroundまたはFourAのホスト型MCPから送信されたrequestには、アドレスの代わりにFourAと表示されます。 |
任意の列ヘッダーをクリックすると、その列でテーブルがソートされます。ソート方向は降順、昇順、オフの順で切り替わります。CtrlまたはCmdを押しながらクリックすると、デフォルト(新しい順)にリセットされます。
フィルタリング
4つのコントロールでログを絞り込みます。
所有者別
1つ以上の組織に所属している場合、最初にOwnerドロップダウンが表示されます(Everything、Personal、または所属組織のいずれか)。これを変更すると隣のkeyドロップダウンが再構築されるため、前の所有者に属するkeyが切り替え後も残って何も返されなくなる事態を防ぎます。Overview、Metrics、およびAPI Keysの同じコントロールもこの選択に追従します。Organizationsを参照してください。
API Key別
API keyドロップダウンを使用して、1つのkeyからのrequestを表示します。アクセス権を持つkeyのみが表示されます(個人のkeyおよび所属組織のkey)。
Endpoint別
ProductをAPIに設定した状態で、Single / Proxy Finder / Browser / Autoチップを使用して1つのendpointに絞り込みます。ブラウザ固有の失敗を単一のrequestと切り離してデバッグする場合に便利です。Autoを選択すると、Autoの呼び出しが1行ずつ一覧表示されます。
リミット別
アクティビティログはデフォルトで50件のエントリを表示します。表示件数を変更するには、リミットセレクターを使用します。
| リミット | 備考 |
|---|---|
| 10 | クイックスキャン |
| 50 | デフォルト |
| 100 | 拡張ビュー |
| 200 | 最大 |
すべてのエントリは過去1時間のものです。履歴データについては、日次および週次でデータを集計するメトリクスセクションを使用してください。
Autoコール
Autoの行は1件のコールを表します。2行目にはAutoが実行した試行回数と成功回数が表示され、CreditsとBytesはそれらの試行の合計値となります。コール終了後の数秒間はattempts settling…と表示され、その後行の内容が入力されます。Autoが処理を試みる前に拒否されたコールにはno attempts recordedと表示されます。
行を開くと、Engine、Rung、Status、Outcome、Time、Bytes、Creditsを含むAttemptsテーブルが表示されます。試行はSingle、Proxy Finder、Browserのリミットにカウントされますが、リクエスト数や成功率にはカウントされません。
リクエストを開く
任意の行をクリックすると詳細パネルが開き、完全なリクエストおよびレスポンスペイロードのプレビューが表示されます。パネルは行自体から構築されたメタグリッド上に開くため、保存されたペイロードの期限が切れた後でも役立ちます。表示項目は、時間、APIキー、クライアントIP、ターゲット、HTTPステータス、アプリステータス、結果、Gateway total(FourAが計測したコール全体)、Upstream fetch(応答した試行に費やされた時間)、バイト数、クレジット、およびリクエストのX-FourA-Request-Idです。該当する場合、Proxy Finderコールのプロキシチェーン(リトライを含むすべてのプロキシ試行)、使用されたプロキシ、レスポンスボディサイズ、およびエンジンのエラーも表示されます。
グリッドの下には、タブで選択されたペインが一度に1つ表示されます。
| タブ | 表示内容 |
|---|---|
| Request | 送信された正確なボディの整形済みJSON |
| Response headers | ターゲットが返したヘッダー(リダイレクトホップごとに1ブロック)。ターゲットがリダイレクトした場合、タブにはホップ数が表示されます。 |
| Response body | 保存されたボディプレビュー。該当する場合はtruncatedおよびbinaryバッジが表示されます |
| Other fields | ステータス、タイミング、プロキシ、ヘッダー以外にエンジンが返したその他の情報。追加情報がない場合は非表示になります。 |
Copyボタンは、現在開いているペインの内容をコピーします。ペイロードは24時間保持され、APIキーごとに最新200件に制限されます。これより古い行には行データのみが表示され、ペイロードは表示されません。
ボディペインのメッセージ
ボディペインには、発生した状況に応じて異なるプレースホルダーテキストが表示されます。
| メッセージ | 意味 |
|---|---|
(no body — the request failed: <error>) |
ターゲットがボディを返す前にリクエストがエラーになりました |
(no body captured for this request) |
ペイロードの期限が切れたか、保存されませんでした |
(empty body — the server returned 0 bytes) |
ターゲットが実際に空のレスポンスを返しました |
Playgroundで開く
詳細ダイアログには Open in Playground ボタンがあります。クリックすると、アーカイブされた request と response の両方が Playground フォームに読み込まれます。そこからパラメータを調整して本番 API に対して再実行することも、request を再実行せずに返された内容を確認することもできます。
このボタンは、Auto 呼び出しおよび再実行不可能なペイロード(サイズ超過の request スタブや非 API ルート)では無効化され、理由を示すヒントが表示されます。
Proxy フィード
Product を Proxy に切り替えると、フィードはトンネルごとに1行の表示になり、同じく過去1時間分が表示されます。トンネルとはツールが開いた1つの接続です。内部で送信された内容は暗号化されたトラフィックであるため、各行には接続先、退出方法、開設にかかった時間、および転送量が表示されます。
| カラム | 表示内容 |
|---|---|
| Time | トンネルが終了した時刻(相対的な経過時間を併記) |
| Proxy user | 接続を処理した proxy user |
| Target | トンネルの接続先ホストとポート |
| Exit | Shared または Premium(判明している場合は退出国の国名も併記) |
| Outcome | Success、Client Error、Service Error、Service Fail、または Rate Limited(拒絶時はその理由) |
| Setup | ツールが接続してからトンネルが引き渡されるまでの時間 |
| Duration | トンネルが開いていた時間 |
| Bytes | 双方向の合計を1つのセルに表示(退出がプレミアムネットワークの場合は premium マーク付き) |
| Client IP | 接続元の IP アドレス |
Status、Credits、ペイロードのカラムはなく、詳細ダイアログもありません。CONNECT にはターゲットからのステータスがなく、FourA が保存する body も存在しません。
Owner ドロップダウンと件数制限セレクターは同様に機能します。API キーのドロップダウンの代わりに、Proxy user ドロップダウンでフィードを特定の認証情報に絞り込めます。すべてのカラムでソートが可能です。
Rate Limited と表示される行は、ターゲットによる拒否ではなく、ご利用プランの制限値によるものです。理由には、同時トンネル数、1分あたりの接続開設数、トラフィック超過、プレミアム利用不可、またはプランに含まれないポートなど、該当する項目が示されます。詳細は Proxy Port を参照してください。
Request ID の使用
すべての API response には X-Foura-Request-Id header が含まれています。これをログに記録しておけば、サポートチケットに貼り付けて Activity Log 内の正確な request を特定できます。この ID は本ダイアログで使用されているものと同じであり、API から返される X-Foura-Request-Id と一致します。詳細は Response Headers を参照してください。
関連情報
- メトリクスとアナリティクス: 両プロダクトの長期間にわたる集計パフォーマンスデータ
- Proxy Port: Proxyフィードがレポート対象とするプロダクト
- Playground: アクティビティからのrequestの再生
- Response Headers: request IDおよびクレジットの取得元
- API Endpoints: requestおよびresponseの構造
- Organizations: Ownerフィルターの対象範囲
- トラブルシューティング: 一般的な問題と解決策