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