Sentry のトレースヘッダー - 出ていくすべてのリクエストに付く理由と tracePropagationTargets

Wed, 16 Sep 2026 14:55:00 +0000

概要

Sentry を有効にすると、エラー収集だけが付いてくるわけではありません。分散トレーシングも一緒に有効になり、そのときから出ていくすべてのリクエストにトレースヘッダーが付きます。

アプリのコードにはそんな行はありません。ログにも残りません。ですから問題が起きても、コードをいくら読んでも見えません。

この記事では、そのヘッダーが何なのか、どう確認するのか、そして付く範囲をどう絞るのかを整理します。

エラーやバグを追跡する用途で Sentry を使っているところは多いです。アプリケーションで発生した例外を集め、いつどこで何回起きたのかを見せてくれるツールです。数行入れるだけで組み込めて、言語やフレームワークを選ばないため、標準で入れておくケースがよくあります。

Sentry Docs - Sentry Basics

ヘッダーを付けている側はエラー収集ではありません。Sentry を有効にすると分散トレーシングが一緒に付いてきます。出ていくリクエストごとにヘッダーを載せているのはそちらです。

何のための機能なのか

このヘッダーは分散トレーシングのためのものです。一つのリクエストが複数のサービスを経由するとき、その道のりを一つにまとめて見るために存在します。

サービス A が B を呼び、B がさらに C を呼ぶとします。ヘッダーがなければ三つはそれぞれ別々に記録を残します。A のレスポンスが遅かったことは分かっても、その原因が C だったことは分かりません。ヘッダーが trace_id を運ぶと、三つの記録が同じトレースにまとまります。

Sentry のドキュメントは目的をこう書いています。

track software performance and measure throughput & latency, while seeing the impact of errors across multiple systems

二つのヘッダーの役割は異なります。

sentry-trace は位置を指します。<trace_id>-<span_id>- の形です。このリクエストがどのトレースのどの地点なのかを教えます。
baggage は文脈を運びます。W3C が定めた標準ヘッダーで、Sentry はここに動的サンプリングで使う値を入れます。sentry-environment や sentry-release といったものです。

1sentry-trace: 41c74c2ea9f2bfb184f86939de5b97aa-399b3e5cc8b83494-1
2baggage: sentry-trace_id=41c74c2ea9f2bfb184f86939de5b97aa,
3 sentry-environment=production,
4 sentry-release=1.4.2,
5 sentry-sample_rate=0.2

サンプリングの判断を先頭のサービスで下し、後ろへ渡すのも baggage の仕事です。

Sentry on plzhans blog

Sentry のトレースヘッダー - 出ていくすべてのリクエストに付く理由と tracePropagationTargets

概要

何のための機能なのか