Metric Streams タグリファレンス

メトリクスリファレンス

Auth0テナントへのAPIリクエスト数をカウントします。詳細なフィルタリングや集計に使えるタグが付与されます。メトリクスは10秒ごとに出力され、1秒単位の粒度でデータを確認できます。

タグ名	必須	説明
`api`	はい	APIの種類：`AUTHENTICATION`または`MANAGEMENT`
`operation_name`	はい	HTTPメソッドとパス (例：`POST /oauth/token`)
`operation_result`	はい	結果：`SUCCESS`または`FAILURE`
`tenant`	はい	Auth0テナント名
`failure_code`	いいえ	失敗の理由：`RATE_LIMIT`、`ANOMALY_DETECTION`、または`CLIENT_SERVER_ERROR`
`country_code`	いいえ	リクエスト元IPアドレスに基づくISO国コード
`client_id`	いいえ	アプリケーションのClient ID (認証APIのみ)
`connection_id`	いいえ	接続ID (認証APIのみ)
`grant_type`	いいえ	OAuth 2.0の付与タイプ (認証APIのみ)
`batch_seq`	はい	タグとタイムスタンプが同一のメトリクスを区別するためのシーケンス番号 (一時的なもので、Beta終了後に削除予定)

client_idタグとconnection_idタグは、固有のクライアントや接続が多数存在する環境ではカーディナリティが高くなり、監視コストが増加する可能性があります。これらのタグは必要な場合に限って使用してください。

システムの過負荷を防ぐため、エッジでキャッシュされたAPI呼び出しや、Auth0のWebアプリケーションファイアウォール (WAF) によってブロックされたAPI呼び出しは、Metric Streamsに含まれません。

api

operation_result

failure_code (operation_result が FAILURE の場合のみ存在)

カーディナリティとは、メトリクスによって生成される一意の時系列の数を指します。カーディナリティが高いほど、監視コストは増加します。

タグ	カーディナリティ	影響
`api`	低	一意の値は2つ (Authentication、Management)
`operation_name`	中	使用するAPIオペレーションによって異なる
`operation_result`	低	一意の値は2つ (Success、Failure)
`tenant`	中	Auth0テナントごとに1つ
`failure_code`	低	一意の値は3つ (失敗時のみ)
`grant_type`	低	OAuth 2.0のグラントタイプに限定
`batch_seq`	低	一時的なタグ (Beta終了後に削除予定)

client_idタグとconnection_idタグは慎重に使用してください。アプリケーションや接続が多数ある環境では、これらのタグによってコストが大幅に増加するおそれがあります。細かい粒度が必要ない場合は、特定のクライアントに絞り込むか、これらのタグを集約することを検討してください。