メトリクス
Metricsページ(サイドバー > Metrics)では、使用状況の詳細な分析ビューを確認できます。このページには「使用状況」パネルが1つあり、トラフィックをグループに分類し、期間全体の合計を行の一覧の上に表示します。
サマリーカードやタイムラインチャートについては、ダッシュボード概要ページを使用してください。
プロダクト
ページを開くと、まずProduct(プロダクト)切り替えスイッチが表示されます。APIエンドポイントに送信するリクエストにはAPIを、独自のツールがproxy.foura.ai経由で開くトンネルにはProxyを選択します。トンネルにはリクエスト数やクレジットが存在しないため、プロダクトごとに個別のビュー、スコープ、カラムを持つ独自の「使用状況」パネルが用意されています。選択状態は保持され、#metrics/proxyとしてディープリンクも可能です。
フィルター
パネルの上部には、Product、Endpoints(APIのみ)、Owner、続いてKey(API)またはProxy user(Proxy)、そしてPeriodが配置されています。OwnerとPeriodは「概要」ページと同じコントロールであり状態を共有するため、2つのページ間を移動しても表示内容が意図せず変わることはありません。
所有者フィルター
Everything、Personal、またはいずれかの組織から選択します。この項目は、少なくとも1つの組織に所属している場合にのみ表示されます。所有者を選択すると、KeyおよびProxy userのドロップダウンも再構築されるため、以前の所有者の認証情報が残って何も返されなくなるような事態を防ぎます。
選択した所有者にAPIキーがまったく存在しない場合(停止中のキーを含む)、期間セレクターの下の行に**You have no API keys here yet. Create one to see its usage.**と表示されます。カウント対象がないため、パネルにはゼロが表示されます。詳細はAPIキーの管理を参照してください。
キーおよびProxyユーザーフィルター
ページ全体の対象を単一の認証情報に絞り込みます。アクセス権を持つ認証情報のみが表示されます。具体的には、自身のアカウントのもの、および所属する組織のものです。
期間
30M、3H、12H、24H、7D、30D、90D、1Yの8つのピルボタンに加え、カレンダー月、過去6か月、全期間、または正確な開始日と終了日のペアを指定できるCustomが用意されています。
エンドポイント
APIプロダクトでは、Single、Proxy Finder、Browser、Autoのいずれかを選択して、カードとテーブルの対象を単一のエンドポイントに絞り込みます。Autoの呼び出しは、Autoの下で1回としてカウントされます。特定のエンドポイントを選択している間は、Concurrencyスコープは利用できません。
使用状況パネル
このパネルは2つの疑問に同時に答えます。テーブル上部のカードは期間全体を示し、含まれるグループの数とそれら全体の合計値を表します。下部のテーブルはそれらのグループの1ページ分であり、選択したカラムで並べ替えられます。
カードとテーブルで異なるトラフィックが示されることはありません。カードは各行とまったく同じ期間および同じフィルターで動作します。グループ数は概数ではなく完全な数値で表記されます。「今月アクセスしたドメインの数」に対する正確な答えを提示するためです。
ビュー、スコープ、または期間を変更すると、データセットの表示は最初のページからやり直されます。ドメインの4ページ目とクライアントIPの4ページ目は別物です。
列ヘッダーをクリックしてソートします。API製品のDomainビューおよびClient IPビューでは、リスト全体をソートした後にページ分割されるため、最上位の行が確実に最大値となり、テーブルは最初のページから再度表示されます。API Keyビューはすべてのキーを1つのリストに保持し、その場でソートします。ビューやスコープを切り替えるかページを再読み込みすると、ソートはスコープ固有の順序(リクエスト数が最も多い順、またはRoutesではAutoによるブラウザ試行数が最も多い順)に戻ります。CtrlまたはCmdを押しながらヘッダーをクリックするとリセットされます。1列目のヘッダーには名前で行を絞り込むフィルターボックス(Filter API Keys...、Filter IPs...、またはFilter Domains...)もあります。Client IPビューおよびDomainビューでは、現在表示しているページのみを検索するため、別のページにあるグループは表示されません。Escキーでクリアされます。
使用状況、API製品
3つのビュー:
| ビュー | データのグループ化基準 |
|---|---|
| API Key | アクセス権を持つ各キー |
| Client IP | リクエストを発信した送信元アドレス |
| Domain | リクエスト内のターゲットドメイン |
スコープチップにより列とカードが切り替わります:
| スコープ | 表示内容 |
|---|---|
| Bandwidth | リクエスト数、受信バイト数、送信バイト数、およびそれらのバイト数のプレミアム割合(追加ではなく合計に含まれる、プレミアムエグジット経由で処理されたトラフィック) |
| Response Time | リクエスト数、最小、平均、最大レイテンシ |
| Concurrency | リクエスト数および同時リクエスト数(API Keyビューのみ) |
| Outcomes | リクエスト数と結果ごとの内訳、および結果ドーナツチャート |
| Budget | リクエスト数、請求対象クレジット、消費クレジット。特定のendpointを表示するには、Endpoints行で選択します |
| Routes | リクエスト数、ルートごとのリクエスト数、Autoが呼び出しの背後で実行した内容、各Auto呼び出しに応答したステップ(下記参照) |
Budgetスコープでは、請求対象クレジットと消費クレジットが区別されます。Billed creditsは、success結果のリクエストのみをカウントします。これがプランの支払い対象です。Spent creditsは、失敗したリクエストを含め、APIが各リクエストで報告するクレジットです(Response Headersを参照)。これらが請求されることはありません。
Budgetカードには、Billed creditsとその下にof N spentが表示され、Per requestにはリクエストあたりの平均請求対象クレジットが表示されます。テーブルにはBilled credits列とSpent credits列があり、どちらでもソートできます。
Routesスコープ
Routesは、各キー、クライアントIP、またはドメインのリクエストをルートごとに分割し、Autoがその呼び出しに対して実行した内容を表示します。その列は3つのグループに分かれており、それぞれの上にキャプションが付いています:
| グループ | カラム | カウント対象 |
|---|---|---|
| ルート別リクエスト | Single, Proxy Finder, Browser, Auto | 送信先ルート別のリクエスト。合計が Requests になります。Auto 呼び出しは Auto 配下に1回カウントされます。各数値の下段: Requests に対する割合。 |
| Auto 試行回数 | Single, Proxy Finder, Browser | Auto が呼び出しの背後で各エンジンにて実行したリクエスト(失敗を含む)。各数値の下段: Auto 呼び出しあたりの試行回数。 |
| Auto 応答元 | Saved session, Plain request, Proxy Finder, Browser, Failed | 各 Auto 呼び出しを処理したステップ。合計が Auto になります。各数値の下段: Auto に対する割合。 |
Saved session は、ホストに対して Auto がすでに保持していたセッションです。Browser には、ブラウザが最初にページを開き、そのセッションの再実行によって応答が配信された呼び出しが含まれます。Failed には、Auto の実行前に拒否された呼び出しが含まれます。
Auto が実際のブラウザをどこで使用しているかを確認するには、Auto attempts の Browser カラムを参照してください。通常、ブラウザがページを開くのは1回のみで、その後 Auto はより軽量なリクエストでそのセッションを再利用するため、通常このカラムは Auto answered by の Browser よりもはるかに大きな値になります。Routes はこのカラムでソートされて開くため、ブラウザを最も必要とするドメインが先頭に表示され、ブラウザ試行のないグループがリクエスト数順に続きます。
テーブル上のカードには、対象期間中の Auto 試行回数と Auto 呼び出しあたりの試行回数、および直接または Auto によって開かれたすべてのブラウザが表示されます。
Auto の試行は Requests や成功率にはカウントされません。ただし、Overview の Auto attempts カードと同様に、プランの Single、Proxy Finder、Browser のレート制限および同時実行制限にはカウントされます。Endpoints 行でエンドポイントを選択すると、Routes にはそのルートのみが表示されます。この場合、Browser にはユーザー自身が送信したブラウザリクエストがリストされ、Auto が実行したリクエストは Auto 配下に維持されます。
結果ドーナツグラフ
Outcomes スコープでは、パネル内にドーナツグラフが表示され、選択した期間の成功とエラーの内訳が示されます。スライスにカーソルを合わせると、正確なリクエスト数とパーセンテージが表示されます。別の疑問に答えるテーブルの上にウィンドウ全体のスナップショットがあると無関係な情報に見えるため、このグラフはそのスコープでのみ描画されます。
使用状況、Proxy 製品
5つのビュー:
| ビュー | データのグループ化基準 |
|---|---|
| Proxy ユーザー | アクセス権を持つ各プロキシユーザー |
| ターゲット | 各トンネルが到達したホスト |
| 出口国 | トンネルの退出元となった国 |
| クライアント IP | 接続元のIPアドレス |
| 結果 | 結果とその理由 |
4つのスコープ:
| スコープ | カラム |
|---|---|
| Traffic | Tunnels, Bytes In, Bytes Out, Premium |
| Setup | Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max |
| Outcomes | Tunnels、結果ごとのカラム、および結果ドーナツグラフ |
| Budget | Tunnels, Standard, Premium, Total |
Setup はトンネルが引き渡されるまでの待機時間です。Duration はその後オープン状態が維持された時間です。Premium はプレミアムネットワークを経由したトラフィックの一部であり、合計に含まれ、合計に対して追加されることはありません。
どのスコープにもクレジット列やリクエストカウントはありません。CONNECT の内部を通過するのは暗号化されたユーザー自身のトラフィックであるため、ポートはトンネル数とバイト数のみをカウントします。
結果タイプ
すべての API リクエストは正確に1つの結果に分類されます。課金対象となるのは success のみです。
| 結果 | レイヤー | 意味 |
|---|---|---|
success |
該当なし | リクエストが有効なレスポンスを返しました。validate ルールがない場合は HTTP 200 を意味します。validate ルールがある場合は、ステータスにかかわらずルールが承認した任意のレスポンスを指します。FourA が認識する確認ページや拒絶ページは、成功として扱われません。 |
application_error |
ターゲット | ターゲットは HTTP 200 を返しましたが、ボディにエラーフィールドが含まれていたか、FourA が認識する確認ページまたは拒絶ページでした。 |
application_fail |
ターゲット | ターゲットが validate ルールで承認されていない非 2xx を返したか、レスポンスがまったくありませんでした。 |
client_error |
呼び出し元 | リクエストが FourA を離れる前に拒絶されました。不正なパラメータ、不正な形式の proxy 値、またはプライベートアドレスや予約済みアドレスに解決される URL が原因です。 |
rate_limit |
FourA | リクエストが RPM または同時実行数の上限によって拒絶されました。レート制限 を参照してください。 |
service_error |
FourA | エンジンがサーバーエラーを返したか、解析できないボディを返しました。 |
service_fail |
FourA | ネットワーク障害。タイムアウト、接続拒絶、DNS エラー、クライアントの切断などです。 |
レイヤー列は責任の所在を示します。target は呼び出したサイト、caller はリクエストの不備、FourA は FourA 側で処理できなかったことを意味します。
validate.status.accept を使用して特定の非 200 コード(例: [200, 403])を許可した場合、それらは application_fail ではなく success として返されます。分類は生の HTTP コードではなく、ルールに対するエンジンの判定に従います。
プロキシポート経由のトンネルも、2つの target 結果を除き、同じ語彙に分類されます。トンネルの応答は暗号化されたユーザー自身のトラフィックであるため、FourA はその背後にあるサイトが正常だったかどうかを認識できません。完全な分類法および課金との対応関係については、リクエスト結果 を参照してください。