@mastra/observability 1.17.1 → 1.17.2-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @mastra/observability
 
+## 1.17.2-alpha.0
+
+### Patch Changes
+
+- Fixed `MastraStorageExporter` staying disabled when a configured observability store is temporarily unavailable during startup. The exporter now recovers on a later event, so traces resume without restarting the process. (#21943) ([#21957](https://github.com/mastra-ai/mastra/pull/21957))
+
+- Updated dependencies [[`f95f468`](https://github.com/mastra-ai/mastra/commit/f95f468cf1e7c2b924a13826494f98b8f2ccd581)]:
+  - @mastra/core@1.61.1-alpha.1
+
 ## 1.17.1
 
 ### Patch Changes

package/dist/exporters/mastra-storage.d.ts

@@ -23,6 +23,9 @@ export declare class MastraStorageExporter extends BaseExporter {
      * Initialize the exporter (called after all dependencies are ready)
      */
     init(options: InitExporterOptions): Promise<void>;
+    private warnUnavailable;
+    private initializeStorage;
+    private ensureInitialized;
     /**
      * Checks if buffer should be flushed based on size or time triggers
      */
@@ -63,12 +66,6 @@ export declare class MastraStorageExporter extends BaseExporter {
      */
     private flushBuffer;
     _exportTracingEvent(event: TracingEvent): Promise<void>;
-    /**
-     * Resolves when an ongoing init call is finished
-     * Doesn't wait for the caller to call init
-     * @returns
-     */
-    private waitForInit;
     /**
      * Handle metric events — buffer for batch flush.
      */

package/dist/exporters/mastra-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mastra-storage.d.ts","sourceRoot":"","sources":["../../src/exporters/mastra-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,aAAa,EAId,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAwB,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AAS/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,4FAA4F;AAC5F,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;CAC5C;AAoCD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;;IACrD,IAAI,SAA6B;gBAgBrB,MAAM,GAAE,2BAAgC;IAiBpD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDvD;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;IAiBzB;;;;OAIG;YACW,kBAAkB;IAQhC,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,QAAQ;IAsBhB;;;;OAIG;YACW,YAAY;IAkC1B;;;OAGG;YACW,gBAAgB;IA+D9B;;;;;;;OAOG;YACW,WAAW;IA+HnB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D;;;;OAIG;YACW,WAAW;IAOzB;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBhC"}
+{"version":3,"file":"mastra-storage.d.ts","sourceRoot":"","sources":["../../src/exporters/mastra-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,aAAa,EAId,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAwB,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AAS/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,4FAA4F;AAC5F,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;CAC5C;AAkCD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;;IACrD,IAAI,SAA6B;gBAgBrB,MAAM,GAAE,2BAAgC;IAiBpD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,OAAO,CAAC,eAAe;YAUT,iBAAiB;YA6CjB,iBAAiB;IAS/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;IAiBzB;;;;OAIG;YACW,kBAAkB;IAQhC,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,QAAQ;IAsBhB;;;;OAIG;YACW,YAAY;IAkC1B;;;OAGG;YACW,gBAAgB;IA+D9B;;;;;;;OAOG;YACW,WAAW;IA+HnB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBhC"}

package/dist/index.cjs

@@ -7123,8 +7123,8 @@ const FLUSH_SUCCEEDED = { failed: false };
 var MastraStorageExporter = class extends BaseExporter {
 	name = "mastra-storage-exporter";
 	#config;
-	#isInitializing = false;
-	#initPromises = /* @__PURE__ */ new Set();
+	#initializationPromise;
+	#wasUnavailable = false;
 	#eventBuffer;
 	#storage;
 	#observabilityStorage;
@@ -7149,41 +7149,56 @@ var MastraStorageExporter = class extends BaseExporter {
 	* Initialize the exporter (called after all dependencies are ready)
 	*/
 	async init(options) {
+		this.#emitDropEvent = options.emitDropEvent;
+		this.#storage = options.mastra?.getStorage();
+		if (!this.#storage) {
+			this.logger.warn("MastraStorageExporter disabled: Storage not available. Traces will not be persisted.");
+			return;
+		}
+		await this.ensureInitialized();
+	}
+	warnUnavailable(message, error) {
+		if (this.#wasUnavailable) return;
+		this.#wasUnavailable = true;
+		if (error === void 0) {
+			this.logger.warn(message);
+			return;
+		}
+		this.logger.warn(message, { error: error instanceof Error ? error.message : String(error) });
+	}
+	async initializeStorage() {
+		const storage = this.#storage;
+		if (!storage) return;
 		try {
-			this.#isInitializing = true;
-			this.#emitDropEvent = options.emitDropEvent;
-			this.#storage = options.mastra?.getStorage();
-			if (!this.#storage) {
-				this.logger.warn("MastraStorageExporter disabled: Storage not available. Traces will not be persisted.");
-				return;
-			}
-			this.#observabilityStorage = await this.#storage.getStore("observability");
-			if (!this.#observabilityStorage) {
-				this.logger.warn("MastraStorageExporter disabled: Observability storage not available. Traces will not be persisted.");
-				return;
-			}
-			if (!this.#resolvedStrategy) {
-				this.#resolvedStrategy = resolveTracingStorageStrategy(this.#config, this.#observabilityStorage, this.#storage.constructor.name, this.logger);
-				this.logger.debug("tracing storage exporter initialized", {
-					strategy: this.#resolvedStrategy,
-					source: this.#config.strategy !== "auto" ? "user" : "auto",
-					storageAdapter: this.#storage.constructor.name,
-					maxBatchSize: this.#config.maxBatchSize,
-					maxBatchWaitMs: this.#config.maxBatchWaitMs
-				});
-			}
-			if (this.#resolvedStrategy) this.#eventBuffer.init({ strategy: this.#resolvedStrategy });
-		} finally {
-			this.#isInitializing = false;
-			/**
-			* Assumes caller waits until export of a parent span is completed before calling
-			* export for child spans , order is not relevant for resolve
-			*/
-			this.#initPromises.forEach((resolve) => {
-				resolve();
-			});
-			this.#initPromises.clear();
+			this.#observabilityStorage = await storage.getStore("observability");
+		} catch (error) {
+			this.warnUnavailable("MastraStorageExporter unavailable: Failed to initialize observability storage. Traces will not be persisted until storage becomes available.", error);
+			return;
 		}
+		if (!this.#observabilityStorage) {
+			this.warnUnavailable("MastraStorageExporter unavailable: Observability storage not available. Traces will not be persisted until storage becomes available.");
+			return;
+		}
+		this.#resolvedStrategy = resolveTracingStorageStrategy(this.#config, this.#observabilityStorage, storage.constructor.name, this.logger);
+		this.#eventBuffer.init({ strategy: this.#resolvedStrategy });
+		this.logger.debug("tracing storage exporter initialized", {
+			strategy: this.#resolvedStrategy,
+			source: this.#config.strategy !== "auto" ? "user" : "auto",
+			storageAdapter: storage.constructor.name,
+			maxBatchSize: this.#config.maxBatchSize,
+			maxBatchWaitMs: this.#config.maxBatchWaitMs
+		});
+		if (this.#wasUnavailable) {
+			this.#wasUnavailable = false;
+			this.logger.info("MastraStorageExporter recovered: Observability storage is available. Traces will be persisted.");
+		}
+	}
+	async ensureInitialized() {
+		if (this.#observabilityStorage || !this.#storage) return;
+		this.#initializationPromise ??= this.initializeStorage().finally(() => {
+			this.#initializationPromise = void 0;
+		});
+		await this.#initializationPromise;
 	}
 	/**
 	* Checks if buffer should be flushed based on size or time triggers
@@ -7435,7 +7450,7 @@ var MastraStorageExporter = class extends BaseExporter {
 		}
 	}
 	async _exportTracingEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) {
 			this.logger.debug("Cannot store traces. Observability storage is not initialized");
 			return;
@@ -7444,21 +7459,10 @@ var MastraStorageExporter = class extends BaseExporter {
 		await this.handleBatchedFlush();
 	}
 	/**
-	* Resolves when an ongoing init call is finished
-	* Doesn't wait for the caller to call init
-	* @returns
-	*/
-	async waitForInit() {
-		if (!this.#isInitializing) return;
-		return new Promise((resolve) => {
-			this.#initPromises.add(resolve);
-		});
-	}
-	/**
 	* Handle metric events — buffer for batch flush.
 	*/
 	async onMetricEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) return;
 		this.#eventBuffer.addEvent(event);
 		await this.handleBatchedFlush();
@@ -7467,7 +7471,7 @@ var MastraStorageExporter = class extends BaseExporter {
 	* Handle log events — buffer for batch flush.
 	*/
 	async onLogEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) return;
 		this.#eventBuffer.addEvent(event);
 		await this.handleBatchedFlush();
@@ -7476,7 +7480,7 @@ var MastraStorageExporter = class extends BaseExporter {
 	* Handle score events — buffer for batch flush.
 	*/
 	async onScoreEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) return;
 		this.#eventBuffer.addEvent(event);
 		await this.handleBatchedFlush();
@@ -7485,7 +7489,7 @@ var MastraStorageExporter = class extends BaseExporter {
 	* Handle feedback events — buffer for batch flush.
 	*/
 	async onFeedbackEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) return;
 		this.#eventBuffer.addEvent(event);
 		await this.handleBatchedFlush();