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

package/.docs/raw/reference/observability/tracing/configuration.mdx

@@ -0,0 +1,245 @@
+---
+title: "Reference: Configuration | Observability | Mastra Docs"
+description: Tracing configuration types and registry functions
+---
+
+import PropertiesTable from "@site/src/components/PropertiesTable";
+
+# Configuration
+
+## ObservabilityRegistryConfig
+
+```typescript
+interface ObservabilityRegistryConfig {
+  default?: { enabled?: boolean };
+  configs?: Record<string, Omit<ObservabilityInstanceConfig, "name"> | ObservabilityInstance>;
+  configSelector?: ConfigSelector;
+}
+```
+
+<PropertiesTable
+  props={[
+    {
+      name: "default",
+      type: "{ enabled?: boolean }",
+      description: "Enable default configuration with DefaultExporter and CloudExporter",
+      required: false,
+    },
+    {
+      name: "configs",
+      type: "Record<string, Omit<ObservabilityInstanceConfig, 'name'> | ObservabilityInstance>",
+      description: "Named observability instance configurations or pre-instantiated instances",
+      required: false,
+    },
+    {
+      name: "configSelector",
+      type: "ConfigSelector",
+      description: "Runtime configuration selector function",
+      required: false,
+    },
+  ]}
+/>
+
+## ObservabilityInstanceConfig
+
+```typescript
+interface ObservabilityInstanceConfig {
+  name: string;
+  serviceName: string;
+  sampling?: SamplingStrategy;
+  exporters?: ObservabilityExporter[];
+  spanOutputProcessors?: SpanOutputProcessor[];
+  includeInternalSpans?: boolean;
+  requestContextKeys?: string[];
+}
+```
+
+<PropertiesTable
+  props={[
+    {
+      name: "name",
+      type: "string",
+      description: "Configuration identifier",
+      required: true,
+    },
+    {
+      name: "serviceName",
+      type: "string",
+      description: "Service name in traces",
+      required: true,
+    },
+    {
+      name: "sampling",
+      type: "SamplingStrategy",
+      description: "Sampling configuration (defaults to ALWAYS)",
+      required: false,
+    },
+    {
+      name: "exporters",
+      type: "ObservabilityExporter[]",
+      description: "Trace data exporters",
+      required: false,
+    },
+    {
+      name: "spanOutputProcessors",
+      type: "SpanOutputProcessor[]",
+      description: "Span output processors",
+      required: false,
+    },
+    {
+      name: "includeInternalSpans",
+      type: "boolean",
+      description: "Include spans internal to Mastra operations",
+      required: false,
+    },
+    {
+      name: "requestContextKeys",
+      type: "string[]",
+      description: "RequestContext keys to extract as metadata (supports dot notation)",
+      required: false,
+    },
+  ]}
+/>
+
+## SamplingStrategy
+
+```typescript
+type SamplingStrategy =
+  | { type: "always" }
+  | { type: "never" }
+  | { type: "ratio"; probability: number }
+  | { type: "custom"; sampler: (options?: TracingOptions) => boolean };
+```
+
+## ConfigSelector
+
+```typescript
+type ConfigSelector = (
+  options: ConfigSelectorOptions,
+  availableConfigs: ReadonlyMap<string, ObservabilityInstance>,
+) => string | undefined;
+```
+
+## ConfigSelectorOptions
+
+```typescript
+interface ConfigSelectorOptions {
+  requestContext?: RequestContext;
+}
+```
+
+# Registry Methods
+
+The Observability class provides methods for managing observability instances:
+
+## registerInstance
+
+```typescript
+registerInstance(
+  name: string,
+  instance: ObservabilityInstance,
+  isDefault?: boolean
+): void;
+```
+
+Registers an observability instance in the registry.
+
+## getInstance
+
+```typescript
+getInstance(name: string): ObservabilityInstance | undefined;
+```
+
+Retrieves an observability instance by name.
+
+## getDefaultInstance
+
+```typescript
+getDefaultInstance(): ObservabilityInstance | undefined;
+```
+
+Returns the default observability instance.
+
+## getSelectedInstance
+
+```typescript
+getSelectedInstance(
+  options: ConfigSelectorOptions
+): ObservabilityInstance | undefined;
+```
+
+Returns the observability instance selected by the config selector or default.
+
+## listInstances
+
+```typescript
+listInstances(): ReadonlyMap<string, ObservabilityInstance>;
+```
+
+Returns all registered observability instances.
+
+## hasInstance
+
+```typescript
+hasInstance(name: string): boolean;
+```
+
+Checks if an observability instance exists.
+
+## setConfigSelector
+
+```typescript
+setConfigSelector(selector: ConfigSelector): void;
+```
+
+Sets the config selector function.
+
+## unregisterInstance
+
+```typescript
+unregisterInstance(name: string): boolean;
+```
+
+Removes an observability instance from the registry.
+
+## clear
+
+```typescript
+clear(): void;
+```
+
+Clears all instances without shutdown.
+
+## shutdown
+
+```typescript
+async shutdown(): Promise<void>;
+```
+
+Shuts down all observability instances and clears the registry.
+
+## See Also
+
+### Documentation
+
+- [Tracing Overview](/docs/v1/observability/tracing/overview) - Concepts and usage guide
+- [Sampling Strategies](/docs/v1/observability/tracing/overview#sampling-strategies) - Sampling configuration details
+- [Multi-Config Setup](/docs/v1/observability/tracing/overview#multi-config-setup) - Using multiple configurations
+
+### Reference
+
+- [Tracing Classes](/reference/v1/observability/tracing/instances) - Core tracing classes
+- [Interfaces](/reference/v1/observability/tracing/interfaces) - Type definitions
+- [Spans Reference](/reference/v1/observability/tracing/spans) - Span lifecycle
+
+### Examples
+
+- [Basic Tracing](/examples/v1/observability/basic-tracing) - Getting started
+
+### Exporters
+
+- [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage configuration
+- [CloudExporter](/reference/v1/observability/tracing/exporters/cloud-exporter) - Cloud setup
+- [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
+- [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
+- [LangSmith](/reference/v1/observability/tracing/exporters/langsmith) - LangSmith integration

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

@@ -1,13 +1,13 @@
 ---
 title: "Reference: ArizeExporter | Observability | Mastra Docs"
-description: Arize exporter for AI tracing using OpenInference
+description: Arize exporter for Tracing using OpenInference
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # ArizeExporter
 
-Sends AI tracing data to Arize Phoenix, Arize AX, or any OpenTelemetry-compatible observability platform that supports OpenInference semantic conventions.
+Sends Tracing data to Arize Phoenix, Arize AX, or any OpenTelemetry-compatible observability platform that supports OpenInference semantic conventions.
 
 ## Constructor
 
@@ -18,7 +18,7 @@ new ArizeExporter(config: ArizeExporterConfig)
 ## ArizeExporterConfig
 
 ```typescript
-interface ArizeExporterConfig {
+type ArizeExporterConfig = Omit<OtelExporterConfig, 'provider'> & {
   // Phoenix / OpenTelemetry configuration
   endpoint?: string;
   apiKey?: string;
@@ -29,15 +29,15 @@ interface ArizeExporterConfig {
   // Common configuration
   projectName?: string;
   headers?: Record<string, string>;
-
-  // Inherited from OtelExporterConfig
-  timeout?: number;
-  batchSize?: number;
-  logLevel?: "debug" | "info" | "warn" | "error";
-  resourceAttributes?: Record<string, any>;
 }
 ```
 
+Inherits from `OtelExporterConfig` (excluding `provider`), which includes:
+- `timeout?: number` - Export timeout in milliseconds (default: 30000)
+- `batchSize?: number` - Number of spans per batch (default: 512)
+- `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'` - Log level (default: WARN)
+- `resourceAttributes?: Record<string, any>` - Custom resource attributes
+
 <PropertiesTable
   props={[
     {
@@ -103,10 +103,10 @@ interface ArizeExporterConfig {
 
 ## Methods
 
-### exportEvent
+### exportTracingEvent
 
 ```typescript
-async exportEvent(event: AITracingEvent): Promise<void>
+async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
 Exports a tracing event to the configured endpoint.
@@ -114,7 +114,7 @@ Exports a tracing event to the configured endpoint.
 ### export
 
 ```typescript
-async export(spans: ReadOnlyAISpan[]): Promise<void>
+async export(spans: ReadOnlySpan[]): Promise<void>
 ```
 
 Batch exports spans using OpenTelemetry with OpenInference semantic conventions.
@@ -159,6 +159,6 @@ The ArizeExporter implements [OpenInference Semantic Conventions](https://github
 
 ## Related
 
-- [ArizeExporter Documentation](/docs/observability/ai-tracing/exporters/arize)
+- [ArizeExporter Documentation](/docs/v1/observability/tracing/exporters/arize)
 - [Phoenix Documentation](https://docs.arize.com/phoenix)
 - [Arize AX Documentation](https://docs.arize.com/)

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

@@ -1,13 +1,13 @@
 ---
 title: "Reference: BraintrustExporter | Observability | Mastra Docs"
-description: Braintrust exporter for AI tracing
+description: Braintrust exporter for Tracing
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # BraintrustExporter
 
-Sends AI tracing data to Braintrust for eval and observability.
+Sends Tracing data to Braintrust for eval and observability.
 
 ## Constructor
 
@@ -18,15 +18,18 @@ new BraintrustExporter(config: BraintrustExporterConfig)
 ## BraintrustExporterConfig
 
 ```typescript
-interface BraintrustExporterConfig {
+interface BraintrustExporterConfig extends BaseExporterConfig {
   apiKey?: string;
   endpoint?: string;
   projectName?: string;
-  logLevel?: "debug" | "info" | "warn" | "error";
   tuningParameters?: Record<string, any>;
 }
 ```
 
+Extends `BaseExporterConfig`, which includes:
+- `logger?: IMastraLogger` - Logger instance
+- `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'` - Log level (default: INFO)
+
 <PropertiesTable
   props={[
     {
@@ -64,10 +67,10 @@ interface BraintrustExporterConfig {
 
 ## Methods
 
-### exportEvent
+### exportTracingEvent
 
 ```typescript
-async exportEvent(event: AITracingEvent): Promise<void>
+async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
 Exports a tracing event to Braintrust.
@@ -75,7 +78,7 @@ Exports a tracing event to Braintrust.
 ### export
 
 ```typescript
-async export(spans: ReadOnlyAISpan[]): Promise<void>
+async export(spans: ReadOnlySpan[]): Promise<void>
 ```
 
 Batch exports spans to Braintrust.
@@ -101,7 +104,7 @@ const exporter = new BraintrustExporter({
 
 ## Span Type Mapping
 
-| AI Span Type                | Braintrust Type |
+| Span Type                | Braintrust Type |
 | --------------------------- | --------------- |
 | `MODEL_GENERATION`          | `llm`           |
 | `MODEL_CHUNK`               | `llm`           |

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

@@ -29,7 +29,7 @@ new CloudExporter(config?: CloudExporterConfig)
 ## CloudExporterConfig
 
 ```typescript
-interface CloudExporterConfig {
+interface CloudExporterConfig extends BaseExporterConfig {
   /** Maximum number of spans per batch. Default: 1000 */
   maxBatchSize?: number;
 
@@ -42,33 +42,34 @@ interface CloudExporterConfig {
   /** Cloud access token (from env or config) */
   accessToken?: string;
 
-  /** Cloud AI tracing endpoint */
+  /** Cloud observability endpoint */
   endpoint?: string;
-
-  /** Optional logger */
-  logger?: IMastraLogger;
 }
 ```
 
+Extends `BaseExporterConfig`, which includes:
+- `logger?: IMastraLogger` - Logger instance
+- `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'` - Log level (default: INFO)
+
 ## Environment Variables
 
 The exporter reads these environment variables if not provided in config:
 
 - `MASTRA_CLOUD_ACCESS_TOKEN` - Access token for authentication
-- `MASTRA_CLOUD_AI_TRACES_ENDPOINT` - Custom endpoint (defaults to `https://api.mastra.ai/ai/spans/publish`)
+- `MASTRA_CLOUD_TRACES_ENDPOINT` - Custom endpoint (defaults to `https://api.mastra.ai/ai/spans/publish`)
 
 ## Properties
 
 ```typescript
-readonly name = 'mastra-cloud-ai-tracing-exporter';
+readonly name = 'mastra-cloud-observability-exporter';
 ```
 
 ## Methods
 
-### exportEvent
+### exportTracingEvent
 
 ```typescript
-async exportEvent(event: AITracingEvent): Promise<void>
+async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
 Processes tracing events. Only exports SPAN_ENDED events to Cloud.
@@ -77,7 +78,7 @@ Processes tracing events. Only exports SPAN_ENDED events to Cloud.
   props={[
     {
       name: "event",
-      type: "AITracingEvent",
+      type: "TracingEvent",
       description: "The tracing event to export",
       required: true,
     },
@@ -148,7 +149,7 @@ interface MastraCloudSpanRecord {
 ## Usage
 
 ```typescript
-import { CloudExporter } from "@mastra/core/ai-tracing";
+import { CloudExporter } from "@mastra/observability";
 
 // Uses environment variable for token
 const exporter = new CloudExporter();
@@ -158,6 +159,7 @@ const customExporter = new CloudExporter({
   accessToken: "your-token",
   maxBatchSize: 500,
   maxBatchWaitMs: 2000,
+  logLevel: 'debug'
 });
 ```
 
@@ -165,17 +167,17 @@ const customExporter = new CloudExporter({
 
 ### Documentation
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Complete guide
-- [Exporters](/docs/observability/ai-tracing/overview#exporters) - Exporter concepts
+- [Tracing Overview](/docs/v1/observability/tracing/overview) - Complete guide
+- [Exporters](/docs/v1/observability/tracing/overview#exporters) - Exporter concepts
 
 ### Other Exporters
 
-- [DefaultExporter](/reference/observability/ai-tracing/exporters/default-exporter) - Storage persistence
-- [ConsoleExporter](/reference/observability/ai-tracing/exporters/console-exporter) - Debug output
-- [Langfuse](/reference/observability/ai-tracing/exporters/langfuse) - Langfuse integration
-- [Braintrust](/reference/observability/ai-tracing/exporters/braintrust) - Braintrust integration
+- [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
+- [ConsoleExporter](/reference/v1/observability/tracing/exporters/console-exporter) - Debug output
+- [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
+- [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
 
 ### Reference
 
-- [Configuration](/reference/observability/ai-tracing/configuration) - Configuration options
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
+- [Configuration](/reference/v1/observability/tracing/configuration) - Configuration options
+- [Interfaces](/reference/v1/observability/tracing/interfaces) - Type definitions

package/.docs/raw/reference/observability/{ai-tracing → tracing}/exporters/console-exporter.mdx

@@ -12,7 +12,27 @@ Outputs trace events to the console for debugging and development.
 ## Constructor
 
 ```typescript
-new ConsoleExporter(logger?: IMastraLogger)
+new ConsoleExporter(config?: BaseExporterConfig)
+```
+
+<PropertiesTable
+  props={[
+    {
+      name: "config",
+      type: "BaseExporterConfig",
+      description: "Configuration options",
+      required: false,
+    },
+  ]}
+/>
+
+## BaseExporterConfig
+
+```typescript
+interface BaseExporterConfig {
+  logger?: IMastraLogger;
+  logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error';
+}
 ```
 
 <PropertiesTable
@@ -20,8 +40,13 @@ new ConsoleExporter(logger?: IMastraLogger)
     {
       name: "logger",
       type: "IMastraLogger",
-      description:
-        "Logger instance to use. Falls back to ConsoleLogger with INFO level if not provided",
+      description: "Logger instance (falls back to ConsoleLogger with INFO level)",
+      required: false,
+    },
+    {
+      name: "logLevel",
+      type: "LogLevel | 'debug' | 'info' | 'warn' | 'error'",
+      description: "Log level for the exporter (default: INFO)",
       required: false,
     },
   ]}
@@ -35,10 +60,10 @@ readonly name = 'tracing-console-exporter';
 
 ## Methods
 
-### exportEvent
+### exportTracingEvent
 
 ```typescript
-async exportEvent(event: AITracingEvent): Promise<void>
+async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
 Exports a tracing event to the console.
@@ -47,7 +72,7 @@ Exports a tracing event to the console.
   props={[
     {
       name: "event",
-      type: "AITracingEvent",
+      type: "TracingEvent",
       description: "The tracing event to export",
       required: true,
     },
@@ -113,15 +138,22 @@ The exporter outputs different formats based on event type:
 ## Usage
 
 ```typescript
-import { ConsoleExporter } from "@mastra/core/ai-tracing";
+import { ConsoleExporter } from "@mastra/observability";
 import { ConsoleLogger, LogLevel } from "@mastra/core/logger";
 
 // Use default logger (INFO level)
 const exporter = new ConsoleExporter();
 
-// Use custom logger
+// Use custom log level
+const exporter = new ConsoleExporter({
+  logLevel: 'debug'
+});
+
+// Use custom logger instance
 const customLogger = new ConsoleLogger({ level: LogLevel.DEBUG });
-const exporterWithLogger = new ConsoleExporter(customLogger);
+const exporterWithLogger = new ConsoleExporter({
+  logger: customLogger
+});
 ```
 
 ## Implementation Details
@@ -136,17 +168,17 @@ const exporterWithLogger = new ConsoleExporter(customLogger);
 
 ### Documentation
 
-- [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Complete guide
-- [Exporters](/docs/observability/ai-tracing/overview#exporters) - Exporter concepts
+- [Tracing Overview](/docs/v1/observability/tracing/overview) - Complete guide
+- [Exporters](/docs/v1/observability/tracing/overview#exporters) - Exporter concepts
 
 ### Other Exporters
 
-- [DefaultExporter](/reference/observability/ai-tracing/exporters/default-exporter) - Storage persistence
-- [CloudExporter](/reference/observability/ai-tracing/exporters/cloud-exporter) - Mastra Cloud
-- [Langfuse](/reference/observability/ai-tracing/exporters/langfuse) - Langfuse integration
-- [Braintrust](/reference/observability/ai-tracing/exporters/braintrust) - Braintrust integration
+- [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
+- [CloudExporter](/reference/v1/observability/tracing/exporters/cloud-exporter) - Mastra Cloud
+- [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
+- [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
 
 ### Reference
 
-- [Configuration](/reference/observability/ai-tracing/configuration) - Configuration options
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
+- [Configuration](/reference/v1/observability/tracing/configuration) - Configuration options
+- [Interfaces](/reference/v1/observability/tracing/interfaces) - Type definitions