sentry-sdk-setup

작성자: sentry

어떤 언어나 프레임워크에서든 Sentry를 설정합니다. 사용자의 플랫폼을 감지하고 올바른 SDK 스킬을 로드합니다. Sentry 추가, SDK 설치 또는 설정을 요청받았을 때 사용하세요.

npx skills add https://github.com/getsentry/sentry-for-ai --skill sentry-sdk-setup

All Skills

Sentry SDK Setup

Set up Sentry error monitoring, tracing, and session replay in any language or framework. This page helps you find the right SDK skill for your project.

Start Here — Read This Before Doing Anything

Do not skip this section. Do not assume which SDK the user needs based on their project files. Do not start installing packages or creating config files until you have confirmed the user's intent.

Detect the platform from project files (package.json, go.mod, requirements.txt, Gemfile, *.csproj, build.gradle, etc.).
Tell the user what you found and which SDK you recommend.
Wait for confirmation before reading the skill and proceeding.

Each SDK skill contains its own detection logic, prerequisites, and step-by-step configuration. Trust the skill — read it carefully and follow it. Do not improvise or take shortcuts.

SDK Skills

Platform	Skill
Android	`sentry-android-sdk`
browser JavaScript	`sentry-browser-sdk`
Cloudflare Workers and Pages	`sentry-cloudflare-sdk`
Apple platforms (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, and Deno	`sentry-node-sdk`
PHP	`sentry-php-sdk`
Python	`sentry-python-sdk`
Flutter and Dart	`sentry-flutter-sdk`
React Native and 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 and SvelteKit	`sentry-svelte-sdk`

Platform Detection Priority

When multiple SDKs could match, prefer the more specific one:

Android (build.gradle with android plugin) → sentry-android-sdk
Cloudflare (wrangler.toml or wrangler.jsonc) → sentry-cloudflare-sdk over sentry-node-sdk
NestJS (@nestjs/core) → sentry-nestjs-sdk over sentry-node-sdk
Next.js → sentry-nextjs-sdk over sentry-react-sdk or sentry-node-sdk
React Router Framework (@sentry/react-router or @react-router/*) → sentry-react-router-framework-sdk over sentry-react-sdk
TanStack Start React (@tanstack/react-start) → sentry-tanstack-start-sdk over sentry-react-sdk
Flutter (pubspec.yaml with flutter: dependency or sentry_flutter) → sentry-flutter-sdk
React Native → sentry-react-native-sdk over sentry-react-sdk
PHP with Laravel or Symfony → sentry-php-sdk
Elixir (mix.exs detected) → sentry-elixir-sdk
Node.js / Bun / Deno without a specific framework → sentry-node-sdk
Browser JS (vanilla, jQuery, static sites) → sentry-browser-sdk
No match → direct user to Sentry Docs

Quick Lookup

Match your project to a skill by keywords.

Keywords	Skill
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`

Finding the DSN

If the user doesn't have their DSN, guide them to find it:

Open the Sentry project settings page: https://sentry.io/settings/projects/
Select the project
Click "Client Keys (DSN)" in the left sidebar
Copy the DSN

You can help the user open the page directly:

open https://sentry.io/settings/projects/        # macOS
xdg-open https://sentry.io/settings/projects/    # Linux
start https://sentry.io/settings/projects/        # Windows