Supabase、W3C規格に準拠したクライアント・トレース伝搬に対応しログの紐付けを自動化

Supabaseは、クライアントライブラリであるsupabase-jsにおいて、W3C規格に準拠したトレースコンテキストの伝搬に対応したと発表しました。これにより、フロントエンドで発生したリクエストと、Supabase側のAPI GatewayやEdge Functionで生成されるサーバーログが単一のtrace_idを共有できるようになります。

これまではSDKによるリクエスト送信とSupabase側のログ記録に共通の識別子がなかったため、境界を跨いだデバッグにはタイムスタンプによる推測が必要でした。今回の更新でtracePropagationを有効にすると、SDKがリクエストヘッダーにトレース情報を付与し、OpenTelemetryやSentry、DatadogといったW3C準拠のトレーサーで一貫した追跡が可能になります。

本機能はsupabase-jsだけでなく、Swift、Flutter、Pythonの各SDKでも利用可能です。利用にあたってはSDK側で明示的に伝搬設定を有効にする必要があり、Supabaseドメイン向けのリクエストに対して標準ヘッダーが付与される仕様となっています。既存のスタックに導入することで、ブラウザ上の遅延リクエストを特定のサーバー処理と即座に紐付けられるようになります。