sentry

Sentry

TypeScript/JavaScript で Sentry を使ったアプリケーションのモニタリングを行う場合に、このスキルを使用します。エラー追跡、トレーシング、Session Replay、プロファイリング、ログ、メトリクス、ソースマップ／リリース、フレームワーク SDK が対象です。スナップショットは JS SDK 11.2.0（2026-10-01）です。v11 は2026-09-23にリリースされた破壊的変更を含むメジャーバージョンで、v10 のメンテナンス系列は 10.75.x です。

ワークフロー

1. コードを変更する前に、ローカルの状況を確認します。
   • インストールされている @sentry/* のバージョン（アプリの SDK は同じ系列にそろえます。スタンドアロンのバンドラープラグイン／CLI／ウィザード／RN／Electron／Capacitor は別の系列です）。10.x を使用している場合は、設定に触れる前に、作業に v11 へのアップグレードが含まれるか判断します。
   • 初期化エントリーポイント：instrument.ts、sentry.*.config.ts、instrumentation.ts、または最も早く読み込まれるアプリのインポート。
   • 環境変数：SENTRY_DSN／パブリック DSN、SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT、release、environment。
   • 使用中の機能：エラー、tracesSampleRate／tracesSampler、リプレイ、プロファイリング、ログ、メトリクス、フィードバック、cron、beforeSend* フック、ignoreTransactions／ignoreSpans。
   • ランタイム：ブラウザー、Node（v11 には >=20.19 が必要）、Bun、Deno、Cloudflare Workers/Pages、AWS/GCP サーバーレス、Electron、React Native。
2. フレームワークに一致する最上位のパッケージを1つ選びます。@sentry/browser + @sentry/react + @sentry/nextjs を重ねて使用しないでください。packages-frameworks.md を参照してください。
3. 日常的なセットアップ（初期化の順序、サンプリング、PII、API）については、setup-core.md に従います。
4. バージョンにずれがあれば、ドキュメントを更新します。source-map.md から始めてください。
5. 詳細は以下を参照してください。
   • パッケージとフレームワークの一覧：packages-frameworks.md
   • ブラウザー／Node のインテグレーションと自動計測：integrations.md
   • 製品機能（リプレイ、ログ、プロファイリング、Seer、エージェント）：products-features.md
   • ソースマップ、リリース、バンドラープラグイン、CLI：sourcemaps-releases.md
   • パターン、落とし穴、検証：patterns-troubleshooting.md
   • v10 → v11 アップグレード（デフォルト、削除されたオプション、フレームワークの移行）：migration-v10-to-v11.md
6. コマンド例では bun / bunx を優先します。新規のフレームワークセットアップではウィザードを優先し、リポジトリにすでにカスタムツールがある場合は手動で初期化します。

Sentry の判断基準

• 最初に初期化する：他のアプリのインポートより前に instrument / Sentry の設定を読み込み、計装（v11 ではチャネルベース）とデフォルトのインテグレーションを適用します。
• ランタイムの各領域で SDK パッケージは 1 つにします（クライアントとサーバーで異なる場合があります。例：Next.js では両方に @sentry/nextjs を使用し、TanStack Start では @sentry/tanstackstart-react と Cloudflare のラップを使用する場合があります）。
• サンプリング：インストールの検証に限り tracesSampleRate: 1.0 を設定し、本番環境では値を下げるか tracesSampler を使用します。リプレイ（replaysSessionSampleRate / replaysOnErrorSampleRate）とプロファイリングも同様です。
• PII：v11 では sendDefaultPii が削除されました。dataCollection を未設定のままにすると、ユーザー情報、Cookie、ヘッダー、本文、DB クエリデータ、GenAI の入出力が収集されます。プライバシーに配慮が必要なアプリでは、dataCollection で明示的に拒否してください。明示的な setUser / タグは常に送信されます。
• v11 のデフォルト：スパンストリーミング（beforeSendTransaction / ignoreTransactions は何もしないため、beforeSendSpan + ignoreSpans を使用）、ログ／メトリクスにフラグは不要（enableLogs は削除）、attachStacktrace: true、スコープのタグはスパンに反映されないため setAttribute を使用します。
• ソースマップ：本番ビルドではアップロードが必要です（@sentry/vite-plugin / webpack / esbuild / rollup、フレームワークの withSentryConfig、または @sentry/cli を使用）。クライアントに配信する場合は、アップロード後に公開用の .map を削除してください。
• 共有環境（拡張機能、ウィジェット、埋め込みライブラリ）では、グローバルな Sentry.init() を呼び出さないでください。代わりに分離された BrowserClient + Scope を使用します。
• Node のプリロード：v11 では ESM と CJS の両方で node --import ./instrument.(m)js app.js を使用します。--require および @sentry/node/preload|init|loader のエントリーポイントは削除されています。
• フレームワークサーバー：v11 では Express/Fastify/Koa/Hapi のエラーを自動的に捕捉します（setup*ErrorHandler は非推奨です。インテグレーションの shouldHandleError を調整してください）。Nest では引き続き SentryModule を使用し、Hono では @sentry/hono/<runtime> を使用します。
• OpenTelemetry：v11 のサーバー SDK は OTel プロバイダーを管理しなくなりました。ライブラリの OTel スパンを取り込むには enableOpenTelemetrySetup: true を使用するか、独自の OTel パイプラインと併せて openTelemetryIntegration() を使用してください。
• 関連する @sentry/* アプリパッケージは、同じ 11.x バージョンに揃えてください。単独のプラグイン（5.x）を SDK のバージョンに固定しないでください。Electron / RN / Capacitor には引き続き 10.x が組み込まれています。

検証

リポジトリが用意しているコマンドを優先してください。該当する項目を確認します。

• bun pm ls @sentry/node（またはフレームワークのパッケージ）— バージョンが揃っていることを確認します。
• ボタン操作でテスト用の captureException を実行するか例外を発生させ、Sentry に Issue とソースマップで対応付けられたスタックトレースが表示されることを確認します。
• トレーシングを有効にした状態で API／ページにアクセスし、スパンツリー（v11 ではストリーミングされたセグメント）を確認します。
• v11 へのアップグレード後、sendDefaultPii、enableLogs、enableMetrics、beforeSendTransaction、ignoreTransactions、skipOpenTelemetrySetup、--require、inboundFiltersIntegration、@sentry/types、@sentry/node-core、および @sentry/nextjs からインポートされた withSentryConfig を grep で検索します。
• リプレイを使用する場合は、Issue から Replay にリンクされていることを確認します（サンプルレートによっては反映に時間がかかる場合があります）。
• 本番ビルドで、ソースマップのアップロードが成功したことを確認します（CI ログ／Sentry Releases のアーティファクト）。
• SENTRY_AUTH_TOKEN は CI にのみ設定します。DSN はクライアントで公開しても安全ですが、認証トークンは公開してはいけません。

実行した確認項目、実行しなかった確認項目、および未確定のバージョン前提を報告してください。