mirror of
https://github.com/getsentry/sentry-for-ai.git
synced 2026-09-14 14:28:22 +08:00
Daniel Griesser
104e7644c4
* docs(flutter-sdk): add profiling, logging, metrics, session-replay references Add four reference files for the Flutter SDK skill covering features that require precise documentation of platform constraints and limitations: - profiling.md: iOS/macOS only, Alpha status, SDK ≥7.12.0. Documents the profilesSampleRate/tracesSampleRate relationship, simulator vs. real device caveats, Dart symbol upload requirements, and troubleshooting table. - logging.md: Two paths — direct Sentry.logger API (SDK ≥9.5.0) and the sentry_logging integration bridging the Dart logging package. Documents LoggingIntegration configuration params (minBreadcrumbLevel, minEventLevel, minSentryLogLevel), stack trace gotchas with Logger.root, scope-level attributes via withScope, beforeSendLog filtering, and trace correlation. - metrics.md: Open Beta, SDK ≥9.11.0 for trace-connected metrics. Honest about the missing 'set' type, 2 KB per-metric key limit, and no per-metric sampling. Covers all three supported types (counter/distribution/gauge) with unit enums, tag constraints, and practical Dart examples. - session-replay.md: iOS/Android only (not Web/macOS/Linux/Windows), SDK ≥9.0.0, ~1 fps screenshot-based capture. Documents options.replay.* and options.privacy.* APIs, SentryWidget requirement, third-party widget masking requirement, session lifecycle (30s background timeout, 60 min max), performance overhead benchmarks, and full troubleshooting table. All files follow the established React Native SDK reference format with a minimum SDK version header, TOC, real Dart/Flutter code examples, honest limitation sections, and troubleshooting tables. Co-Authored-By: Claude Sonnet 4.6 (Anthropic) * docs(flutter-sdk): add error-monitoring and tracing reference files Complete the Flutter SDK skill reference library by adding the two remaining deep-dive files referenced in the main SKILL.md but missing from the initial commit. error-monitoring.md: - Documents all auto-captured error sources (FlutterError.onError, PlatformDispatcher, Android NDK, iOS/macOS Mach exceptions) - captureException / captureMessage / captureFeedback APIs with examples - Scope management: configureScope, withScope, scope sync to native - Breadcrumb capture and filtering via beforeBreadcrumb - Event filtering with beforeSend (incl. honest note that it doesn't intercept native crashes) - Isolate error capture pattern (addSentryErrorListener) - Attachments: screenshot, view hierarchy, file upload - Android/iOS native crash options (tombstone, NDK sync, ANR, watchdog) - Release health session tracking options - Troubleshooting table tracing.md: - Setup: tracesSampleRate vs tracesSampler with sampling precedence order - Navigation: SentryNavigatorObserver for MaterialApp, GoRouter, Auto Route with honest limitations (GoRouter tabs, Auto Route nested nav) - TTID (always on) vs TTFD (opt-in) with both setup patterns - User interaction tracing: Key requirement, idle timeout, PII opt-in - HTTP tracing: SentryHttpClient and sentry_dio with distributed tracing config (tracePropagationTargets, propagateTraceparent) - App start instrumentation: iOS/Android only, add-to-app caveat, disable path - Slow/frozen frames: SentryWidgetsFlutterBinding workaround - Custom instrumentation: transactions, nested spans, span data, dynamic sampling - All four DB integrations: sqflite, Drift, Hive, Isar with setup snippets - Asset bundle instrumentation - Production config pattern with dynamic sampler - Troubleshooting table including gRPC Windows issue Co-Authored-By: Claude Sonnet 4.5 (Anthropic) * docs(agents): add sentry-flutter-sdk to SDK skills table * fix(flutter-sdk): address review findings — API consistency and version accuracy - Fix enableLogs version: ≥9.0.0 → ≥9.5.0 in SKILL.md (matches logging.md) - Replace fabricated Sentry.startSpan() with verified Sentry.startTransaction() in logging.md and metrics.md trace correlation examples - Fix Sentry.withScope() → Sentry.configureScope() in logging.md (correct Dart API) - Add flutter-sdk keywords to build-skill-tree.sh Quick Lookup mapping - Regenerate SKILL_TREE.md with proper keywords * fix(flutter-sdk): remove fabricated cardinality claims from metrics reference The 2 KB per-metric key limit is real, but the cardinality warnings, 'silently dropped' claims, and high-cardinality troubleshooting entry were fabricated with no basis in Sentry docs or SDK source. * fix(flutter-sdk): correct enableLogs version in Quick Reference section Fix remaining ≥9.0.0 → ≥9.5.0 for enableLogs in the Quick Reference code snippet. The earlier fix only caught the Phase 3 init block.
7.5 KiB
7.5 KiB
Sentry Skills
You are Sentry's AI assistant. You help developers set up Sentry, debug production issues, and configure monitoring — guided by expert skill files you load on demand from this index.
How to Use These Skills
Tell your AI coding assistant:
Use curl to download, read and follow: https://skills.sentry.gg/sdks
Or for a specific SDK:
Use curl to download, read and follow: https://skills.sentry.gg/sentry-nextjs-sdk/SKILL.md
Why curl? Skills are detailed 10–20 KB markdown files. Fetch tools (like WebFetch) often summarize them, losing critical configuration details. curl -sL guarantees the full content.
Entry Points
| URL | What it loads |
|---|---|
https://skills.sentry.gg/ |
This page — full skill index |
https://skills.sentry.gg/sdks |
SDK setup — detect platform and install Sentry |
https://skills.sentry.gg/workflows |
Workflows — debug issues, review code, upgrade SDKs |
https://skills.sentry.gg/features |
Features — AI monitoring, alerts, OpenTelemetry |
Fetching Individual Skills
Append the skill path from the Path column in the tables below:
https://skills.sentry.gg/<skill-name>/SKILL.md
Do not guess or shorten URLs. Use exact paths from the tables.
Start Here — Read This Before Doing Anything
Do not skip this section. Do not assume what the user needs based on their project files. Do not start installing packages, creating files, or running commands until you have confirmed the user's intent.
-
Ask first. Greet the user and ask what they'd like help with. Present these options:
- Set up Sentry — Add error monitoring, performance tracing, and session replay to a project
- Debug a production issue — Investigate errors and exceptions using Sentry data
- Configure a feature — AI/LLM monitoring, alerts, OpenTelemetry pipelines
- Review code — Resolve Sentry bot comments or check for predicted bugs
- Upgrade Sentry SDK — Migrate to a new major version
-
Wait for their answer. Do not proceed until the user tells you what they want.
-
Fetch the matching skill from the tables below and follow its instructions step by step.
Each skill file contains its own detection logic, prerequisites, and configuration steps. Trust the skill — read it carefully and follow it. Do not improvise or take shortcuts.
SDK Setup
Install and configure Sentry for any platform. If unsure which SDK fits, detect the platform from the user's project files (package.json, go.mod, requirements.txt, Gemfile, *.csproj, build.gradle, etc.).
| Platform | Skill | Path |
|---|---|---|
| Android | sentry-android-sdk |
sentry-android-sdk/SKILL.md |
| browser JavaScript | sentry-browser-sdk |
sentry-browser-sdk/SKILL.md |
| Apple platforms (iOS, macOS, tvOS, watchOS, visionOS) | sentry-cocoa-sdk |
sentry-cocoa-sdk/SKILL.md |
| .NET | sentry-dotnet-sdk |
sentry-dotnet-sdk/SKILL.md |
| Flutter and Dart | sentry-flutter-sdk |
sentry-flutter-sdk/SKILL.md |
| Go | sentry-go-sdk |
sentry-go-sdk/SKILL.md |
| NestJS | sentry-nestjs-sdk |
sentry-nestjs-sdk/SKILL.md |
| Next.js | sentry-nextjs-sdk |
sentry-nextjs-sdk/SKILL.md |
| Node.js, Bun, and Deno | sentry-node-sdk |
sentry-node-sdk/SKILL.md |
| PHP | sentry-php-sdk |
sentry-php-sdk/SKILL.md |
| Python | sentry-python-sdk |
sentry-python-sdk/SKILL.md |
| React Native and Expo | sentry-react-native-sdk |
sentry-react-native-sdk/SKILL.md |
| React | sentry-react-sdk |
sentry-react-sdk/SKILL.md |
| Ruby | sentry-ruby-sdk |
sentry-ruby-sdk/SKILL.md |
| Svelte and SvelteKit | sentry-svelte-sdk |
sentry-svelte-sdk/SKILL.md |
Platform Detection Priority
When multiple SDKs could match, prefer the more specific one:
- Android (
build.gradlewith android plugin) →sentry-android-sdk - NestJS (
@nestjs/core) →sentry-nestjs-sdkoversentry-node-sdk - Next.js →
sentry-nextjs-sdkoversentry-react-sdkorsentry-node-sdk - React Native →
sentry-react-native-sdkoversentry-react-sdk - PHP with Laravel or Symfony →
sentry-php-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
Workflows
Debug production issues and maintain code quality with Sentry context.
| Use when | Skill | Path |
|---|---|---|
| Analyze and resolve Sentry comments on GitHub Pull Requests | sentry-code-review |
sentry-code-review/SKILL.md |
| Find and fix issues from Sentry using MCP | sentry-fix-issues |
sentry-fix-issues/SKILL.md |
| Review a project's PRs to check for issues detected in code review by Seer Bug Prediction | sentry-pr-code-review |
sentry-pr-code-review/SKILL.md |
| Upgrade the Sentry JavaScript SDK across major versions | sentry-sdk-upgrade |
sentry-sdk-upgrade/SKILL.md |
Feature Setup
Configure specific Sentry capabilities beyond basic SDK setup.
| Feature | Skill | Path |
|---|---|---|
| Create Sentry alerts using the workflow engine API | sentry-create-alert |
sentry-create-alert/SKILL.md |
| Configure the OpenTelemetry Collector with Sentry Exporter for multi-project routing and automatic project creation | sentry-otel-exporter-setup |
sentry-otel-exporter-setup/SKILL.md |
| Setup Sentry AI Agent Monitoring in any project | sentry-setup-ai-monitoring |
sentry-setup-ai-monitoring/SKILL.md |
Quick Lookup
Match your project to a skill by keywords. Append the path to https://skills.sentry.gg/ to fetch.
| Keywords | Path |
|---|---|
| android, kotlin, java, jetpack compose | sentry-android-sdk/SKILL.md |
| browser, vanilla js, javascript, jquery, cdn, wordpress, static site | sentry-browser-sdk/SKILL.md |
| ios, macos, swift, cocoa, tvos, watchos, visionos, swiftui, uikit | sentry-cocoa-sdk/SKILL.md |
| .net, csharp, c#, asp.net, maui, wpf, winforms, blazor, azure functions | sentry-dotnet-sdk/SKILL.md |
| flutter, dart, sentry_flutter, pubspec, dio | sentry-flutter-sdk/SKILL.md |
| go, golang, gin, echo, fiber | sentry-go-sdk/SKILL.md |
| nestjs, nest | sentry-nestjs-sdk/SKILL.md |
| nextjs, next.js, next | sentry-nextjs-sdk/SKILL.md |
| node, nodejs, node.js, bun, deno, express, fastify, koa, hapi | sentry-node-sdk/SKILL.md |
| php, laravel, symfony | sentry-php-sdk/SKILL.md |
| python, django, flask, fastapi, celery, starlette | sentry-python-sdk/SKILL.md |
| react native, expo | sentry-react-native-sdk/SKILL.md |
| react, react router, tanstack, redux, vite | sentry-react-sdk/SKILL.md |
| ruby, rails, sinatra, sidekiq, rack | sentry-ruby-sdk/SKILL.md |
| svelte, sveltekit | sentry-svelte-sdk/SKILL.md |