@mastra/mcp-docs-server 0.13.39 → 1.0.0-beta.0

package/.docs/raw/observability/{ai-tracing → tracing}/exporters/arize.mdx

@@ -1,21 +1,11 @@
 ---
-title: "Arize Exporter | AI Tracing | Observability | Mastra Docs"
-description: "Send AI traces to Arize Phoenix or Arize AX using OpenTelemetry and OpenInference"
+title: "Arize Exporter | Tracing | Observability | Mastra Docs"
+description: "Send traces to Arize Phoenix or Arize AX using OpenTelemetry and OpenInference"
 ---
 
 # Arize Exporter
 
-[Arize](https://arize.com/) provides observability platforms for AI applications through [Phoenix](https://phoenix.arize.com/) (open-source) and [Arize AX](https://arize.com/generative-ai/) (enterprise). The Arize exporter sends AI traces using OpenTelemetry and [OpenInference](https://github.com/Arize-ai/openinference/tree/main/spec) semantic conventions, compatible with any OpenTelemetry platform that supports OpenInference.
-
-## When to Use Arize
-
-Arize is ideal when you need:
-
-- **OpenInference standards** - Industry-standard semantic conventions for AI traces
-- **Flexible deployment** - Self-hosted Phoenix or managed Arize AX
-- **OpenTelemetry compatibility** - Works with any OTLP-compatible platform
-- **Comprehensive AI observability** - LLM traces, embeddings, and retrieval analytics
-- **Open-source option** - Full-featured local deployment with Phoenix
+[Arize](https://arize.com/) provides observability platforms for AI applications through [Phoenix](https://phoenix.arize.com/) (open-source) and [Arize AX](https://arize.com/generative-ai/) (enterprise). The Arize exporter sends traces using OpenTelemetry and [OpenInference](https://github.com/Arize-ai/openinference/tree/main/spec) semantic conventions, compatible with any OpenTelemetry platform that supports OpenInference.
 
 ## Installation
 
@@ -46,10 +36,11 @@ PHOENIX_PROJECT_NAME=mastra-service  # Optional, defaults to 'mastra-service'
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { ArizeExporter } from "@mastra/arize";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       arize: {
         serviceName: process.env.PHOENIX_PROJECT_NAME || "mastra-service",
@@ -62,7 +53,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -103,10 +94,11 @@ ARIZE_PROJECT_NAME=mastra-service  # Optional
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { ArizeExporter } from "@mastra/arize";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       arize: {
         serviceName: process.env.ARIZE_PROJECT_NAME || "mastra-service",
@@ -119,7 +111,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -196,7 +188,7 @@ This exporter implements the [OpenInference Semantic Conventions](https://github
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [Tracing Overview]/docs/v1/observability/tracing/overview)
 - [Phoenix Documentation](https://docs.arize.com/phoenix)
 - [Arize AX Documentation](https://docs.arize.com/)
 - [OpenInference Specification](https://github.com/Arize-ai/openinference/tree/main/spec)

package/.docs/raw/observability/{ai-tracing → tracing}/exporters/braintrust.mdx

@@ -1,21 +1,11 @@
 ---
-title: "Braintrust Exporter | AI Tracing | Observability | Mastra Docs"
-description: "Send AI traces to Braintrust for evaluation and monitoring"
+title: "Braintrust Exporter | Tracing | Observability | Mastra Docs"
+description: "Send traces to Braintrust for evaluation and monitoring"
 ---
 
 # Braintrust Exporter
 
-[Braintrust](https://www.braintrust.dev/) is an evaluation and monitoring platform that helps you measure and improve LLM application quality. The Braintrust exporter sends your AI traces to Braintrust, enabling systematic evaluation, scoring, and experimentation.
-
-## When to Use Braintrust
-
-Braintrust excels at:
-
-- **Evaluation workflows** - Systematic quality measurement
-- **Experiment tracking** - Compare model versions and prompts
-- **Dataset management** - Curate test cases and golden datasets
-- **Regression testing** - Ensure improvements don't break existing functionality
-- **Team collaboration** - Share experiments and insights
+[Braintrust](https://www.braintrust.dev/) is an evaluation and monitoring platform that helps you measure and improve LLM application quality. The Braintrust exporter sends your traces to Braintrust, enabling systematic evaluation, scoring, and experimentation.
 
 ## Installation
 
@@ -41,10 +31,11 @@ BRAINTRUST_PROJECT_NAME=my-project  # Optional, defaults to 'mastra-tracing'
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { BraintrustExporter } from "@mastra/braintrust";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       braintrust: {
         serviceName: "my-service",
@@ -56,7 +47,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -76,5 +67,5 @@ new BraintrustExporter({
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [Tracing Overview]/docs/v1/observability/tracing/overview)
 - [Braintrust Documentation](https://www.braintrust.dev/docs)

package/.docs/raw/observability/{ai-tracing → tracing}/exporters/cloud.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Cloud Exporter | AI Tracing | Observability | Mastra Docs"
+title: "Cloud Exporter | Tracing | Observability | Mastra Docs"
 description: "Send traces to Mastra Cloud for production monitoring"
 ---
 
@@ -7,15 +7,6 @@ description: "Send traces to Mastra Cloud for production monitoring"
 
 The `CloudExporter` sends traces to Mastra Cloud for centralized monitoring and team collaboration. It's automatically enabled when using the default observability configuration with a valid access token.
 
-## When to Use CloudExporter
-
-CloudExporter is ideal for:
-
-- **Production monitoring** - Centralized trace visualization
-- **Team collaboration** - Share traces across your organization
-- **Advanced analytics** - Insights and performance metrics
-- **Zero maintenance** - No infrastructure to manage
-
 ## Configuration
 
 ### Prerequisites
@@ -32,10 +23,10 @@ MASTRA_CLOUD_ACCESS_TOKEN=mst_xxxxxxxxxxxxxxxx
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
-import { CloudExporter } from "@mastra/core/ai-tracing";
+import { Observability, CloudExporter } from "@mastra/observability";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       production: {
         serviceName: "my-service",
@@ -44,7 +35,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -53,10 +44,13 @@ export const mastra = new Mastra({
 When using the default observability configuration, CloudExporter is automatically included if the access token is set:
 
 ```typescript
+import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
+
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     default: { enabled: true }, // Automatically includes CloudExporter if token exists
-  },
+  }),
 });
 ```
 
@@ -116,6 +110,6 @@ CloudExporter uses intelligent batching to optimize network usage. Traces are bu
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
-- [DefaultExporter](/docs/observability/ai-tracing/exporters/default)
+- [Tracing Overview]/docs/v1/observability/tracing/overview)
+- [DefaultExporter]/docs/v1/observability/tracing/exporters/default)
 - [Mastra Cloud Documentation](https://cloud.mastra.ai/docs)

package/.docs/raw/observability/{ai-tracing → tracing}/exporters/default.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Default Exporter | AI Tracing | Observability | Mastra Docs"
+title: "Default Exporter | Tracing | Observability | Mastra Docs"
 description: "Store traces locally for development and debugging"
 ---
 
@@ -7,15 +7,6 @@ description: "Store traces locally for development and debugging"
 
 The `DefaultExporter` persists traces to your configured storage backend, making them accessible through Studio. It's automatically enabled when using the default observability configuration and requires no external services.
 
-## When to Use DefaultExporter
-
-DefaultExporter is ideal for:
-
-- **Local development** - Debug and analyze traces offline
-- **Data ownership** - Complete control over your trace data
-- **Zero dependencies** - No external services required
-- **Studio integration** - View traces in Studio
-
 ## Configuration
 
 ### Prerequisites
@@ -27,21 +18,22 @@ DefaultExporter is ideal for:
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
-import { DefaultExporter } from "@mastra/core/ai-tracing";
+import { Observability, DefaultExporter } from "@mastra/observability";
 import { LibSQLStore } from "@mastra/libsql";
 
 export const mastra = new Mastra({
   storage: new LibSQLStore({
+    id: 'mastra-storage',
     url: "file:./mastra.db", // Required for trace persistence
   }),
-  observability: {
+  observability: new Observability({
     configs: {
       local: {
         serviceName: "my-service",
         exporters: [new DefaultExporter()],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -50,13 +42,17 @@ export const mastra = new Mastra({
 When using the default observability configuration, DefaultExporter is automatically included:
 
 ```typescript
+import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
+import { LibSQLStore } from "@mastra/libsql";
 export const mastra = new Mastra({
   storage: new LibSQLStore({
+    id: 'mastra-storage',
     url: "file:./mastra.db",
   }),
-  observability: {
+  observability: new Observability({
     default: { enabled: true }, // Automatically includes DefaultExporter
-  },
+  }),
 });
 ```
 
@@ -106,8 +102,8 @@ If you set the strategy to `'auto'`, the `DefaultExporter` automatically selects
 
 | Storage Provider                                | Preferred Strategy | Supported Strategies                      | Notes                                 |
 | ----------------------------------------------- | ------------------ | ----------------------------------------- | ------------------------------------- |
-| **[LibSQL](/reference/storage/libsql)**         | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
-| **[PostgreSQL](/reference/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only           | Recommended for production            |
+| **[LibSQL]/reference/v1/storage/libsql)**         | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
+| **[PostgreSQL]/reference/v1/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only           | Recommended for production            |
 
 ### Strategy Benefits
 
@@ -162,6 +158,6 @@ new DefaultExporter({
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
-- [CloudExporter](/docs/observability/ai-tracing/exporters/cloud)
-- [Storage Configuration](/docs/server-db/storage)
+- [Tracing Overview]/docs/v1/observability/tracing/overview)
+- [CloudExporter]/docs/v1/observability/tracing/exporters/cloud)
+- [Storage Configuration]/docs/v1/server-db/storage)

package/.docs/raw/observability/{ai-tracing → tracing}/exporters/langfuse.mdx

@@ -1,21 +1,11 @@
 ---
-title: "Langfuse Exporter | AI Tracing | Observability | Mastra Docs"
-description: "Send AI traces to Langfuse for LLM observability and analytics"
+title: "Langfuse Exporter | Tracing | Observability | Mastra Docs"
+description: "Send traces to Langfuse for LLM observability and analytics"
 ---
 
 # Langfuse Exporter
 
-[Langfuse](https://langfuse.com/) is an open-source observability platform specifically designed for LLM applications. The Langfuse exporter sends your AI traces to Langfuse, providing detailed insights into model performance, token usage, and conversation flows.
-
-## When to Use Langfuse
-
-Langfuse is ideal when you need:
-
-- **LLM-specific analytics** - Token usage, costs, latency breakdown
-- **Conversation tracking** - Session-based trace grouping
-- **Quality scoring** - Manual and automated evaluation scores
-- **Model comparison** - A/B testing and version comparisons
-- **Self-hosted option** - Deploy on your own infrastructure
+[Langfuse](https://langfuse.com/) is an open-source observability platform specifically designed for LLM applications. The Langfuse exporter sends your traces to Langfuse, providing detailed insights into model performance, token usage, and conversation flows.
 
 ## Installation
 
@@ -41,10 +31,11 @@ LANGFUSE_BASE_URL=https://cloud.langfuse.com  # Or your self-hosted URL
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { LangfuseExporter } from "@mastra/langfuse";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       langfuse: {
         serviceName: "my-service",
@@ -60,7 +51,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -118,5 +109,5 @@ new LangfuseExporter({
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [Tracing Overview]/docs/v1/observability/tracing/overview)
 - [Langfuse Documentation](https://langfuse.com/docs)

package/.docs/raw/observability/{ai-tracing → tracing}/exporters/langsmith.mdx

@@ -1,21 +1,11 @@
 ---
-title: "LangSmith Exporter | AI Tracing | Observability | Mastra Docs"
-description: "Send AI traces to LangSmith for LLM observability and evaluation"
+title: "LangSmith Exporter | Tracing | Observability | Mastra Docs"
+description: "Send traces to LangSmith for LLM observability and evaluation"
 ---
 
 # LangSmith Exporter
 
-[LangSmith](https://smith.langchain.com/) is LangChain's platform for monitoring and evaluating LLM applications. The LangSmith exporter sends your AI traces to LangSmith, providing insights into model performance, debugging capabilities, and evaluation workflows.
-
-## When to Use LangSmith
-
-LangSmith is ideal when you need:
-
-- **LangChain ecosystem integration** - Native support for LangChain applications
-- **Debugging and testing** - Detailed trace visualization and replay
-- **Evaluation pipelines** - Built-in evaluation and dataset management
-- **Prompt versioning** - Track and compare prompt variations
-- **Collaboration features** - Team workspaces and shared projects
+[LangSmith](https://smith.langchain.com/) is LangChain's platform for monitoring and evaluating LLM applications. The LangSmith exporter sends your traces to LangSmith, providing insights into model performance, debugging capabilities, and evaluation workflows.
 
 ## Installation
 
@@ -40,10 +30,11 @@ LANGSMITH_BASE_URL=https://api.smith.langchain.com  # Optional for self-hosted
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { LangSmithExporter } from "@mastra/langsmith";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       langsmith: {
         serviceName: "my-service",
@@ -54,7 +45,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -84,5 +75,5 @@ new LangSmithExporter({
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [Tracing Overview]/docs/v1/observability/tracing/overview)
 - [LangSmith Documentation](https://docs.smith.langchain.com/)

package/.docs/raw/observability/{ai-tracing → tracing}/exporters/otel.mdx

@@ -1,6 +1,6 @@
 ---
-title: "OpenTelemetry Exporter | AI Tracing | Observability | Mastra Docs"
-description: "Send AI traces to any OpenTelemetry-compatible observability platform"
+title: "OpenTelemetry Exporter | Tracing | Observability | Mastra Docs"
+description: "Send traces to any OpenTelemetry-compatible observability platform"
 ---
 
 # OpenTelemetry Exporter
@@ -11,17 +11,7 @@ The OpenTelemetry exporter is currently **experimental**. APIs and configuration
 
 :::
 
-The OpenTelemetry (OTEL) exporter sends your AI traces to any OTEL-compatible observability platform using standardized [OpenTelemetry Semantic Conventions for GenAI](https://opentelemetry.io/docs/specs/semconv/gen-ai/). This ensures broad compatibility with platforms like Datadog, New Relic, SigNoz, Dash0, Traceloop, Laminar, and more.
-
-## When to Use OTEL Exporter
-
-The OTEL exporter is ideal when you need:
-
-- **Platform flexibility** - Send traces to any OTEL-compatible backend
-- **Standards compliance** - Follow OpenTelemetry GenAI semantic conventions
-- **Multi-vendor support** - Configure once, switch providers easily
-- **Enterprise platforms** - Integrate with existing observability infrastructure
-- **Custom collectors** - Send to your own OTEL collector
+The OpenTelemetry (OTEL) exporter sends your traces to any OTEL-compatible observability platform using standardized [OpenTelemetry Semantic Conventions for GenAI](https://opentelemetry.io/docs/specs/semconv/gen-ai/). This ensures broad compatibility with platforms like Datadog, New Relic, SigNoz, Dash0, Traceloop, Laminar, and more.
 
 ## Installation
 
@@ -53,10 +43,11 @@ npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-http
 
 ```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
+import { Observability } from "@mastra/observability";
 import { OtelExporter } from "@mastra/otel-exporter";
 
 export const mastra = new Mastra({
-  observability: {
+  observability: new Observability({
     configs: {
       otel: {
         serviceName: "my-service",
@@ -77,7 +68,7 @@ export const mastra = new Mastra({
         ],
       },
     },
-  },
+  }),
 });
 ```
 
@@ -89,7 +80,7 @@ Get your Dash0 endpoint from your dashboard. It should be in the format `ingress
 
 ### SigNoz
 
-[SigNoz](https://signoz.io/) is an open-source APM alternative with built-in AI tracing support.
+[SigNoz](https://signoz.io/) is an open-source APM alternative with built-in Tracing support.
 
 ```typescript title="src/mastra/index.ts"
 new OtelExporter({
@@ -258,6 +249,6 @@ Install the suggested package for your provider.
 
 ## Related
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [Tracing Overview]/docs/v1/observability/tracing/overview)
 - [OpenTelemetry GenAI Conventions](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
-- [OTEL Exporter Reference](/reference/observability/ai-tracing/exporters/otel)
+- [OTEL Exporter Reference]/reference/v1/observability/tracing/exporters/otel)