القائمة
Set up Sentry on mobile with error reporting, performance tracing, and session replay. Includes the iOS/Android/Flutter/RN SDKs and the privacy and cost caveats of session replay on mobile.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Emit JSON-structured logs on mobile with correlation ids, consistent field names, and redaction. Use when setting up logging in Kotlin, Swift, Dart, or TypeScript mobile code.
Emit counters, gauges, and histograms from mobile apps using OpenTelemetry metrics, with patterns for batching, labels, and avoiding cardinality explosions. Use when adding product or engineering metrics beyond the core RUM set.
Design actionable metric alerts for mobile telemetry that deep-link to traces and sessions, avoid paging noise, and page only for symptoms users feel. Use when creating or cleaning up Datadog / Grafana / Sentry alerts.
Define and capture the core mobile RUM SLIs (startup time, jank, ANR, crash, network error rate, battery) with Firebase, Sentry, Datadog, or OTel. Use when setting up client-side performance metrics.
Compare and configure mobile APM vendors (Firebase Performance, Sentry Performance, Datadog RUM Mobile, Embrace, New Relic Mobile) and pick the right one for the app. Use when selecting or migrating a performance-monitoring stack.
Measure mobile UX quality with frozen frames, slow frames, ANRs, app hangs, and interaction-to-next-paint style metrics. Use when diagnosing jank, adopting JankStats / MetricKit, or reporting UX health.
| name | sentry-mobile |
| description | Set up Sentry on mobile with error reporting, performance tracing, and session replay. Includes the iOS/Android/Flutter/RN SDKs and the privacy and cost caveats of session replay on mobile. |
Sentry is a unified error + performance + replay tool. On mobile it covers native crashes, ANRs, non-fatals, transactions, and (as of 2024+) session replay. This skill sets up Sentry safely and cost-consciously.
my-app-ios, my-app-android, my-app-flutter) so release health dashboards stay clean.my-app@<semver>+<build> e.g. my-app@4.12.0+4120. Use the same scheme in every SDK.project:read, project:releases, org:read.// build.gradle.kts (app)
plugins {
id("io.sentry.android.gradle") version "4.14.1"
}
sentry {
autoUploadProguardMapping.set(true)
uploadNativeSymbols.set(true)
includeNativeSources.set(false)
tracingInstrumentation {
enabled.set(true)
}
}
class App : Application() {
override fun onCreate() {
super.onCreate()
SentryAndroid.init(this) { options ->
options.dsn = BuildConfig.SENTRY_DSN
options.environment = BuildConfig.BUILD_TYPE
options.release = "my-app@${BuildConfig.VERSION_NAME}+${BuildConfig.VERSION_CODE}"
options.tracesSampleRate = if (BuildConfig.DEBUG) 1.0 else 0.15
options.isEnableAutoSessionTracking = true
options.isAttachScreenshot = false // privacy
options.isAttachViewHierarchy = false // privacy
options.beforeSend = SentryOptions.BeforeSendCallback { event, _ ->
redact(event)
}
}
}
}
Add via SPM (https://github.com/getsentry/sentry-cocoa) and upload dSYMs in a Run Script phase:
SENTRY_CLI="${SRCROOT}/sentry-cli"
"$SENTRY_CLI" debug-files upload --include-sources --auth-token "$SENTRY_AUTH_TOKEN" \
--org my-org --project my-app-ios "$DWARF_DSYM_FOLDER_PATH"
import Sentry
SentrySDK.start { options in
options.dsn = Bundle.main.infoDictionary?["SENTRY_DSN"] as? String
options.environment = Bundle.main.object(forInfoDictionaryKey: "ENVIRONMENT") as? String ?? "release"
options.releaseName = "my-app@\(appVersion)+\(buildNumber)"
options.tracesSampleRate = 0.15
options.enableAppHangTracking = true
options.enableAutoPerformanceTracing = true
options.attachScreenshot = false
options.attachViewHierarchy = false
options.beforeSend = { event in redact(event) }
}
dependencies:
sentry_flutter: ^8.10.1
Future<void> main() async {
await SentryFlutter.init(
(o) {
o.dsn = const String.fromEnvironment('SENTRY_DSN');
o.environment = const String.fromEnvironment('ENV', defaultValue: 'release');
o.release = 'my-app@${packageInfo.version}+${packageInfo.buildNumber}';
o.tracesSampleRate = kReleaseMode ? 0.15 : 1.0;
o.attachScreenshot = false;
o.beforeSend = (event, hint) async => redact(event);
},
appRunner: () => runApp(const MyApp()),
);
}
Upload Dart debug symbols via sentry-cli dart-symbols upload after flutter build --obfuscate --split-debug-info=build/symbols.
yarn add @sentry/react-native
npx @sentry/wizard@latest -i reactNative
import * as Sentry from '@sentry/react-native';
Sentry.init({
dsn: Config.SENTRY_DSN,
environment: Config.ENV,
release: `my-app@${pkg.version}+${buildNumber}`,
tracesSampleRate: __DEV__ ? 1.0 : 0.15,
enableAutoPerformanceTracing: true,
enableNative: true,
beforeSend: redact,
attachScreenshot: false,
});
Sentry.startTransaction for domain-critical flows (checkout, sign-in) so they show up as top-level transactions rather than inside auto-generated parents.tracesSampleRate between 0.10 and 0.20 in production. Use tracesSampler to sample 100% of transactions that contain an error, 1% of noisy background transactions.Mobile session replay is not a browser recorder; it reconstructs the UI hierarchy frame-by-frame at a throttled rate. Before enabling it:
TextView / UILabel / Text by default. Sentry masks by default; verify masking on text, images, webviews, and map views. Explicitly mark anything showing PII with SentryPrivacy.mask(view) (Android) or sentry.mask() modifier (SwiftUI).replaysSessionSampleRate to 0.01-0.05 and set replaysOnErrorSampleRate to 0.5-1.0 so you only pay for sessions that contain errors.options.sessionReplay.onErrorSampleRate = 1.0
options.sessionReplay.sessionSampleRate = 0.02
options.sessionReplay.maskAllText = true
options.sessionReplay.maskAllImages = true
on-call-mobile).tracesSampleRate is configured (10-20% in prod) and documented.beforeSend runs a redactor; screenshots and view hierarchy are OFF unless consented.session <= 0.05, onError <= 1.0.