Skip to content

docs(mastra): rewrite integration for Mastra v1#675

Open
NVJKKartik wants to merge 1 commit into
devfrom
docs/mastra-v1-integration
Open

docs(mastra): rewrite integration for Mastra v1#675
NVJKKartik wants to merge 1 commit into
devfrom
docs/mastra-v1-integration

Conversation

@NVJKKartik
Copy link
Copy Markdown
Contributor

@NVJKKartik NVJKKartik commented Jun 3, 2026

Summary

The Mastra integration docs used Mastra v0.x's telemetry: config + FITraceExporter, which exports nothing on Mastra v1 (@mastra/core >= 1.16) — v1 removed the telemetry: key. This rewrites both Mastra pages to the v1 setup.

Updates:

  • docs/integrations/traceai/mastra
  • docs/tracing/auto/mastra

What changed

  • Install: @mastra/observability + @mastra/otel-exporter + @opentelemetry/exporter-trace-otlp-proto + @traceai/mastra
  • Configure via createFIObservability({ serviceName }) on the v1 observability key (no agent-code changes)
  • Notes that spans are mapped to gen_ai.* conventions with the right span kind + input/output
  • Config-options table (projectName, projectType, excludeSpanTypes, baseUrl, endpoint, timeout, batchSize, …)
  • Short-lived-script / serverless flush pattern (observability.shutdown())
  • Deprecated v0.x path documented on the @traceai/mastra/legacy subpath

Screenshots

image image image

Related

Pairs with the SDK change: future-agi/traceAI#182

The previous guide used Mastra v0.x's `telemetry:` config + FITraceExporter, which
does not export any spans on Mastra v1 (>=1.16). Rewrites both Mastra pages
(integrations/traceai and tracing/auto) to the v1 setup:

- install @mastra/observability + @mastra/otel-exporter + the OTLP/protobuf exporter
- configure via `createFIObservability` from @traceai/mastra
- documents the config options (projectName/projectType/excludeSpanTypes/...),
  the short-lived-script flush pattern, and the deprecated /legacy subpath
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant