FractalUpOptions class

Configuration object used by FractalUp.init.

Constructors

FractalUpOptions({String? dsn})
Creates Flutter SDK options.

Properties

allowUrls ↔ List<String>
URL allow-list retained for migration-compatible configuration.
getter/setter pair
anrEnabled ↔ bool
Keeps compatibility with ANR tracking options.
getter/setter pair
anrTimeoutInterval ↔ Duration
ANR timeout interval retained for compatibility.
getter/setter pair
appHangTimeoutInterval ↔ Duration
App hang timeout interval retained for compatibility.
getter/setter pair
appInBackgroundTracingThreshold ↔ Duration
Threshold for background tracing behavior.
getter/setter pair
appName ↔ String?
Human-readable application name.
getter/setter pair
attachScreenshot ↔ bool
Requests screenshots for compatible platform implementations.
getter/setter pair
attachStacktrace ↔ bool
Captures stack traces when message APIs represent errors.
getter/setter pair
attachThreads ↔ bool
Keeps compatibility with thread attachment options.
getter/setter pair
attachViewHierarchy ↔ bool
Requests view hierarchy capture for compatible platforms.
getter/setter pair
autoInitializeNativeSdk ↔ bool
Keeps compatibility with native-agent initialization options.
getter/setter pair
autoInstrumentation ↔ bool
Enables the recommended automatic instrumentation preset.
getter/setter pair
autoSessionTrackingInterval ↔ Duration
Auto session tracking interval.
getter/setter pair
beforeBreadcrumb ↔ dynamic
Callback that can mutate or drop breadcrumbs.
getter/setter pair
beforeCaptureScreenshot ↔ dynamic
Callback retained for screenshot capture compatibility.
getter/setter pair
beforeCaptureViewHierarchy ↔ dynamic
Callback retained for view hierarchy capture compatibility.
getter/setter pair
beforeSend ↔ dynamic
Callback that can mutate or drop final event payloads.
getter/setter pair
beforeSendFeedback ↔ dynamic
Callback retained for feedback filtering compatibility.
getter/setter pair
beforeSendLog ↔ dynamic
Callback retained for log filtering compatibility.
getter/setter pair
beforeSendMetric ↔ dynamic
Callback retained for metric filtering compatibility.
getter/setter pair
beforeSendSpan ↔ dynamic
Callback retained for span filtering compatibility.
getter/setter pair
beforeSendTransaction ↔ dynamic
Callback retained for transaction filtering compatibility.
getter/setter pair
captureAppLifecycle ↔ bool
Emits Flutter lifecycle events.
getter/setter pair
captureAppStart ↔ bool
Emits app startup timing when automatic instrumentation is enabled.
getter/setter pair
captureFailedRequests ↔ bool
Captures failed HTTP requests when instrumentation is installed.
getter/setter pair
captureFlutterErrors ↔ bool
Captures Flutter framework errors.
getter/setter pair
capturePlatformDispatcherErrors ↔ bool
Captures platform dispatcher errors.
getter/setter pair
captureZoneErrors ↔ bool
Runs the app runner inside a guarded zone.
getter/setter pair
compressPayload ↔ bool
Keeps compatibility with SDKs that expose payload compression toggles.
getter/setter pair
connectionTimeout ↔ Duration
Connection timeout used by compatible integrations.
getter/setter pair
contexts ↔ Map<String, Object?>?
Contexts attached to every event.
getter/setter pair
debug ↔ bool
Enables SDK diagnostic behavior for local development.
getter/setter pair
defaultAttributes ↔ Map<String, Object?>?
Attributes attached to every event.
getter/setter pair
denyUrls ↔ List<String>
URL deny-list retained for migration-compatible configuration.
getter/setter pair
diagnosticLevel ↔ FractalUpLevel
Diagnostic log level used by compatibility configuration.
getter/setter pair
dist ↔ String?
Distribution identifier for release variants.
getter/setter pair
dsn ↔ String?
Migration-compatible DSN value.
getter/setter pair
enableAppHangTracking ↔ bool
Keeps compatibility with app hang tracking options.
getter/setter pair
enableAppLifecycleBreadcrumbs ↔ bool
Records app lifecycle breadcrumbs.
getter/setter pair
enableAutoNativeBreadcrumbs ↔ bool
Keeps compatibility with native breadcrumb options.
getter/setter pair
enableAutoPerformanceTracing ↔ bool
Enables automatic performance tracing hooks.
getter/setter pair
enableAutoSessionTracking ↔ bool
Enables automatic session tracking.
getter/setter pair
enableBrightnessChangeBreadcrumbs ↔ bool
Records platform brightness change breadcrumbs.
getter/setter pair
enableDartSymbolication ↔ bool
Enables Dart stack symbol processing where available.
getter/setter pair
enableDeduplication ↔ bool
Deduplicates repeated error events in a bounded time window.
getter/setter pair
enableExceptionTypeIdentification ↔ bool
Attempts to classify exception types for grouping.
getter/setter pair
enableFramesTracking ↔ bool
Keeps compatibility with frame tracking options.
getter/setter pair
enableLogs ↔ bool
Enables structured log capture APIs.
getter/setter pair
enableMemoryPressureBreadcrumbs ↔ bool
Records memory pressure breadcrumbs.
getter/setter pair
enableMetrics ↔ bool
Enables metric aggregation APIs.
getter/setter pair
enableNativeCrashHandling ↔ bool
Keeps compatibility with native crash handling options.
getter/setter pair
enableNativeTraceSync ↔ bool
Synchronizes native trace context where available.
getter/setter pair
enableNdkScopeSync ↔ bool
Keeps compatibility with NDK scope synchronization options.
getter/setter pair
enablePrintBreadcrumbs ↔ bool
Records print/debug output as breadcrumbs when supported.
getter/setter pair
enableScopeSync ↔ bool
Synchronizes configured scope data into emitted events.
getter/setter pair
enableTextScaleChangeBreadcrumbs ↔ bool
Records text scale change breadcrumbs.
getter/setter pair
enableTimeToFullDisplayTracing ↔ bool
Enables time-to-full-display tracing support.
getter/setter pair
enableTombstone ↔ bool
Keeps compatibility with native tombstone capture options.
getter/setter pair
enableUserInteractionBreadcrumbs ↔ bool
Records user interaction breadcrumbs where available.
getter/setter pair
enableUserInteractionTracing ↔ bool
Creates traces for user interactions where available.
getter/setter pair
enableWatchdogTerminationTracking ↔ bool
Keeps compatibility with watchdog termination tracking options.
getter/setter pair
enableWindowMetricBreadcrumbs ↔ bool
Records window metric breadcrumbs where available.
getter/setter pair
endpoint ↔ Uri?
Custom ingestion endpoint.
getter/setter pair
environment ↔ String?
Deployment environment label, such as dev, qa, or production-eu.
getter/setter pair
eventProcessors → List
Compatibility event processors registered by callers.
final
firstPartyHosts ↔ Set<String>
Hosts that should receive distributed trace headers.
getter/setter pair
hashCode → int
The hash code for this object.
no setterinherited
httpClient ↔ Client?
HTTP client used for FractalUp ingestion.
getter/setter pair
idleTimeout ↔ Duration?
Idle timeout used by compatible tracing helpers.
getter/setter pair
ignoredExceptionsForType → List<Type>
Exception types ignored by compatible integrations.
final
ignoreErrors ↔ List<String>
Error message patterns ignored by compatible integrations.
getter/setter pair
ignoreTransactions ↔ List<String>
Transaction name patterns ignored by compatible integrations.
getter/setter pair
inAppExcludes → List<String>
Stack frame exclude patterns.
final
inAppIncludes → List<String>
Stack frame include patterns.
final
includeModuleInStackTrace ↔ bool
Includes module names in stack frame metadata when available.
getter/setter pair
ingestionKey ↔ String?
FractalUp ingestion key used to authenticate SDK payloads.
getter/setter pair
installErrorHooks ↔ bool
Installs Flutter and platform dispatcher error hooks.
getter/setter pair
integrations → List
Compatibility integration objects registered by callers.
final
markAutomaticallyCollectedErrorsAsFatal ↔ bool
Marks automatically collected unhandled errors as fatal.
getter/setter pair
maxAttachmentSize ↔ int
Maximum accepted attachment size in bytes.
getter/setter pair
maxBreadcrumbs ↔ int
Maximum breadcrumbs retained in scope.
getter/setter pair
maxCacheItems ↔ int
Maximum compatibility cache entries.
getter/setter pair
maxDeduplicationItems ↔ int
Maximum error deduplication entries.
getter/setter pair
maxErrorEventsPerMinute ↔ int
Maximum error events sent per minute.
getter/setter pair
maxEventsPerMinute ↔ int
Maximum total events sent per minute.
getter/setter pair
maxMetricAggregations ↔ int
Maximum local metric aggregation buckets.
getter/setter pair
maxPersistedQueueBytes ↔ int
Maximum persisted queue size in bytes.
getter/setter pair
maxPersistedQueuedEvents ↔ int
Maximum number of events kept in persisted storage.
getter/setter pair
maxQueueSize ↔ int
Maximum in-memory event queue size.
getter/setter pair
maxSpans ↔ int
Maximum spans retained by compatibility tracing helpers.
getter/setter pair
maxTransportAttempts ↔ int
Maximum transport attempts for retryable failures.
getter/setter pair
metricAggregationInterval ↔ Duration
Interval used to flush aggregated metrics.
getter/setter pair
nativeDatabasePath ↔ String?
Native database path used by migration-compatible setups.
getter/setter pair
offlineQueuePath ↔ String?
Path for persisted offline queue storage.
getter/setter pair
orgId ↔ String?
Organization identifier used by migration-compatible setups.
getter/setter pair
persistQueuedEvents ↔ bool
Persists queued telemetry so it can be retried after restart.
getter/setter pair
preserveExistingHandlers ↔ bool
Calls existing error handlers after FractalUp captures an error.
getter/setter pair
privacy → FractalUpPrivacyOptions
Privacy configuration retained for migration compatibility.
final
profilesSampleRate ↔ double?
Profiling sample rate retained for compatibility.
getter/setter pair
proguardUuid ↔ String?
Android ProGuard UUID used by migration-compatible setups.
getter/setter pair
propagateTraceparent ↔ bool
Injects W3C trace context into instrumented first-party requests.
getter/setter pair
readTimeout ↔ Duration
Read timeout used by FractalUp transport.
getter/setter pair
recordHttpBreadcrumbs ↔ bool
Records HTTP request breadcrumbs.
getter/setter pair
redactUrlQueryParameters ↔ bool
Redacts all URL query parameter values before transport.
getter/setter pair
release ↔ String?
Release or app version attached to every payload.
getter/setter pair
replay → FractalUpReplayOptions
Session replay configuration retained for migration compatibility.
final
reportPackages ↔ bool
Reports package/module metadata where available.
getter/setter pair
reportSilentFlutterErrors ↔ bool
Reports Flutter errors that the framework marks as silent.
getter/setter pair
reportViewHierarchyIdentifiers ↔ bool
Includes view identifiers in view hierarchy data.
getter/setter pair
requestHeadersProvider ↔ FractalupRadarRequestHeadersProvider?
Provider for safe current request headers.
getter/setter pair
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
sampleRate ↔ double?
Global event sample rate from 0.0 to 1.0.
getter/setter pair
screenshotQuality ↔ FractalUpScreenshotQuality
Screenshot quality requested by compatible platform integrations.
getter/setter pair
sendClientReports ↔ bool
Adds client drop, rate-limit, and deduplication reports to payloads.
getter/setter pair
sendDefaultPii ↔ bool
Allows personally identifiable data when explicitly enabled.
getter/setter pair
sensitiveQueryParameters ↔ Set<String>?
Additional URL query parameters to redact.
getter/setter pair
serverName ↔ String?
Logical server or app instance name.
getter/setter pair
serviceName ↔ String?
Service name shown in FractalUp observability views.
getter/setter pair
sourceId ↔ String?
FractalUp source identifier for the target environment.
getter/setter pair
strictTraceContinuation ↔ bool
Restricts trace continuation to trusted propagation targets.
getter/setter pair
tags ↔ Map<String, Object?>?
Tags attached to every event.
getter/setter pair
traceLifecycle ↔ FractalUpTraceLifecycle
Trace lifecycle mode used by compatibility configuration.
getter/setter pair
tracePropagationTargets ↔ List<String>
Trace propagation target patterns.
getter/setter pair
tracesSampler ↔ dynamic
Callback retained for trace sampling compatibility.
getter/setter pair
tracesSampleRate ↔ double?
Trace sample rate from 0.0 to 1.0.
getter/setter pair
transportHeaders ↔ Map<String, String>?
Extra headers sent with FractalUp ingestion requests.
getter/setter pair
user ↔ FractalUpUser?
Initial user attached to the configured scope.
getter/setter pair

Methods

addEventProcessor(dynamic processor) → void
Registers a compatibility event processor.
addExceptionTypeFilter(Type type) → void
Ignores exceptions of type in compatible integrations.
addInAppExclude(String exclude) → void
Adds an in-app stack frame exclude pattern.
addInAppInclude(String include) → void
Adds an in-app stack frame include pattern.
addIntegration(dynamic integration) → void
Registers a compatibility integration object.
addIntegrationByIndex(int index, dynamic integration) → void
Inserts a compatibility integration object at index.
enableBreadcrumbTrackingForCurrentPlatform() → void
Enables breadcrumb tracking for the current platform when available.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited