sentry-sdk-setup について
プロジェクトの言語やフレームワークに応じて、Sentry SDKの選択と設定を支援するスキルです。具体的なプラットフォームを優先して判定し、設定前に確認を求め、対応するスキルへ案内します。
主な機能
- 01プロジェクトファイルからプラットフォームを検出
- 02プラットフォームをSDKスキルに対応付け
- 03具体的なフレームワークを優先
- 04設定開始前に確認
- 05DSNの確認方法を提示
活用シーン
- 01プロジェクトに合うSDKスキルの選択
- 02Sentry DSNの確認
- 03プラットフォーム判定後のSentry設定開始
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ getsentry/ sentry-for-ai --skill sentry-sdk-setupインストール後、Claude Code で/sentry-sdk-setupを入力して読み込まれたか確認します。
詳細
Sentry SDK のセットアップ
あらゆる言語やフレームワークで、Sentry のエラー監視、トレース、セッションリプレイをセットアップできます。このページでは、プロジェクトに適した SDK スキルを見つける方法を説明します。
まずはこちら — 作業を始める前にお読みください
このセクションを省略しないでください。 プロジェクトファイルを見て、ユーザーが必要としている SDK を推測してはいけません。ユーザーの意図を確認するまでは、パッケージのインストールや設定ファイルの作成を始めないでください。
- プロジェクトファイル(
package.json、go.mod、requirements.txt、Gemfile、*.csproj、build.gradleなど)からプラットフォームを検出します。 - 検出した内容と、おすすめの SDK をユーザーに伝えます。
- スキルを読んで作業を進める前に、ユーザーの確認を待ちます。
各 SDK スキルには、固有の検出ロジック、前提条件、手順ごとの設定方法が記載されています。スキルを信頼し、注意深く読んで、その指示に従ってください。独自の判断で進めたり、手順を省略したりしないでください。
SDK スキル
| プラットフォーム | スキル |
|---|---|
| Android | sentry-android-sdk |
| ブラウザー JavaScript | sentry-browser-sdk |
| Cloudflare Workers and Pages | sentry-cloudflare-sdk |
| Apple プラットフォーム(iOS、macOS、tvOS、watchOS、visionOS) | sentry-cocoa-sdk |
| .NET | sentry-dotnet-sdk |
| Elixir | sentry-elixir-sdk |
| Go | sentry-go-sdk |
| NestJS | sentry-nestjs-sdk |
| Next.js | sentry-nextjs-sdk |
| Node.js、Bun、Deno | sentry-node-sdk |
| PHP | sentry-php-sdk |
| Python | sentry-python-sdk |
| Flutter、Dart | sentry-flutter-sdk |
| React Native、Expo | sentry-react-native-sdk |
| React | sentry-react-sdk |
| React Router Framework | sentry-react-router-framework-sdk |
| TanStack Start React | sentry-tanstack-start-sdk |
| Ruby | sentry-ruby-sdk |
| Svelte、SvelteKit | sentry-svelte-sdk |
プラットフォームの検出優先順位
複数の SDK が該当する可能性がある場合は、より具体的なものを優先してください。
- Android(
build.gradleに Android プラグインが含まれる)→sentry-android-sdk - Cloudflare(
wrangler.tomlまたはwrangler.jsonc)→sentry-node-sdkよりsentry-cloudflare-sdkを優先 - NestJS(
@nestjs/core)→sentry-node-sdkよりsentry-nestjs-sdkを優先 - Next.js →
sentry-react-sdkまたはsentry-node-sdkよりsentry-nextjs-sdkを優先 - React Router Framework(
@sentry/react-routerまたは@react-router/*)→sentry-react-sdkよりsentry-react-router-framework-sdkを優先 - TanStack Start React(
@tanstack/react-start)→sentry-react-sdkよりsentry-tanstack-start-sdkを優先 - Flutter(
flutter:依存関係またはsentry_flutterを含むpubspec.yaml)→sentry-flutter-sdk - React Native →
sentry-react-sdkよりsentry-react-native-sdkを優先 - Laravel または Symfony を使用する PHP →
sentry-php-sdk - Elixir(
mix.exsが検出された場合)→sentry-elixir-sdk - 特定のフレームワークを使用しない Node.js / Bun / Deno →
sentry-node-sdk - ブラウザー JS(バニラ、jQuery、静的サイト)→
sentry-browser-sdk - 該当なし → ユーザーを Sentry Docs に案内
クイック検索
キーワードからプロジェクトに合ったスキルを見つけます。
| キーワード | スキル |
|---|---|
| android, kotlin, java, jetpack compose | sentry-android-sdk |
| browser, vanilla js, javascript, jquery, cdn, wordpress, static site | sentry-browser-sdk |
| cloudflare, cloudflare workers, cloudflare pages, wrangler, durable objects, d1 | sentry-cloudflare-sdk |
| ios, macos, swift, cocoa, tvos, watchos, visionos, swiftui, uikit | sentry-cocoa-sdk |
| .net, csharp, c#, asp.net, maui, wpf, winforms, blazor, azure functions | sentry-dotnet-sdk |
| go, golang, gin, echo, fiber | sentry-go-sdk |
| elixir, phoenix, plug, oban | sentry-elixir-sdk |
| nestjs, nest | sentry-nestjs-sdk |
| nextjs, next.js, next | sentry-nextjs-sdk |
| node, nodejs, node.js, bun, deno, express, fastify, koa, hapi | sentry-node-sdk |
| php, laravel, symfony | sentry-php-sdk |
| python, django, flask, fastapi, celery, starlette | sentry-python-sdk |
| flutter, dart, pubspec | sentry-flutter-sdk |
| react native, expo | sentry-react-native-sdk |
| react, react router, tanstack, redux, vite | sentry-react-sdk |
| react-router framework, @sentry/react-router, @react-router/dev, react-router reveal | sentry-react-router-framework-sdk |
| tanstack start, tanstack react start, @tanstack/react-start, tanstackstart-react | sentry-tanstack-start-sdk |
| ruby, rails, sinatra, sidekiq, rack | sentry-ruby-sdk |
| svelte, sveltekit | sentry-svelte-sdk |
DSN の確認
ユーザーが DSN を持っていない場合は、見つけ方を案内します。
- Sentry のプロジェクト設定ページを開きます:
https://sentry.io/settings/projects/ - プロジェクトを選択します
- 左側のサイドバーで "Client Keys (DSN)" をクリックします
- DSN をコピーします
ユーザーがページを直接開けるように案内できます:
open https://sentry.io/settings/projects/ # macOS
xdg-open https://sentry.io/settings/projects/ # Linux
start https://sentry.io/settings/projects/ # Windows
注: DSN は公開情報であり、ソースコードに含めても安全です。秘密情報ではなく、イベントの送信先を識別するためのものです。
ワークフローや機能の設定をお探しですか? スキルツリー全体をご覧ください。
コメント
Markdown 対応