メトリクス
Metricsページ(サイドバー > Metrics)では、使用状況の詳細な分析ビューを確認できます。このページにはUsageパネルが1つあり、トラフィックをグループ別に分類し、行リストの上に期間全体の合計を表示します。
サマリーカードやタイムラインチャートについては、Dashboard Overviewページを使用してください。
Product
ページ上部にはProduct切り替えスイッチがあります。APIエンドポイントに送信するリクエスト用のAPIと、独自のツールがproxy.foura.ai経由で開くトンネル用のProxyです。トンネルにはリクエスト数やクレジットが存在しないため、製品ごとに専用のUsageパネル、ビュー、スコープ、カラムが用意されています。選択した状態は保持され、#metrics/proxyとしてディープリンク可能です。
Filters
パネル上部のフィルター: Product、Endpoints(APIのみ)、Owner、続いてKey(API)またはProxy user(Proxy)、Period。OwnerとPeriodはOverviewと同じコントロールであり状態を共有するため、2つのページ間を移動しても表示内容がリセットされることはありません。
Owner Filter
Everything、Personal、またはいずれかの所属組織から選択します。1つ以上の組織に所属している場合にのみ表示されます。Ownerを選択するとKeyおよびProxy userのドロップダウンも再構築されるため、前のOwnerの認証情報が残って何も返されなくなる事態を防ぎます。
Key and Proxy User Filters
ページ全体のスコープを単一の認証情報に絞り込みます。アクセス権を持つ認証情報(自身のアカウントおよび所属組織のもの)のみが表示されます。
Period
30M、3H、12H、24H、7D、30D、90D、1Yの8つのピルに加え、暦月、過去6か月、全期間、または正確な日付範囲を指定できるCustomがあります。
Endpoints
API製品では、Single、Proxy Finder、Browser、Autoのいずれかを選択して、カードとテーブルのスコープを特定のエンドポイントに絞り込みます。Auto呼び出しはAutoの下に1回としてカウントされます。エンドポイントを選択している間はConcurrencyスコープを使用できません。
The Usage Panel
このパネルは2つの情報を同時に提供します。テーブル上部のカードは期間全体を示し、含まれるグループ数とそれら全体の合計を表示します。下部のテーブルはそれらのグループの1ページ分であり、選択したカラムでソートされます。
両者が異なるトラフィックを指すことはありません。カードはテーブルの行と同じ期間および同じフィルターを対象とします。「今月アクセスしたドメイン数」を正確に把握できるよう、グループ数は四捨五入されず完全な数値で表示されます。
ビュー、スコープ、または期間を変更すると、データセットは最初のページから再度表示されます。ドメインの4ページ目とクライアントIPの4ページ目は一致しません。
カラムヘッダーをクリックしてソートします。ビューを切り替えるかページをリロードすると、ソート順は降順(最大値が先頭)に戻ります。ヘッダーをCtrlまたはCmdクリックするとリセットされます。
Usage, API Product
3つのビュー:
| View | Groups data by |
|---|---|
| API Key | アクセス権を持つ各キー |
| Client IP | リクエストを送信している送信元アドレス |
| Domain | リクエスト内のターゲットドメイン |
右側のスコープチップにより、カラムとカードの内容が切り替わります。
| スコープ | 表示内容 |
|---|---|
| Bandwidth | リクエスト数、受信バイト数、送信バイト数、およびそれらのバイト数に含まれるプレミアムの割合(合計に追加されるのではなく、合計内に含まれるプレミアム出口経由のトラフィック) |
| Response Time | リクエスト数、最小、平均、最大レイテンシ |
| Concurrency | リクエスト数と同時リクエスト数(API Key ビューのみ) |
| Outcomes | リクエスト数と結果ごとの内訳、および結果ドーナツグラフ |
| Budget | リクエスト数と消費クレジット(すべての結果を含む)。特定のエンドポイントを表示するには、Endpoints 行で選択します |
Budget スコープは、API がリクエストごとにレポートするクレジットメトリクスを読み取ります(Response Headers を参照)。これらの合計は未加工の従量課金消費額です。請求ではプランに対して success 結果のみがカウントされ、Overview の Credits カードには両方が並べて表示されます。
結果ドーナツグラフ
Outcomes スコープでは、パネル内にドーナツグラフが表示され、選択した期間の成功とエラーの内訳が示されます。スライスにカーソルを合わせると、正確なリクエスト数と割合が表示されます。別の内容を表示するテーブルの上に期間全体のグラフを重ねると無関係な情報に見えるため、このグラフはそのスコープでのみ描画されます。
使用量、Proxy 製品
5つのビュー:
| ビュー | データのグループ化基準 |
|---|---|
| Proxy user | アクセス権を持つ各プロキシユーザー |
| Target | 各トンネルが到達したホスト |
| Exit country | トンネルの出口となった国 |
| Client IP | 接続元の address |
| Outcome | 結果とその理由 |
4つのスコープ:
| スコープ | カラム |
|---|---|
| Traffic | Tunnels, Bytes In, Bytes Out, Premium |
| Setup | Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max |
| Outcomes | Tunnels に加え結果ごとに1つのカラム、結果ドーナツグラフ付き |
| Budget | Tunnels, Standard, Premium, Total |
Setup はトンネルが引き渡されるまでの待機時間です。Duration はその後トンネルが開いたまま維持された時間です。Premium はプレミアムネットワーク経由で送信されたトラフィックの部分であり、合計に含まれ、合計に追加されることはありません。
クレジットカラムやリクエスト数を含むスコープはありません。CONNECT 内を通過するのは暗号化されたユーザー自身のトラフィックであるため、ポートはトンネル数とバイト数のみをカウントします。
結果タイプ
すべての API リクエストはいずれか1つの結果に分類されます。課金対象となるのは success のみです。
| Outcome | Layer | Meaning |
|---|---|---|
success |
n/a | request が有効な response を返しました。validate ルールがない場合は HTTP 200 を意味します。validate ルールがある場合は、ステータスに関係なくルールが許容した任意の response を意味します。 |
application_error |
target | ターゲットが HTTP 200 を返しましたが、body にエラーフィールドが含まれていました。 |
application_fail |
target | ターゲットが validate ルールで許容されていない 2xx 以外のステータスを返したか、response をまったく返しませんでした。 |
client_error |
caller | request が FourA から送信される前に拒否されました。不正なパラメータ、不正な形式の proxy 値、またはプライベートアドレスや予約済みアドレスに解決される URL が原因です。 |
rate_limit |
FourA | request が RPM または同時実行制限により拒否されました。Rate Limits を参照してください。 |
service_error |
FourA | エンジンがサーバーエラーを返したか、パースできない body を返しました。 |
service_fail |
FourA | ネットワーク障害。タイムアウト、接続拒否、DNS エラー、クライアントの切断などです。 |
Layer 列はどこに原因があるかを示します。target は呼び出し先サイト、caller はリクエスト側の問題、FourA は FourA 側で処理できなかったことを意味します。
validate.status.accept を使用して特定の 200 以外のコード (例: [200, 403]) を許可した場合、それらは application_fail ではなく success として返されます。分類は生の HTTP コードではなく、ルールに対するエンジンの判定に従います。
proxy ポート経由のトンネルも、2 つの target outcome を除き、同じボキャブラリに分類されます。トンネルの通信内容は暗号化されたトラフィックであるため、FourA は背後にあるサイトが正常に応答したかどうかを確認できません。分類体系の全体像と課金へのマッピングについては、Request Outcomes を参照してください。
関連項目
- Dashboard Overview: サマリーカード、タイムラインチャート、Period および Detail (Detail は Overview のみ)
- Request Outcomes: request およびトンネルの outcome 値の詳細解説
- Response Headers: クレジット消費の発生元
- Proxy Port: Proxy ビューがレポート対象とするプロダクト
- Organizations: Owner フィルターの対象範囲
- API Errors: ネットワーク経由で返されるエラーの形式