メトリクス
Metricsページ(サイドバー > Metrics)では、APIの使用状況をより深く分析できます。全体のアウトカム分布を表示し、API key、クライアントIP、またはターゲットドメインごとにトラフィックを分類します。
リアルタイムのサマリーカードやタイムラインチャート(Concurrency、Requests、Bytes、Response Time)については、Dashboard Overviewページを使用してください。
フィルター
ページ上部には、API keyセレクターとインターバルセレクターの2つのコントロールがあります。
キーフィルター
API Keyドロップダウンを使用して、ページを特定のキーに絞り込みます。個人キー、管理している組織キー、またはチームで共有されているキーなど、アクセス権限の範囲内にあるキーのみが表示されます。
インターバルセレクター
インターバルボタンを使用して、時間枠を制御します。
| ボタン | 時間枠 |
|---|---|
| 1M | 直近1分間 |
| 5M | 直近5分間 |
| 30M | 直近30分間 |
| 1H | 直近1時間 |
| 6H | 直近6時間 |
| 1D | 直近24時間 |
ドーナツチャートとテーブルの両方が、選択した内容に従って更新されます。
アウトカム分布
上部のドーナツチャートは、選択したインターバルの成功/エラーの内訳を示します。スライスにホバーすると、正確なrequest数とパーセンテージが表示されます。これを使用して、成功率の急激な低下が特定のアウトカムカテゴリと一致しているかどうかを素早く特定できます。
アウトカムタイプ
すべてのAPI requestは、いずれか1つのアウトカムに分類されます。課金対象のクォータにカウントされるのはsuccessのみです。
| アウトカム | レイヤー | 意味 |
|---|---|---|
success |
n/a | requestは有効なresponseを返しました。validateルールがない場合、これはHTTP 200を意味します。validateルールを送信した場合、HTTPステータスに関わらず、ルールが受け入れた任意のresponseが成功としてカウントされます。 |
application_error |
target | ターゲットはHTTP 200を返しましたが、response bodyにエラーフィールドが含まれていました。 |
application_fail |
target | ターゲットが、validateルールで受け入れられなかった2xx以外のステータスを返したか、あるいはresponseをまったく返しませんでした。 |
client_error |
caller | requestがFourAを離れる前に拒否されました。不正なパラメータ、不正な形式のproxy値、またはプライベート/予約済みIPに解決されるURL(SSRFガード)が原因です。 |
rate_limit |
FourA | requestはRPMまたは同時実行数の制限によって拒否されました。Rate Limitsを参照してください。 |
service_error |
FourA | バックエンドが5xxを返したか、解析できないbodyで応答しました。 |
service_fail |
FourA | ネットワーク障害(タイムアウト、接続拒否、DNSエラー、クライアントの切断など)。 |
レイヤー列は、誰に原因があるかを示します。targetは呼び出したサイト、callerは送信したrequestが不正であったこと、FourAは弊社側で処理できなかったことを意味します。
validate.status.acceptを使用して特定の非200コード(例:[200, 403])を許可する場合、それらのresponseはapplication_failではなくsuccessとして返されます。この分類は、生のHTTPコードではなく、ルールに対するエンジンの判定に従います。
完全な分類と課金へのマッピングについては、Request Outcomesを参照してください。
マルチビュー使用状況テーブル
ドーナツチャートの下にある使用状況テーブルでは、3つの表示タブでトラフィックを分類します。
| タブ | データのグループ化基準 |
|---|---|
| API Key | 各API key |
| Client IP | requestを送信している送信元IPアドレス |
| Domain | request内のターゲットドメイン |
各タブの右側には、表示される列を変更する4つのスコープチップがあります。
| スコープ | 表示内容 |
|---|---|
| Bandwidth | request数、受信バイト数、送信バイト数 |
| Response Time | request数、最小・平均・最大レイテンシ |
| Concurrency | request数と同時実行request数(API Keyビューのみ) |
| Outcomes | request数とアウトカムごとの内訳 |
関連情報
- Dashboard Overview: リアルタイムの統計とタイムラインチャート
- Request Outcomes: 7つのアウトカム値の詳細な説明
- API Errors: エラーがネットワーク経由でどのように返されるか