bloom_observability library
Error observability, crash reporting SDK, breadcrumbs, and telemetry subsystem for Bloom.
Exports breadcrumb logging, hardware/software device fingerprinting, error event models, navigation routing observers, and HTTP telemetry transports.
Example:
import 'package:bloom_framework/bloom_observability.dart';
void main() {
BloomObservability.init(
options: BloomObservabilityOptions(
endpoint: 'https://telemetry.example.com/events',
),
);
BloomObservability.leaveBreadcrumb('App started');
}
Classes
- BloomBreadcrumb
- A structured breadcrumb recording a user action, network call, or state mutation.
- BloomBreadcrumbRingBuffer
- Fixed-capacity ring buffer for storing recent chronological breadcrumbs.
- BloomCrashFingerprint
- Utilities for calculating deterministic crash grouping fingerprints.
- BloomHttpTelemetryTransport
- Production HTTP transport that posts JSON telemetry payloads to a remote collector endpoint.
- BloomMemoryTelemetryTransport
- In-memory transport storing telemetry events in a list (ideal for unit testing and debugging).
- BloomObservability
- Core Error Observability, Crash Reporting, and Telemetry Engine for Bloom.
- BloomObservabilityConfig
- Configuration options for Bloom Error Observability and Telemetry SDK.
- NavigatorObserver that automatically records route transition breadcrumbs.
- BloomTelemetryEvent
- A complete structured crash / telemetry event payload.
- BloomTelemetryTransport
- Transport contract for dispatching telemetry and crash events.
Enums
- BloomBreadcrumbLevel
- Severity level for breadcrumb events.
- BloomErrorLevel
- Severity level for telemetry and crash events.
Typedefs
- BeforeSendCallback = BloomTelemetryEvent? Function(BloomTelemetryEvent event)
- Callback signature for intercepting, modifying, or dropping telemetry events before transmission.
Exceptions / Errors
- BloomHttpException
- Exception thrown when telemetry transmission over HTTP fails.