diff --git a/docs/platforms/javascript/common/agent-tracing/index.mdx b/docs/platforms/javascript/common/agent-tracing/index.mdx
index 332ad5ffabd3c0..066df31c97b826 100644
--- a/docs/platforms/javascript/common/agent-tracing/index.mdx
+++ b/docs/platforms/javascript/common/agent-tracing/index.mdx
@@ -101,6 +101,7 @@ On Cloudflare, how much setup you need depends on the library. Enabling tracing
- Google Gen AI SDK
- LangChain
- LangGraph
+- Mastra
@@ -213,7 +214,7 @@ You can also instrument agent spans yourself. See Mastra Sentry Exporter
+- Mastra Sentry Exporter
diff --git a/docs/platforms/javascript/common/agent-tracing/mastra.mdx b/docs/platforms/javascript/common/configuration/integrations/mastra.mdx
similarity index 99%
rename from docs/platforms/javascript/common/agent-tracing/mastra.mdx
rename to docs/platforms/javascript/common/configuration/integrations/mastra.mdx
index 841a03af10129c..aed2c23c7f7a03 100644
--- a/docs/platforms/javascript/common/agent-tracing/mastra.mdx
+++ b/docs/platforms/javascript/common/configuration/integrations/mastra.mdx
@@ -1,7 +1,6 @@
---
title: Mastra
sidebar_title: Mastra
-sidebar_order: 100
description: "Learn how to export Mastra AI tracing to Sentry."
supported:
- javascript.node
diff --git a/docs/product/agents/naming.mdx b/docs/product/agents/naming.mdx
index 6cd8b9961740db..fbdc6e8e9cc4e3 100644
--- a/docs/product/agents/naming.mdx
+++ b/docs/product/agents/naming.mdx
@@ -219,7 +219,10 @@ const agent = new Agent({
});
```
-
+
Mastra integration docs
diff --git a/redirects.js b/redirects.js
index f6a42584734a85..4f445a1ccb1fee 100644
--- a/redirects.js
+++ b/redirects.js
@@ -2222,6 +2222,69 @@ const userDocsRedirects = [
source: '/product/insights/:path*',
destination: '/product/dashboards/sentry-dashboards/',
},
+ // Mastra moved from Agent Tracing to JavaScript integrations
+ // Map older Agent Tracing names directly to avoid redirect chains.
+ {
+ source: '/platforms/javascript/ai-agent-monitoring/mastra.md',
+ destination: '/platforms/javascript/configuration/integrations/mastra.md',
+ },
+ {
+ source: '/platforms/javascript/ai-agent-monitoring/mastra/:path*',
+ destination:
+ '/platforms/javascript/configuration/integrations/mastra/:path*',
+ },
+ {
+ source:
+ '/platforms/javascript/guides/:guide/ai-agent-monitoring/mastra.md',
+ destination:
+ '/platforms/javascript/guides/:guide/configuration/integrations/mastra.md',
+ },
+ {
+ source:
+ '/platforms/javascript/guides/:guide/ai-agent-monitoring/mastra/:path*',
+ destination:
+ '/platforms/javascript/guides/:guide/configuration/integrations/mastra/:path*',
+ },
+ {
+ source: '/platforms/javascript/ai-agent-tracing/mastra.md',
+ destination: '/platforms/javascript/configuration/integrations/mastra.md',
+ },
+ {
+ source: '/platforms/javascript/ai-agent-tracing/mastra/:path*',
+ destination:
+ '/platforms/javascript/configuration/integrations/mastra/:path*',
+ },
+ {
+ source: '/platforms/javascript/guides/:guide/ai-agent-tracing/mastra.md',
+ destination:
+ '/platforms/javascript/guides/:guide/configuration/integrations/mastra.md',
+ },
+ {
+ source:
+ '/platforms/javascript/guides/:guide/ai-agent-tracing/mastra/:path*',
+ destination:
+ '/platforms/javascript/guides/:guide/configuration/integrations/mastra/:path*',
+ },
+ {
+ source: '/platforms/javascript/agent-tracing/mastra.md',
+ destination: '/platforms/javascript/configuration/integrations/mastra.md',
+ },
+ {
+ source: '/platforms/javascript/agent-tracing/mastra/:path*',
+ destination:
+ '/platforms/javascript/configuration/integrations/mastra/:path*',
+ },
+ {
+ source: '/platforms/javascript/guides/:guide/agent-tracing/mastra.md',
+ destination:
+ '/platforms/javascript/guides/:guide/configuration/integrations/mastra.md',
+ },
+ {
+ source:
+ '/platforms/javascript/guides/:guide/agent-tracing/mastra/:path*',
+ destination:
+ '/platforms/javascript/guides/:guide/configuration/integrations/mastra/:path*',
+ },
// Agent Tracing moved to top-level feature
{
source: