Add span attributes and per-PostProcessor spans to markdown tracing

[raydive]

概要

beta / prod のトレース分析で判明した「span はあるが詳細が分からない」問題に対応し、markdown 計装に span 属性と PostProcessor 単位の子 span を追加します。

背景(トレース分析結果)

• prod の parse テールは post_process が支配的(p95 1.73s / p99 18.3s / max 431s)。特に WikiConvertJob のトレースでは 1,153 回の parse 合計 82 分のうち 80% が post_process だが、どの PostProcessor が原因か現状の span では特定できない
• inlines のテール(p99 587ms / max 28.3s)が入力サイズ起因かどうかも、入力サイズの記録がなく確認できない

変更内容

• markdown.parse に markdown.input.length 属性を追加(String / BasedSequence オーバーロード。Reader はサイズ不明のため対象外)
• markdown.render に markdown.node.type / markdown.input.length / markdown.output.length(出力が CharSequence の場合のみ)属性を追加
• PostProcessor ごとの子 span markdown.parse.post_processor を追加し、markdown.post_processor.class 属性に実装クラスの FQCN を記録(global スコープ・ノードスコープの両方)

実装メモ

• Span.current() / GlobalOpenTelemetry は opentelemetry-api 由来で、既に opentelemetry-instrumentation-annotations の推移的依存として入っているため新規依存なし
• agent / SDK 未接続時はいずれも no-op(span はダミー、属性設定も無害)
• PostProcessor span は例外時に ERROR ステータスを設定して再 throw(既存の例外伝播を変えない)

検証

• 全モジュール mvn test 成功(挙動不変)
• opentelemetry-javaagent 2.16.0 + logging exporter のローカル実行で、属性(markdown.input.length=85、markdown.node.type=Document、markdown.output.length=160)と markdown.parse.post_processor 子 span(markdown.post_processor.class=...AttributesNodePostProcessor)が正しい親子関係で出力されることを確認

Generated with Claude Code