第21章 トレーシングの有効化
この章では、現在プレビューされている機能について説明します。これを引き続き使用している間は、フィードバックをお寄せください。
この章では、OpenTelemetry (OTel)を利用して、Red Hat build of Keycloak で分散トレースを有効にして設定する方法について説明します。トレースを使用すると、各リクエストのライフサイクルの詳細な監視が可能になり、問題を迅速に特定および診断できるため、デバッグおよびメンテナンスがより効率的になります。
また、パフォーマンスのボトルネックに関する貴重な洞察を提供し、システム全体の効率を最適化するのに役立ちます。Red Hat build of Keycloak は、サポート対象の Quarkus OTel エクステンション を使用して、アプリケーショントレースのスムーズな統合と公開を提供します。
21.1. トレースの有効化
ビルド時間オプションの tracing-enabled を使用してトレースの公開を有効にし、次のように opentelemetry 機能を有効にすることができます。
bin/kc.[sh|bat] start --tracing-enabled=true --features=opentelemetry
デフォルトでは、トレースエクスポーターは gRPC プロトコルおよびエンドポイント http://localhost:4317 を使用してデータをバッチで送信します。
デフォルトのサービス名は keycloak で、tracing-service-name プロパティーを使用して指定されます。これは、tracing-resource-attributes プロパティーで定義される service.name よりも優先されます。
tracing-resource-attributes プロパティーを介して提供できるリソース属性の詳細は、Quarkus OpenTelemetry Resource guide を参照してください。
トレース設定の詳細は、以下のすべての可能な設定を参照してください。
