アクティビティログ
Activity Logには最新のトラフィックがリアルタイムで表示されます。個別の呼び出しのデバッグ、レスポンスコードの確認、新しい統合が正常に動作しているかの検証に使用します。
Product
ページを開くと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 method、ターゲットドメイン。ドメインでソートされます。 |
| Status | スラッシュで区切られた1つのセル内の2つの値。FourAへの呼び出しのHTTP status、続いてターゲットが返したstatus。ダッシュ記号はターゲットからの応答がなかったことを示します。 |
| Outcome | requestの分類 (Success、Client Error、Rate Limitedなど) |
| Duration | 合計レスポンス時間 (ミリ秒) |
| Bytes | 1つのセルでの双方向の転送量。下矢印はrequestペイロード、上矢印はレスポンスを示します。premiumトラフィックを使用した行には、このセルにpremiumマークが付きます。これにはpremium exitが試行されて標準プールが応答した場合も含まれ、そのトラフィックは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ドロップダウンを使用して、特定の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時間のものです。履歴データについては、日次および週次でデータを集計するMetricsセクションを使用してください。
Auto Calls
Autoの行は1回の呼び出しを表します。2行目にはAutoが実行した試行回数と成功数が表示され、CreditsとBytesにはそれらの試行の合計値が示されます。呼び出し終了直後の数秒間はattempts settling…と表示され、その後データが自動的に入力されます。Autoが処理を試みる前に拒絶された呼び出しにはno attempts recordedと表示されます。
行を開くと、Attemptsテーブル(Engine、Rung、Status、Outcome、Time、Bytes、Credits)が表示されます。試行回数はSingle、Proxy Finder、およびBrowserのリミットに対してカウントされますが、request数や成功率にはカウントされません。
リクエストを開く
任意の行をクリックすると、詳細パネルが開き、完全なrequestおよびresponse payloadのプレビューが表示されます。パネルは行自体のデータから構築されたメタ情報グリッドとともに開くため、保存されたpayloadの有効期限が切れた後でも、タイムスタンプ、キー、HTTP status、アプリstatus、outcome、所要時間、credits、proxy、requestのX-FourA-Request-Idなどを確認できます。
グリッドの下には、タブで選択したペインが1つずつ表示されます。
| タブ | 表示内容 |
|---|---|
| Request | 送信された正確なbodyの整形済みJSON |
| Response headers | ターゲットが返したheader(リダイレクトホップごとに1ブロック)。ターゲットがリダイレクトされた場合、タブにホップ数が表示されます。 |
| Response body | 保存されたbodyのプレビュー(該当する場合はtruncatedおよびbinaryバッジ付き) |
| Other fields | status、タイミング、proxy、header以外にエンジンが返したその他のフィールド。追加情報がない場合は非表示になります。 |
Copyボタンをクリックすると、現在開いているペインの内容がコピーされます。payloadは24時間保持され、APIキーごとに最新200件まで保存されます。それを超えた古い行は、payloadなしで行情報のみが表示されます。
Bodyペインのメッセージ
bodyペインには、状況に応じて異なるプレースホルダーテキストが表示されます。
| メッセージ | 意味 |
|---|---|
(no body — the request failed: <error>) |
ターゲットがbodyを返す前にrequestでエラーが発生しました |
(no body captured for this request) |
payloadの有効期限が切れたか、保存されませんでした |
(empty body — the server returned 0 bytes) |
ターゲットが実際に空のresponseを返しました |
Playgroundで開く
詳細ダイアログにはOpen in Playgroundボタンがあります。これをクリックすると、アーカイブされたrequestとresponseの両方がPlaygroundフォームに読み込まれます。そこからパラメータを調整してライブAPIに対して再実行したり、requestを再実行せずに返された内容を検査したりできます。
このボタンは、Auto呼び出しや再実行不可能なpayload(サイズ超過のrequestスタブやAPI以外のルート)では無効化され、その理由を示すヒントが表示されます。
プロキシフィード
Product を Proxy に切り替えると、フィードはトンネルごとに1行の表示になり、同じく過去1時間分が対象となります。トンネルとはツールが開いた1つの接続を指します。内部で送信された内容は暗号化されたユーザー独自のトラフィックであるため、各行には接続先、退出経路、確立にかかった時間、転送量が表示されます。
| 列 | 表示内容 |
|---|---|
| Time | トンネルが終了した時刻(相対的な経過時間を併記) |
| Proxy user | 接続を処理した proxy ユーザー |
| 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 が保存するボディも存在しません。
Owner ドロップダウンと表示件数セレクターは同様に機能します。API key ドロップダウンの代わりに、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 を参照してください。
関連情報
- Metrics and Analytics: 両製品の長期的な集計パフォーマンスデータ
- Proxy Port: Proxy フィードがレポートする製品
- Playground: Activity からの request をリプレイ
- Response Headers: request ID とクレジットの取得元
- API Endpoints: request と response の形式
- Organizations: Owner フィルターの対象範囲
- Troubleshooting: 一般的な問題と解決策