メトリクス

Metricsページ(サイドバー > Metrics)は、API使用状況のより詳細な分析ビューを提供します。全体的な結果の分布を表示し、トラフィックをAPIキー、クライアントIP、またはターゲットドメインごとに分類します。

リアルタイムのサマリーカードとタイムラインチャート(同時実行数、リクエスト、バイト数、応答時間、予算)については、Dashboard Overviewページを使用してください。

フィルター

ページ上部には、APIキーセレクターと間隔セレクターの2つのコントロールがあります。

キーフィルター

APIキードロップダウンを使用して、ページの対象を特定のキーに絞り込みます。アクセススコープ内のキーのみが表示されます。個人のキー、管理する組織のキー、またはチームで共有されているキーです。

間隔セレクター

間隔ボタンを使用して時間枠を制御します。

ボタン	期間
1M	過去1分間
5M	過去5分間
30M	過去30分間
1H	過去1時間
6H	過去6時間
1D	過去24時間

ドーナツグラフとテーブルの両方が、選択した内容に従います。

結果の分布

上部のドーナツグラフは、選択した間隔における成功とエラーの内訳を示しています。スライスにカーソルを合わせると、正確なリクエスト数と割合が表示されます。これを使用して、成功率の急激な低下が特定の結果カテゴリと一致しているかどうかをすばやく特定します。

結果の種類

すべてのAPIリクエストは、ただ1つの結果に分類されます。successのみが課金対象のクォータとしてカウントされます。

結果	レイヤー	意味
`success`	該当なし	リクエストは有効なレスポンスを返しました。`validate`ルールがない場合、これはHTTP 200を意味します。`validate`ルールを送信した場合、ルールの要件を満たすすべてのレスポンスは、HTTPステータスに関係なく成功としてカウントされます。
`application_error`	ターゲット	ターゲットはHTTP 200を返しましたが、レスポンス本文にエラーフィールドが含まれていました。
`application_fail`	ターゲット	ターゲットは、`validate`ルールで許可されていない2xx以外のステータスを返したか、まったくレスポンスを返しませんでした。
`client_error`	呼び出し元	リクエストはFourAから送信される前に拒否されました。不正なパラメーター、不正なプロキシ値、またはプライベートもしくは予約済みIPに解決されるURL(SSRFガード)が原因です。
`rate_limit`	FourA	リクエストは、RPMまたは同時実行制限により拒否されました。Rate Limitsを参照してください。
`service_error`	FourA	バックエンドが5xxを返したか、解析できない本文で応答しました。
`service_fail`	FourA	ネットワーク障害: タイムアウト、接続拒否、DNSエラー、クライアントの切断。

レイヤー列は原因の所在を示します。targetは呼び出したサイト、callerはリクエストの不正、FourAは処理できなかったことを意味します。

validate.status.acceptを使用して特定の200以外のコード(たとえば[200, 403])を許可する場合、それらのレスポンスはapplication_failではなくsuccessとして返されます。この分類は、生のHTTPコードではなく、ルールに対するエンジンの判定に従います。

完全な分類とそれが課金にどのようにマッピングされるかについては、Request Outcomesを参照してください。

マルチビュー使用状況テーブル

ドーナツグラフの下にある使用状況テーブルは、トラフィックを3つのビュータブに分類して表示します:

タブ	データのグループ化基準
API Key	各APIキー
Client IP	リクエストを送信する送信元IPアドレス
Domain	リクエストのターゲットドメイン

各タブは右側のスコープチップをサポートし、表示される列を変更します:

スコープ	表示内容
Bandwidth	リクエスト数、受信バイト数、送信バイト数
Response Time	リクエスト数、最小、平均、最大レイテンシ
Concurrency	リクエスト数および同時リクエスト数(API Keyビューのみ)
Outcomes	リクエスト数および結果ごとの内訳
Budget	リクエスト数および消費クレジット、プロダクト(Single、Proxy、Browser)ごとの内訳

Budgetスコープは、各リクエストでAPIによって書き込まれるcreditsメトリクスを読み取ります(Response Headersを参照)。合計は生の従量課金消費額です。請求は、プランに対してsuccessの結果のみをカウントします。

列ヘッダーをクリックすると、その列でソートされます。ソート状態は、ページロードをまたいでテーブルごとに保持されます。リセットするには、CtrlまたはCmdキーを押しながらヘッダーをクリックします。