sentry-sdk-setup

所有技能

Sentry SDK 设置

在任何语言或框架中设置 Sentry 错误监控、追踪和会话回放。本页将帮助你找到适合项目的 SDK 技能。

从这里开始 — 操作前请先阅读

请勿跳过本节。 不要根据项目文件猜测用户需要哪个 SDK。在确认用户意图之前，请勿开始安装软件包或创建配置文件。

1. 检测平台：查看项目文件（package.json、go.mod、requirements.txt、Gemfile、*.csproj、build.gradle 等）。
2. 告知用户你的发现以及你推荐的 SDK。
3. 等待用户确认后，再阅读技能并继续操作。

每项 SDK 技能都包含自己的检测逻辑、前提条件和分步配置说明。请相信技能内容，仔细阅读并遵循。不要自行发挥或走捷径。

---

SDK 技能

平台	技能
Android	sentry-android-sdk
浏览器 JavaScript	sentry-browser-sdk
Cloudflare Workers 和 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（包含 android 插件的 build.gradle）→ sentry-android-sdk
• Cloudflare（wrangler.toml 或 wrangler.jsonc）→ 优先选择 sentry-cloudflare-sdk，而不是 sentry-node-sdk
• NestJS（@nestjs/core）→ 优先选择 sentry-nestjs-sdk，而不是 sentry-node-sdk
• Next.js → 优先选择 sentry-nextjs-sdk，而不是 sentry-react-sdk 或 sentry-node-sdk
• React Router Framework（@sentry/react-router 或 @react-router/*）→ 优先选择 sentry-react-router-framework-sdk，而不是 sentry-react-sdk
• TanStack Start React（@tanstack/react-start）→ 优先选择 sentry-tanstack-start-sdk，而不是 sentry-react-sdk
• Flutter（包含 flutter: 依赖或 sentry_flutter 的 pubspec.yaml）→ sentry-flutter-sdk
• React Native → 优先选择 sentry-react-native-sdk，而不是 sentry-react-sdk
• PHP，且使用 Laravel 或 Symfony → sentry-php-sdk
• Elixir（检测到 mix.exs）→ sentry-elixir-sdk
• Node.js / Bun / Deno，未使用特定框架 → sentry-node-sdk
• 浏览器 JS（原生 JavaScript、jQuery、静态网站）→ sentry-browser-sdk
• 无匹配项 → 引导用户访问 Sentry 文档

快速查找

根据关键词为你的项目匹配对应的技能。

关键词	技能
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，请引导他们找到它：

1. 打开 Sentry 项目设置页面：https://sentry.io/settings/projects/
2. 选择项目
3. 点击左侧边栏中的 "Client Keys (DSN)"
4. 复制 DSN

你可以帮助用户直接打开该页面：

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

注意： DSN 是公开信息，可以安全地包含在源代码中。它不是机密信息，只用于标识事件的发送目标。

---

要查找工作流或功能配置？请参阅完整技能树。