@mastra/observability 1.18.4-alpha.1 → 1.19.0-alpha.0

package/dist/exporters/tracking.d.ts

@@ -149,6 +149,10 @@ export declare class TraceData<TRootData, TSpanData, TEventData, TMetadata> {
     clearWaitingFor(args: {
         spanId: string;
     }): void;
+    /**
+     * Get the span IDs that have events waiting on them.
+     */
+    getWaitingForSpanIds(): string[];
     /**
      * Get total count of events in all waiting queues.
      */
@@ -448,6 +452,9 @@ export declare abstract class TrackingExporter<TRootData, TSpanData, TEventData,
      * This is useful in serverless environments where you need to ensure spans
      * are exported before the runtime instance is terminated.
      *
+     * Queued events whose dependencies have been built are processed first, so
+     * a shutdown() right after flush() only aborts spans that are still open.
+     *
      * Subclasses should override _flush() to implement vendor-specific flush logic.
      */
     flush(): Promise<void>;

package/dist/exporters/tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/exporters/tracking.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/exporters/tracking.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -3204,6 +3204,7 @@ var BaseSpan = class BaseSpan {
 	exportSpan(includeInternalSpans) {
 		const hideInput = this.traceState?.hideInput ?? false;
 		const hideOutput = this.traceState?.hideOutput ?? false;
+		const nestedUnderParent = this.traceState?.nestedUnderParent ?? false;
 		return {
 			id: this.id,
 			traceId: this.traceId,
@@ -3225,7 +3226,8 @@ var BaseSpan = class BaseSpan {
 			...this.isInternal ? { isInternal: true } : {},
 			parentSpanId: this.getParentSpanId(includeInternalSpans),
 			externalParentSpanId: this.getExportedExternalParentSpanId(includeInternalSpans),
-			...this.isRootSpan && this.tags?.length ? { tags: this.tags } : {}
+			...nestedUnderParent ? { nestedUnderParent: true } : {},
+			...this.isRootSpan && !nestedUnderParent && this.tags?.length ? { tags: this.tags } : {}
 		};
 	}
 	get externalTraceId() {
@@ -3238,7 +3240,7 @@ var BaseSpan = class BaseSpan {
 	async executeInContext(fn) {
 		const bridge = this.observabilityInstance.getBridge();
 		if (bridge?.executeInContext) {
-			const bridgeContextSpan = this.isInternal ? this.getParentSpan(false) : this;
+			const bridgeContextSpan = this.isInternal || this.isExcluded ? this.getParentSpan(false) : this;
 			return bridge.executeInContext(bridgeContextSpan?.id ?? this.id, fn);
 		}
 		return fn();
@@ -3250,7 +3252,7 @@ var BaseSpan = class BaseSpan {
 	executeInContextSync(fn) {
 		const bridge = this.observabilityInstance.getBridge();
 		if (bridge?.executeInContextSync) {
-			const bridgeContextSpan = this.isInternal ? this.getParentSpan(false) : this;
+			const bridgeContextSpan = this.isInternal || this.isExcluded ? this.getParentSpan(false) : this;
 			return bridge.executeInContextSync(bridgeContextSpan?.id ?? this.id, fn);
 		}
 		return fn();
@@ -3295,7 +3297,7 @@ var DefaultSpan = class extends BaseSpan {
 			return;
 		}
 		const bridge = observabilityInstance.getBridge();
-		if (bridge && !this.isInternal) {
+		if (bridge && !this.isInternal && !this.isExcluded) {
 			const bridgeIds = bridge.createSpan(options);
 			if (bridgeIds) {
 				this.id = bridgeIds.spanId;
@@ -4772,6 +4774,11 @@ var BaseObservabilityInstance = class extends _mastra_core_base.MastraBase {
 			tags,
 			requestContext
 		});
+		if (!options.parent && traceState?.nestedUnderParent && (!tracingOptions?.traceId || span.traceId !== tracingOptions.traceId || !tracingOptions.parentSpanId || !(span instanceof BaseSpan) || span.externalParentSpanId !== tracingOptions.parentSpanId)) {
+			const { nestedUnderParent: _ignored, ...ownTraceState } = traceState;
+			span.traceState = ownTraceState;
+			this.logger.debug("[Observability] Ignoring tracingOptions.nestUnderParent: the run did not join the requested trace under the requested parent");
+		}
 		if (rest.type === _mastra_core_observability.SpanType.MODEL_GENERATION && this.config.excludeSpanTypes?.includes(_mastra_core_observability.SpanType.MODEL_GENERATION)) {
 			const attrs = rest.attributes;
 			const model = resolveModelId(attrs?.responseModel, attrs?.model);
@@ -4807,6 +4814,7 @@ var BaseObservabilityInstance = class extends _mastra_core_base.MastraBase {
 			traceId: cached.traceId,
 			spanId: cached.id,
 			parentSpanId: cached.parentSpanId,
+			externalParentSpanId: cached.externalParentSpanId,
 			startTime: cached.startTime instanceof Date ? cached.startTime : new Date(cached.startTime),
 			input: cached.input,
 			attributes: cached.attributes,
@@ -4814,7 +4822,11 @@ var BaseObservabilityInstance = class extends _mastra_core_base.MastraBase {
 			entityType: cached.entityType,
 			entityId: cached.entityId,
 			entityName: cached.entityName,
-			tracingPolicy: cached.isInternal ? { internal: _mastra_core_observability.InternalSpans.ALL } : void 0
+			tracingPolicy: cached.isInternal ? { internal: _mastra_core_observability.InternalSpans.ALL } : void 0,
+			traceState: cached.nestedUnderParent ? {
+				requestContextKeys: [],
+				nestedUnderParent: true
+			} : void 0
 		});
 		this.wireSpanLifecycle(span);
 		return span;
@@ -5018,11 +5030,13 @@ var BaseObservabilityInstance = class extends _mastra_core_base.MastraBase {
 		const allKeys = [...configuredKeys, ...additionalKeys];
 		const hideInput = tracingOptions?.hideInput;
 		const hideOutput = tracingOptions?.hideOutput;
-		if (allKeys.length === 0 && !hideInput && !hideOutput) return;
+		const nestedUnderParent = tracingOptions?.nestUnderParent === true;
+		if (allKeys.length === 0 && !hideInput && !hideOutput && !nestedUnderParent) return;
 		return {
 			requestContextKeys: allKeys,
 			...hideInput !== void 0 && { hideInput },
-			...hideOutput !== void 0 && { hideOutput }
+			...hideOutput !== void 0 && { hideOutput },
+			...nestedUnderParent && { nestedUnderParent }
 		};
 	}
 	/**
@@ -5894,6 +5908,12 @@ var TraceData = class {
 		this.#waitingForParent.delete(args.spanId);
 	}
 	/**
+	* Get the span IDs that have events waiting on them.
+	*/
+	getWaitingForSpanIds() {
+		return [...this.#waitingForParent.keys()];
+	}
+	/**
 	* Get total count of events in all waiting queues.
 	*/
 	waitingQueueSize() {
@@ -6077,6 +6097,8 @@ var TrackingExporter = class extends BaseExporter {
 	#hardCapEnforcementInProgress = false;
 	/** Map of traceId to scheduled cleanup timeout */
 	#pendingCleanups = /* @__PURE__ */ new Map();
+	/** Waiting-queue replays started by setImmediate that haven't finished yet */
+	#activeReplays = /* @__PURE__ */ new Set();
 	/** Subclass configuration with resolved values */
 	config;
 	/** Maximum attempts to process a queued event before dropping */
@@ -6104,12 +6126,13 @@ var TrackingExporter = class extends BaseExporter {
 	*/
 	#scheduleProcessWaitingForRoot(traceId) {
 		setImmediate(() => {
-			this.#processWaitingForRoot(traceId).catch((error) => {
+			if (this.#shutdownStarted) return;
+			this.#trackReplay(this.#processWaitingForRoot(traceId).then(() => {}, (error) => {
 				this.logger.error(`${this.name}: Error processing waiting-for-root queue`, {
 					error,
 					traceId
 				});
-			});
+			}));
 		});
 	}
 	/**
@@ -6118,24 +6141,59 @@ var TrackingExporter = class extends BaseExporter {
 	*/
 	#scheduleProcessWaitingFor(traceId, spanId) {
 		setImmediate(() => {
-			this.#processWaitingFor(traceId, spanId).catch((error) => {
+			if (this.#shutdownStarted) return;
+			this.#trackReplay(this.#processWaitingFor(traceId, spanId).then(() => {}, (error) => {
 				this.logger.error(`${this.name}: Error processing waiting queue`, {
 					error,
 					traceId,
 					spanId
 				});
-			});
+			}));
 		});
 	}
 	/**
+	* Track a running replay so flush() and shutdown() can wait for it.
+	*/
+	#trackReplay(replay) {
+		this.#activeReplays.add(replay);
+		replay.finally(() => this.#activeReplays.delete(replay));
+	}
+	/**
+	* Process every queued event whose dependency has been built, without waiting for the
+	* setImmediate-scheduled replays (which never fire under fake timers). Waits for replays
+	* that are already running, then repeats until a pass makes no progress, so cascades
+	* (root -> parent -> child -> end) are fully drained.
+	*/
+	async #drainWaitingQueues() {
+		while (true) {
+			while (this.#activeReplays.size > 0) await Promise.all(this.#activeReplays);
+			let progressed = false;
+			for (const [traceId, traceData] of this.#traceMap) try {
+				if (traceData.isRootProcessed() && await this.#processWaitingForRoot(traceId) > 0) progressed = true;
+				for (const spanId of traceData.getWaitingForSpanIds()) {
+					if (!traceData.hasSpan({ spanId })) continue;
+					if (await this.#processWaitingFor(traceId, spanId) > 0) progressed = true;
+				}
+			} catch (error) {
+				this.logger.error(`${this.name}: Error draining waiting queues`, {
+					error,
+					traceId
+				});
+			}
+			if (!progressed && this.#activeReplays.size === 0) return;
+		}
+	}
+	/**
 	* Process all events waiting for root span.
+	* Takes the queue before processing, so a concurrent call can't process the same events.
+	* @returns The number of events that left the queue (processed, moved or dropped)
 	*/
 	async #processWaitingForRoot(traceId) {
-		if (this.#shutdownStarted) return;
 		const traceData = this.#traceMap.get(traceId);
-		if (!traceData) return;
+		if (!traceData) return 0;
 		const queue = traceData.getEventsWaitingForRoot();
-		if (queue.length === 0) return;
+		if (queue.length === 0) return 0;
+		traceData.clearWaitingForRoot();
 		this.logger.debug(`${this.name}: Processing ${queue.length} events waiting for root`, { traceId });
 		const toKeep = [];
 		const now = Date.now();
@@ -6171,23 +6229,25 @@ var TrackingExporter = class extends BaseExporter {
 				else toKeep.push(queuedEvent);
 			}
 		}
-		traceData.clearWaitingForRoot();
 		for (const event of toKeep) traceData.addToWaitingQueue({
 			event: event.event,
 			waitingFor: "root",
 			attempts: event.attempts,
 			queuedAt: event.queuedAt
 		});
+		return queue.length - toKeep.length;
 	}
 	/**
 	* Process events waiting for a specific parent span.
+	* Takes the queue before processing, so a concurrent call can't process the same events.
+	* @returns The number of events that left the queue (processed, moved or dropped)
 	*/
 	async #processWaitingFor(traceId, spanId) {
-		if (this.#shutdownStarted) return;
 		const traceData = this.#traceMap.get(traceId);
-		if (!traceData) return;
+		if (!traceData) return 0;
 		const queue = traceData.getEventsWaitingFor({ spanId });
-		if (queue.length === 0) return;
+		if (queue.length === 0) return 0;
+		traceData.clearWaitingFor({ spanId });
 		this.logger.debug(`${this.name}: Processing ${queue.length} events waiting for span`, {
 			traceId,
 			spanId
@@ -6217,13 +6277,13 @@ var TrackingExporter = class extends BaseExporter {
 			queuedEvent.attempts++;
 			if (!await this.#tryProcessQueuedEvent(queuedEvent, traceData)) toKeep.push(queuedEvent);
 		}
-		traceData.clearWaitingFor({ spanId });
 		for (const event of toKeep) traceData.addToWaitingQueue({
 			event: event.event,
 			waitingFor: spanId,
 			attempts: event.attempts,
 			queuedAt: event.queuedAt
 		});
+		return queue.length - toKeep.length;
 	}
 	/**
 	* Try to process a queued event.
@@ -6683,11 +6743,15 @@ var TrackingExporter = class extends BaseExporter {
 	* This is useful in serverless environments where you need to ensure spans
 	* are exported before the runtime instance is terminated.
 	*
+	* Queued events whose dependencies have been built are processed first, so
+	* a shutdown() right after flush() only aborts spans that are still open.
+	*
 	* Subclasses should override _flush() to implement vendor-specific flush logic.
 	*/
 	async flush() {
 		if (this.isDisabled) return;
 		this.logger.debug(`${this.name}: Flushing`);
+		if (!this.#shutdownStarted) await this.#drainWaitingQueues();
 		await this._flush();
 	}
 	/**
@@ -6707,6 +6771,7 @@ var TrackingExporter = class extends BaseExporter {
 	async shutdown() {
 		if (this.isDisabled) return;
 		this.#shutdownStarted = true;
+		await this.#drainWaitingQueues();
 		await this._preShutdown();
 		for (const [traceId, timeout] of this.#pendingCleanups) {
 			clearTimeout(timeout);