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 メトリクス に進みます。