5.2. 自己提供のメトリクス
Red Hat build of Keycloak が提供する主要なメトリクスを説明します。
これは、メトリクスを使用したトラブルシューティング 章の一部です。
5.2.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- Red Hat build of Keycloak でメトリクスを有効にしている。詳細は、メトリクスから洞察を得る の章を参照してください。
- メトリクスを収集する監視システム。
5.2.2. メトリクス リンクのコピーリンクがクリップボードにコピーされました!
5.2.2.1. ユーザーイベントメトリクス リンクのコピーリンクがクリップボードにコピーされました!
ユーザーイベントメトリクスはデフォルトで無効になっています。イベントメトリクスを有効にする方法と、記録するタグを設定する方法は、イベントメトリクスを使用してユーザーアクティビティーを監視する を参照してください。
メトリクス | 説明 |
---|---|
| ユーザーイベントの発生をカウントします。 |
タグ
カーディナリティーが高くなりすぎないようにするため、client_id
および idp
タグはデフォルトで無効になっています。
realm
- レルム
client_id
- クライアント ID
idp
- アイデンティティープロバイダー
event
-
login
やlogout
などのユーザーイベント。利用可能なイベントの概要は、イベントタイプに関するサーバー管理ガイド を参照してください。 error
-
login
イベントのinvalid_user_credentials
などのイベント固有のエラー。エラーが発生しなかった場合は空の文字列。
以下のスニペットは、メトリクスエンドポイントによって提供されるレスポンスの例です。
5.2.2.2. パスワードのハッシュ リンクのコピーリンクがクリップボードにコピーされました!
メトリクス | 説明 |
---|---|
| パスワードハッシュの検証をカウントします。 |
タグ
realm
- レルム
algorithm
-
パスワードのハッシュ化に使用されるアルゴリズム (例:
argon2
) hashing_strength
-
ハッシュアルゴリズムの強度 (アルゴリズムに応じた反復回数など) を示す文字列 (例:
Argon2id-1.3[m=7168,t=5,p=1]
) outcome
パスワード検証の結果。可能な値:
valid
- 正しいパスワード
invalid
- 不正なパスワード
error
- パスワードのハッシュ化時にエラーが発生しました
使用可能なタグを設定するには、オプション spi-credential-keycloak-password-validations-counter-tags
にタグ名のコンマ区切りリストを指定します。デフォルトでは、すべてのタグが有効になっています。
以下のスニペットは、メトリクスエンドポイントによって提供されるレスポンスの例です。
HELP keycloak_credentials_password_hashing_validations_total Password validations TYPE keycloak_credentials_password_hashing_validations_total counter
# HELP keycloak_credentials_password_hashing_validations_total Password validations
# TYPE keycloak_credentials_password_hashing_validations_total counter
keycloak_credentials_password_hashing_validations_total{algorithm="argon2",hashing_strength="Argon2id-1.3[m=7168,t=5,p=1]",outcome="valid",realm="realm-0",} 39949.0
5.2.3. 次のステップ リンクのコピーリンクがクリップボードにコピーされました!
メトリクスを使用したトラブルシューティング に戻るか、JVM メトリクス に進みます。