21.3. ログのトレース
トレースを有効にすると、トレース情報は有効なすべてのログハンドラーのログメッセージに含まれます( ロギングの設定を参照)。これは、ログイベントを要求の実行に関連付けるのに役立ちます。これにより、トレーサビリティやデバッグが改善される可能性があります。同じリクエストから発信されたすべてのログラインは、ログ内に同じ traceId になります。
ログメッセージには、以下で説明されているサンプリングに関連する sampled フラグも含まれ、スパンがサンプリングされたかどうかを示します -
ログレコードの形式は、次のように開始できます。
2024-08-05 15:27:07,144 traceId=b636ac4c665ceb901f7fdc3fc7e80154, parentId=d59cea113d0c2549, spanId=d59cea113d0c2549, sampled=true WARN [org.keycloak.events] ...
21.3.1. ログでトレース情報を非表示に
関連する Red Hat build of Keycloak オプション log-<handler- name>-include-trace を指定すると、特定のログハンドラー でのトレース情報を非表示にできます。< handler-name > はログハンドラーの名前になります。たとえば、コンソール ログでトレース情報を無効にするには、以下のようにオフにします。
bin/kc.[sh|bat] start --tracing-enabled=true --features=opentelemetry --log=console --log-console-include-trace=false
注記
特定のログハンドラーのログ形式を明示的に上書きすると、*-include-trace オプションは効果がなく、トレースは含まれません。
