> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metric Streams タグリファレンス

> Metric Streams のタグ、列挙値、カーディナリティに関するリファレンスです。

> [!WARNING]
>
> **メトリクスストリーム機能は現在、です。**

## メトリクスリファレンス

### auth0.api\_request.count

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終了後に削除予定) |

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

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

#### 列挙値

**api**

* `AUTHENTICATION` - 認証APIへのリクエスト
* `MANAGEMENT` - Management APIへのリクエスト

**operation\_result**

* `SUCCESS` - リクエストが正常に完了
* `FAILURE` - クライアントエラーまたはサーバーエラーによりリクエストが失敗

**failure\_code** (`operation_result` が `FAILURE` の場合のみ存在)

* `RATE_LIMIT` - リクエストがレート制限を超過
* `ANOMALY_DETECTION` - Auth0の攻撃防御によってブロック
* `CLIENT_SERVER_ERROR` - HTTP 4xxまたは5xxエラー

## メトリクスのカーディナリティ

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

| タグ | カーディナリティ | 影響 |
| - | - | - |
| `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終了後に削除予定) |

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


## Related topics

- [About Metric Streams](https://auth0.com/docs/deploy-monitor/metric-streams.md)
- [How to Create Metric Streams](https://auth0.com/docs/deploy-monitor/metric-streams/create.md)