@mastra/observability 0.0.0-feat-mcp-embedded-docs-tools-clean-20260108083625 → 0.0.0-feat-mcp-embedded-docs-tools-clean-20260108085651

package/dist/index.js

@@ -4234,9 +4234,7 @@ var CloudExporter = class extends BaseExporter {
     super(config);
     const accessToken = config.accessToken ?? process.env.MASTRA_CLOUD_ACCESS_TOKEN;
     if (!accessToken) {
-      this.setDisabled(
-        "MASTRA_CLOUD_ACCESS_TOKEN environment variable not set.\n\u{1F680} Sign up at https://cloud.mastra.ai to see your AI traces online and obtain your access token."
-      );
+      this.setDisabled("MASTRA_CLOUD_ACCESS_TOKEN environment variable not set.");
     }
     const endpoint = config.endpoint ?? process.env.MASTRA_CLOUD_TRACES_ENDPOINT ?? "https://api.mastra.ai/ai/spans/publish";
     this.config = {
@@ -6035,11 +6033,26 @@ var BaseObservabilityInstance = class extends MastraBase {
   // ============================================================================
   /**
    * Start a new span of a specific SpanType
+   *
+   * Sampling Decision:
+   * - For root spans (no parent): Perform sampling check using the configured strategy
+   * - For child spans: Inherit the sampling decision from the parent
+   *   - If parent is a NoOpSpan (not sampled), child is also a NoOpSpan
+   *   - If parent is a valid span (sampled), child is also sampled
+   *
+   * This ensures trace-level sampling: either all spans in a trace are sampled or none are.
+   * See: https://github.com/mastra-ai/mastra/issues/11504
    */
   startSpan(options) {
     const { customSamplerOptions, requestContext, metadata, tracingOptions, ...rest } = options;
-    if (!this.shouldSample(customSamplerOptions)) {
-      return new NoOpSpan({ ...rest, metadata }, this);
+    if (options.parent) {
+      if (!options.parent.isValid) {
+        return new NoOpSpan({ ...rest, metadata }, this);
+      }
+    } else {
+      if (!this.shouldSample(customSamplerOptions)) {
+        return new NoOpSpan({ ...rest, metadata }, this);
+      }
     }
     let traceState;
     if (options.parent) {
@@ -6611,6 +6624,9 @@ var Observability = class extends MastraBase {
       }
     }
     if (config.default?.enabled) {
+      console.warn(
+        '[Mastra Observability] The "default: { enabled: true }" configuration is deprecated and will be removed in a future version. Please use explicit configs with DefaultExporter, CloudExporter, and SensitiveDataFilter instead. See https://mastra.ai/docs/observability/tracing/overview for the recommended configuration.'
+      );
       const defaultInstance = new DefaultObservabilityInstance({
         serviceName: "mastra",
         name: "default",