プランの計測方法

FourAは2つの製品を提供しており、それぞれ異なる単位で測定されます。プランはいずれか一方の単位に基づいて販売され、これにより制限される上限やダッシュボードに表示されるカードが決まります。このページでは、そのモデル全体を1画面で説明します。

2つの製品と2つの単位

APIでは、successの結果のみクレジットが消費されます。ターゲット側、クライアント側、またはFourA側で失敗したリクエストではクレジットは消費されません。プレミアムトラフィックは、以下で説明するようにクレジットとは別にカウントされます。Request Outcomesを参照してください。

Proxy portにはクレジットやリクエスト数の概念はありませんが、これは記載漏れではありません。トンネルはツールが開く1つの接続であり、その内部で送信されるデータは暗号化されたトラフィックであるため、FourAがカウントできるのはトンネルおよび転送されたバイト数のみです。ここでリクエスト数をカウントしても、独自のログと照合することはできません。そのため、ポートは常にギガバイト単位で販売されます。Proxy Portを参照してください。

ギガバイトの定義とカウント対象

1ギガバイトは1,073,741,824バイト（2^30、GiBとも表記される単位）を意味します。プランのすべての許容量、カウンター、価格設定は、APIでもProxy portでもこの数値を使用します。

カウントされる対象は、両者が伝送するデータが異なるため製品ごとに異なります。

留意すべき影響事項:

• デコードされたページを生成するため、ページ容量はデコード後のサイズでカウントされます。 ページへのアクセスには、実際のブラウザの実行、ページが要求する追加ステップの完了、レスポンスのデコード、および利用可能なコンテンツの引き渡しが含まれる場合があります。課金対象はその結果であり、転送時の圧縮率ではありません。proxyポートはその逆で価格設定も異なります。お客様独自の接続を中継し、内部のデータには一切手を加えないため、トンネルを通過したバイト数がそのまま正確にカウントされます。
• 標準プールでの再試行には費用がかかりません。 Proxy Finderが複数のイグジットをローテーションする場合、試行回数に関係なく、受け取ったレスポンスに対して1回のみ課金されます。プレミアムイグジットでは、プレミアムネットワーク側の課金仕様に基づき、すべての試行がカウントされます。
• 標準イグジットでのブラウザセッションは、他のAPIレスポンスと同様にカウントされます。 ページが読み込んだすべてのサブリソースではなく、返却されるbodyのみが対象です。プレミアムイグジット経由の場合、セッション全体がネットワーク上を流れるため、その全量がカウントされます。
• プレミアム枠は合計容量の一部であり、追加ではありません。 標準の許容量からは、プレミアムイグジットを経由しなかった分のみが消費されます。
• Auto呼び出し自体にはトラフィックが発生しません。 内部で実行されるSingle、Proxy Finder、Browserの各requestは、お客様が直接実行した場合と同様にカウントされます。
• サイトによる拒否はカウントされますが、プラン制限による拒否はカウントされません。 サイトが403、404、429、5xxを返した場合、そのレスポンスを中継しているためカウント対象となります。お客様のプラン上限によりrequestが拒否された場合は、取得は行われず、何もカウントされません。
• 切り上げ処理は一切ありません。 バイト数はブロックサイズやrequestごとの最小値なしで正確にカウントされ、メトリクスストアと毎晩照合されます。

プランの2種類の販売方式

すべてのアカウントで両方のメーターが動作します。違いは、プランがどちらの基準で販売されているかという点のみです。

クレジット制

APIは課金対象のrequestごとにクレジットを消費します。proxyポートには個別のギガバイト枠が含まれ、別途見積もられます（トンネルにはクレジットを課金するrequestが存在しないため）。これら2つが相互に消費されることはありません。APIトラフィックがポートのギガバイトを消費することはなく、ポートのトンネルがクレジットを消費することもありません。これらを分けない場合、1回のAPI requestに対してクレジットと発生バイト数の両方で二重課金が発生してしまいます。

プランに個別の設定がない限り、API独自のトラフィック上限は無効化されています。

トラフィック制

1つの標準トラフィック許容量でAPIとproxyポートの両方をカバーします。両方のアクセス手段が同じ単位で価格設定されているためです。この方式で販売されるプランではクレジットが請求されないため、無意味な数値を表示する代わりに、ダッシュボードからクレジット項目が完全に非表示になります。

プレミアムトラフィック（両プラン共通）

プレミアムトラフィックには、どちらのプラン形態でも常に専用の許容量が設定されます。標準の数値に含まれることはないため、1ギガバイトが2重の上限に請求されることはありません。プレミアムイグジットは、POST /api/proxy/のexitClass: premiumまたはproxyポートの-network-premiumで利用できます。

ネットワークを通過した時点で測定されます。双方向とも、送信時の圧縮および暗号化された状態のデータ量が対象です。APIでは、ページが返されなかったものも含め、すべてのプレミアム試行がカウントされます。プロキシポートでは、各プレミアムトンネルのトラフィックに加え、ポートが開通試行中にドロップしたプレミアム出口のトラフィックも加算されます。

拒否される条件と場所

CONNECTにはJSONエラーを含めるbodyがありません。そのため、ポート拒否はRate Limitsで説明されている形式ではなく、ステータスとヘッダーで返されます。プロキシ接続では、まずX-Foura-Errorを確認してください。

プレミアム枯渇時の非対称性

「明示的に消費を要求した」場合と「一度設定されたデフォルトである」場合では状況が異なるため、2つの接続口で意図的に異なる応答を返します。

APIでは、プレミアム枠が枯渇してもジョブは停止しません。リクエストは標準プールから処理され、レスポンスにexitClass: standardが含まれるため、実際に取得した内容を確認できます。プレミアム出口が一切含まれていないプランの場合は挙動が異なり、403（plan_limit_premium付き）が返されます。

プロキシポートの場合:

• -network-premiumを指定した接続は、403で拒否されます。消費を要求した以上、通知なしに別ルートで処理されると、発生しないはずのプレミアム項目の照合が発生してしまうためです。
• プロキシユーザーに保存されたプレミアムデフォルト設定は共有ネットワークにダウングレードされ、トンネルは開通します。この接続に対して明示的に選択したわけではないためです。
• 設定済みの-fallback-premiumは単にトリガーされません。

追加購入

チャージ分はプラン付帯分と全く同様にカウントされます。各期間において、まずプラン自体の枠が消費され、超過分のみが購入残高から引き落とされます。購入分の有効期間は12か月です。

ダッシュボードでは、許容量を表示するすべての箇所で2つの数値を分けて管理しているため (75,000 (50,000 incl + 25,000 bought))、画面上の数値とお手元の請求書を照合できます。

数値の確認場所

Billingに表示されるカードは上記の2つのケースに従います。クレジット単位で販売されるプランには「Credits」カードと「Proxy port traffic」カードが表示されます。トラフィック単位で販売されるプランにはどちらも表示されず、「Standard traffic」カードに上限が設定され、The API and the proxy port togetherと記載されます。

これらの数値をハードコードしないでください。すべてのAPI拒否レスポンスには拒否の原因となった上限値が含まれ、すべてのポート拒否レスポンスにはX-Foura-Error内にその上限値が示されます。

Related

• Rate Limits: APIのプラン制限に関するすべてのbodyとheader
• Proxy Port: 計量、レスポンスコード、およびusernameオプション
• Request Outcomes: requestおよびtunnelにおける課金対象の結果
• Billing & Subscriptions: プラン、チャージ、および請求書
• Usage & Limits: プランに対するリアルタイムカウンター