@mastra/observability 1.15.0-alpha.0 → 1.15.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @mastra/observability
 
+## 1.15.1-alpha.0
+
+### Patch Changes
+
+- Fixed auto-extracted metrics (duration, token usage, cost) being silently dropped when spans are filtered via `excludeSpanTypes` or `spanFilter`. Previously, excluding a span type to reduce per-span costs in platforms like Langfuse also suppressed its aggregate metrics. Metrics are now emitted independently of span export filtering. ([#18253](https://github.com/mastra-ai/mastra/pull/18253))
+
+- Updated dependencies [[`65f255a`](https://github.com/mastra-ai/mastra/commit/65f255a38667beb6ceeadabfa9eb5059bfec8298), [`4a88c6e`](https://github.com/mastra-ai/mastra/commit/4a88c6e2bdce316f8d7551b4ec3449b0b06fc71c), [`87a17ef`](https://github.com/mastra-ai/mastra/commit/87a17efbd725aca6639febdc5e69e2abb3048689), [`e11ff30`](https://github.com/mastra-ai/mastra/commit/e11ff301408bf1731dca2fb7fbfcd8c819500a35), [`9d2c946`](https://github.com/mastra-ai/mastra/commit/9d2c946d0859e90ae4bcec5beeb1da7398d2ad1e), [`f1ec385`](https://github.com/mastra-ai/mastra/commit/f1ec385386f62b1a0847ec5353ae2bb169d1c3d9), [`e14986f`](https://github.com/mastra-ai/mastra/commit/e14986f6e5478d6384d04ff9a7f9a79a46a8b529), [`0be490f`](https://github.com/mastra-ai/mastra/commit/0be490fabb538c5a7de796ea0aff7d04a0bea1f3), [`0be490f`](https://github.com/mastra-ai/mastra/commit/0be490fabb538c5a7de796ea0aff7d04a0bea1f3), [`974f614`](https://github.com/mastra-ai/mastra/commit/974f614e083bd68278536f94453f7b320b86a3c7), [`31be1cf`](https://github.com/mastra-ai/mastra/commit/31be1cf5f2a7b5eef12f6123a40653b4d8115c16)]:
+  - @mastra/core@1.46.0-alpha.3
+
+## 1.15.0
+
+### Minor Changes
+
+- Random bump ([#18178](https://github.com/mastra-ai/mastra/pull/18178))
+
+### Patch Changes
+
+- Updated dependencies [[`7c0d868`](https://github.com/mastra-ai/mastra/commit/7c0d868d97d0fdbc04c14d0166dbf44d4c5a4a62), [`d9d2273`](https://github.com/mastra-ai/mastra/commit/d9d2273c702690c9a26eab2aebea879701d4355a), [`b04369d`](https://github.com/mastra-ai/mastra/commit/b04369d6b167c698ef103981171a8bf92808e756), [`8f3c262`](https://github.com/mastra-ai/mastra/commit/8f3c262587b335588a02d96b17fd6aca34c885b3)]:
+  - @mastra/core@1.45.0
+
 ## 1.15.0-alpha.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -2925,6 +2925,12 @@ var BaseObservabilityInstance = class extends base.MastraBase {
    * a span's `metadata.environment` isn't set.
    */
   #mastraEnvironment;
+  /**
+   * For excluded MODEL_GENERATION spans whose constructor clears `attributes`,
+   * we stash the lightweight provider/model from creation options so
+   * `captureExcludedModelUsage` can still build cost context.
+   */
+  #excludedModelMeta = /* @__PURE__ */ new WeakMap();
   constructor(config) {
     super({ component: logger.RegisteredLogger.OBSERVABILITY, name: config.serviceName });
     this.config = {
@@ -3030,6 +3036,13 @@ var BaseObservabilityInstance = class extends base.MastraBase {
       tags,
       requestContext
     });
+    if (rest.type === observability.SpanType.MODEL_GENERATION && this.config.excludeSpanTypes?.includes(observability.SpanType.MODEL_GENERATION)) {
+      const attrs = rest.attributes;
+      const model = attrs?.responseModel ?? attrs?.model;
+      if (attrs?.provider || model) {
+        this.#excludedModelMeta.set(span, { provider: attrs?.provider, model });
+      }
+    }
     if (span.isEvent) {
       this.emitSpanEnded(span);
     } else {
@@ -3226,11 +3239,12 @@ var BaseObservabilityInstance = class extends base.MastraBase {
         return;
       }
       const rollupTarget = this.captureModelUsageRollup(span, options);
+      const excludedModelUsage = this.captureExcludedModelUsage(span, options);
       originalEnd(options);
       if (rollupTarget) {
         this.applyUsageRollup(rollupTarget);
       }
-      this.emitSpanEnded(span);
+      this.emitSpanEnded(span, excludedModelUsage);
     };
     span.update = (options) => {
       if (span.isEvent) {
@@ -3364,6 +3378,22 @@ var BaseObservabilityInstance = class extends base.MastraBase {
     }
     return exportedSpan;
   }
+  /** Export an already-processed span, returning undefined if filtered out. */
+  getProcessedSpanForExport(span) {
+    if (!span.isValid) return void 0;
+    if (span.isInternal && !this.config.includeInternalSpans) return void 0;
+    if (this.config.excludeSpanTypes?.includes(span.type)) return void 0;
+    const exportedSpan = span.exportSpan(this.config.includeInternalSpans);
+    if (!exportedSpan) return void 0;
+    if (this.config.spanFilter) {
+      try {
+        if (!this.config.spanFilter(exportedSpan)) return void 0;
+      } catch (error) {
+        this.logger.error(`[Observability] spanFilter error`, error);
+      }
+    }
+    return exportedSpan;
+  }
   /**
    * Emit a span started event.
    * Routes through the ObservabilityBus so exporters receive it via onTracingEvent.
@@ -3380,14 +3410,31 @@ var BaseObservabilityInstance = class extends base.MastraBase {
    * Emits any auto-extracted metrics while the live span tree is still available,
    * then routes the exported tracing event through the ObservabilityBus.
    */
-  emitSpanEnded(span) {
-    const exportedSpan = this.getSpanForExport(span);
-    if (exportedSpan) {
+  emitSpanEnded(span, excludedModelUsage) {
+    let processedSpan;
+    let spanWasProcessed = false;
+    if (span.isValid && !(span.isInternal && !this.config.includeInternalSpans)) {
+      processedSpan = this.processSpan(span);
+      spanWasProcessed = true;
       try {
-        emitAutoExtractedMetrics(span, this.getMetricsContext(span));
+        if (processedSpan) {
+          emitAutoExtractedMetrics(processedSpan, this.getMetricsContext(processedSpan));
+          const processedAttrs = processedSpan.attributes;
+          if (excludedModelUsage && !processedAttrs?.usage) {
+            emitTokenMetricsForUsage(
+              excludedModelUsage.usage,
+              excludedModelUsage.provider,
+              excludedModelUsage.model,
+              this.getMetricsContext(processedSpan)
+            );
+          }
+        }
       } catch (err) {
         this.logger.error("[Observability] Auto-extraction error:", err);
       }
+    }
+    const exportedSpan = spanWasProcessed ? processedSpan ? this.getProcessedSpanForExport(processedSpan) : void 0 : this.getSpanForExport(span);
+    if (exportedSpan) {
       const event = { type: observability.TracingEventType.SPAN_ENDED, exportedSpan };
       this.emitTracingEvent(event);
     }
@@ -3423,6 +3470,26 @@ var BaseObservabilityInstance = class extends base.MastraBase {
     const model = endAttrs?.responseModel ?? endAttrs?.model ?? liveAttrs?.responseModel ?? liveAttrs?.model;
     return { ancestor, usage, provider, model };
   }
+  /**
+   * When a non-internal MODEL_GENERATION span is excluded by `excludeSpanTypes`,
+   * the BaseSpan constructor clears start-time attributes and DefaultSpan.end()
+   * drops end-time attributes before auto-extraction can read them. Capture
+   * usage from end options and provider/model from the creation-time stash so
+   * token and cost metrics still emit even though the trace span is filtered out.
+   */
+  captureExcludedModelUsage(span, endOptions) {
+    if (span.type !== observability.SpanType.MODEL_GENERATION) return void 0;
+    if (span.isInternal) return void 0;
+    if (!this.config.excludeSpanTypes?.includes(observability.SpanType.MODEL_GENERATION)) return void 0;
+    const endAttrs = endOptions?.attributes ?? void 0;
+    const liveAttrs = span.attributes;
+    const usage = endAttrs?.usage ?? liveAttrs?.usage;
+    if (!usage) return void 0;
+    const stashed = this.#excludedModelMeta.get(span);
+    const provider = endAttrs?.provider ?? liveAttrs?.provider ?? stashed?.provider;
+    const model = endAttrs?.responseModel ?? endAttrs?.model ?? liveAttrs?.responseModel ?? liveAttrs?.model ?? stashed?.model;
+    return { usage, provider, model };
+  }
   /**
    * Accumulate usage onto the ancestor's `internalUsage` attribute (for trace
    * UI visibility) and emit auto-extracted token metrics now, using the