otel_isar 0.2.0
otel_isar: ^0.2.0 copied to clipboard
OpenTelemetry instrumentation for `package:isar`. Helpers to wrap Isar collection operations and transactions with `db.system.name=isar` semconv spans.
Changelog #
0.2.0 - 2026-08-10 #
Changed #
- Semantic conventions updated to the current OTel registry: deprecated
attribute keys are no longer emitted or asserted (
db.system->db.system.name,db.operation->db.operation.name); docs and tests now reference the current keys. - Dependency floors raised to
dartastic_opentelemetry ^1.1.0-beta.12anddartastic_opentelemetry_api ^1.0.0-rc.1. The previous floors declared compatibility with API versions that predate the semconv enums this package uses and could not actually resolve-and-compile. repositoryURL corrected to the canonicalDartasticorg casing so pub.dev repository verification succeeds.
Added #
tracedIsarCall<R>({operation, collection, invoke})— generic helper that opens a CLIENT span withdb.system.name=isar,db.operation.name,db.collection.namearound an Isar operation. Wrap individual collection calls or your data-layer methods.tracedIsarWriteTxn<R>(body)— convenience forisar.writeTxn(...)wrapped in a span.tracedIsarReadTxn<R>(body)— same for read transactions.- Zone-scoped suppression
(
runWithoutIsarInstrumentation/ async variant). - Runnable
example/main.dart(console exporter, no network). - 4 tests via the generic helper.