@mastra/mcp-docs-server 1.2.13 → 1.2.14-alpha.3

package/.docs/docs/observability/config.md

@@ -1,140 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# Configuration
-
-Observability is configured once on your Mastra instance and applies across traces, logs, and metrics.
-
-## When to use configuration
-
-- Set up a default observability pipeline for local development.
-- Route different environments or request types to different observability configs.
-- Keep Mastra Studio and Mastra platform access enabled while also sending data to external providers.
-
-## Quickstart
-
-The following example demonstrates the standard starter setup: composite storage with DuckDB for the observability domain, plus Mastra storage, Mastra platform, and sensitive-data redaction.
-
-```ts
-import { Mastra } from '@mastra/core/mastra'
-import { MastraCompositeStore } from '@mastra/core/storage'
-import { DuckDBStore } from '@mastra/duckdb'
-import { LibSQLStore } from '@mastra/libsql'
-import {
-  Observability,
-  MastraStorageExporter,
-  MastraPlatformExporter,
-  SensitiveDataFilter,
-} from '@mastra/observability'
-
-export const mastra = new Mastra({
-  storage: new MastraCompositeStore({
-    id: 'composite-storage',
-    default: new LibSQLStore({
-      id: 'mastra-storage',
-      url: 'file:./mastra.db',
-    }),
-    domains: {
-      observability: await new DuckDBStore().getStore('observability'),
-    },
-  }),
-  observability: new Observability({
-    configs: {
-      default: {
-        serviceName: 'mastra',
-        exporters: [new MastraStorageExporter(), new MastraPlatformExporter()],
-        spanOutputProcessors: [new SensitiveDataFilter()],
-        logging: {
-          enabled: true,
-          level: 'info',
-        },
-      },
-    },
-  }),
-})
-```
-
-## Basic config
-
-An observability config usually contains:
-
-- `serviceName`: The service identifier attached to exported observability data.
-- `exporters`: One or more destinations for traces, logs, and derived metrics.
-- `spanOutputProcessors`: Transformations that run before spans are exported.
-- `logging`: Log forwarding settings for observability storage.
-
-For destinations and processors, see [Integrations overview](https://mastra.ai/docs/observability/integrations/overview).
-
-## Maintaining Studio access
-
-When you add external exporters, keep `MastraStorageExporter` for Studio observability and/or `MastraPlatformExporter` for hosted Mastra platform observability.
-
-This example shows only the observability config. Configure storage separately.
-
-```ts
-import { Observability, MastraStorageExporter, MastraPlatformExporter } from '@mastra/observability'
-import { ArizeExporter } from '@mastra/arize'
-
-export const observability = new Observability({
-  configs: {
-    production: {
-      serviceName: 'my-service',
-      exporters: [
-        new ArizeExporter({
-          endpoint: process.env.PHOENIX_COLLECTOR_ENDPOINT,
-          apiKey: process.env.PHOENIX_API_KEY,
-        }),
-        new MastraStorageExporter(),
-        new MastraPlatformExporter(),
-      ],
-    },
-  },
-})
-```
-
-## Flushing in serverless environments
-
-In serverless environments, flush observability exporters before the runtime pauses or exits:
-
-```ts
-await mastra.observability.flush()
-```
-
-Use external storage in serverless environments instead of local file storage. For storage selection and routing, see [Storage](https://mastra.ai/docs/observability/storage).
-
-## Multi-config setup
-
-Use multiple configs when different environments or request types need different exporters or sampling behavior. Select the active config at runtime with `configSelector`.
-
-```ts
-import { Mastra } from '@mastra/core'
-import { Observability, MastraStorageExporter } from '@mastra/observability'
-import { LangfuseExporter } from '@mastra/langfuse'
-
-const storageExporter = new MastraStorageExporter()
-const langfuseExporter = new LangfuseExporter()
-
-export const mastra = new Mastra({
-  observability: new Observability({
-    configs: {
-      development: {
-        serviceName: 'my-service-dev',
-        exporters: [storageExporter],
-      },
-      production: {
-        serviceName: 'my-service-prod',
-        exporters: [storageExporter, langfuseExporter],
-      },
-    },
-    configSelector: () => process.env.NODE_ENV || 'development',
-  }),
-})
-```
-
-For trace sampling, see [Tracing](https://mastra.ai/docs/observability/tracing/overview).
-
-## Related
-
-- [Observability overview](https://mastra.ai/docs/observability/overview)
-- [Storage](https://mastra.ai/docs/observability/storage)
-- [Tracing](https://mastra.ai/docs/observability/tracing/overview)
-- [Integrations overview](https://mastra.ai/docs/observability/integrations/overview)

package/.docs/docs/observability/storage.md

@@ -1,81 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# Storage
-
-Storage determines which observability signals persist, which queries are available, and whether metrics aggregation works. Use a dedicated observability store instead of your primary application store.
-
-## When to use storage
-
-- Keep traces, logs, and metrics available in Mastra Studio during development.
-- Enable metrics with an OLAP-capable observability store.
-- Route the observability domain to a dedicated production backend.
-
-## Quickstart
-
-The following example demonstrates the recommended local testing setup: route observability data to DuckDB while keeping the rest of your application on LibSQL.
-
-```ts
-import { Mastra } from '@mastra/core/mastra'
-import { LibSQLStore } from '@mastra/libsql'
-import { DuckDBStore } from '@mastra/duckdb'
-import { MastraCompositeStore } from '@mastra/core/storage'
-import { Observability, MastraStorageExporter } from '@mastra/observability'
-
-export const mastra = new Mastra({
-  storage: new MastraCompositeStore({
-    id: 'composite-storage',
-    default: new LibSQLStore({
-      id: 'mastra-storage',
-      url: 'file:./mastra.db',
-    }),
-    domains: {
-      observability: await new DuckDBStore().getStore('observability'),
-    },
-  }),
-  observability: new Observability({
-    configs: {
-      default: {
-        serviceName: 'mastra',
-        exporters: [new MastraStorageExporter()],
-      },
-    },
-  }),
-})
-```
-
-## Signal support
-
-Mastra storage-backed observability currently depends on an OLAP-capable backend for full signal support:
-
-- DuckDB: Recommended for local testing and development.
-- ClickHouse: Recommended for production observability.
-- Mastra platform: Use `MastraPlatformExporter` if you want hosted observability without managing the backend yourself.
-
-Primary application stores such as LibSQL or PostgreSQL shouldn't be used as the observability store. Route the `observability` domain separately with composite storage when you use `MastraStorageExporter`.
-
-## Local development
-
-For local development, the recommended setup is:
-
-- `LibSQLStore` for primary application storage
-- `DuckDBStore` for the `observability` domain
-- `MastraStorageExporter` for local Studio access
-
-This setup is for local testing and development. It gives you persisted traces, logs, and metrics without introducing external infrastructure.
-
-## Production deployment
-
-Observability traffic is usually more write-heavy than the rest of the application. In production:
-
-- Use `MastraStorageExporter` with ClickHouse for the `observability` domain when you keep observability in your own storage.
-- Use `MastraPlatformExporter` if you want hosted Mastra platform observability instead of managing the backend yourself.
-- Don't route observability to your primary application store.
-
-For backend compatibility details and exporter batching behavior, see [Mastra Storage exporter](https://mastra.ai/docs/observability/integrations/exporters/mastra-storage).
-
-## Next steps
-
-- [Configuration](https://mastra.ai/docs/observability/config)
-- [Logging](https://mastra.ai/docs/observability/logging)
-- [Metrics overview](https://mastra.ai/docs/observability/metrics/overview)
-- [Mastra Storage exporter](https://mastra.ai/docs/observability/integrations/exporters/mastra-storage)