From 763ba8308540627bffe49c33cb7e4c2223803ff5 Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 18 Nov 2026 09:09:25 +0000 Subject: [PATCH 1/5] feat(mcp): Return setup knowledge from create_project create_project now returns `setup` for the new project's platform: its setup guide on docs.sentry.io and the core signals the platform supports (errors, traces, logs, metrics, session replay), each with a one-line `usefulFor` and a docs link. Errors and traces are marked recommended, matching the SDK's default init. Signals the organization has not enabled are left out, using the same organization features Sentry's onboarding checks. That lookup is best effort. The `guidance` string is removed, since it told the agent what to do instead of reporting facts. A failed DSN setup now returns a `create_dsn` suggested action instead. Platform data is generated into platforms.json by `pnpm run generate-platform-setup` from Sentry's platform list and the published docs tree. Co-Authored-By: David Cramer <23610+dcramer@users.noreply.github.com> --- docs/specs/project-management.md | 31 +- packages/mcp-core/package.json | 1 + .../scripts/generate-platform-setup.ts | 243 +++++ packages/mcp-core/src/skillDefinitions.json | 2 +- packages/mcp-core/src/toolDefinitions.json | 80 +- .../src/tools/catalog/create-project.test.ts | 180 +++- .../src/tools/catalog/create-project.ts | 80 +- .../support/project-setup/platforms.json | 989 ++++++++++++++++++ .../support/project-setup/project-setup.ts | 145 +++ 9 files changed, 1724 insertions(+), 27 deletions(-) create mode 100644 packages/mcp-core/scripts/generate-platform-setup.ts create mode 100644 packages/mcp-core/src/tools/support/project-setup/platforms.json create mode 100644 packages/mcp-core/src/tools/support/project-setup/project-setup.ts diff --git a/docs/specs/project-management.md b/docs/specs/project-management.md index caa8a3270e..907be54ab3 100644 --- a/docs/specs/project-management.md +++ b/docs/specs/project-management.md @@ -85,7 +85,36 @@ creating the project. Unknown or ambiguous repositories fail before the project is created. After creation, the tool links the repository by creating a root code mapping (`/` to `/`) through Sentry's organization code-mappings endpoint. If linking fails after project creation, the response still includes the project -slug and DSN and notes that the repository must be linked manually. +slug and DSN, with `repository.linked: false`. + +When DSN setup fails, the project still comes back with `dsn: null`, and +`suggestedActions` holds a `create_dsn` call for it. Otherwise +`suggestedActions` is empty. + +### Setup Knowledge + +The response includes `setup` for the project's platform, or `null` when the +project has no platform or the platform has no Sentry setup guide: + +- `platform`: display name, such as `Next.js`. +- `docsUrl`: the platform's setup guide on docs.sentry.io. +- `signals`: the core signals the platform supports, in this order: Errors, + Traces, Logs, Metrics, and Session Replay. Each has a `name`, a one-line + `usefulFor`, and its `docsUrl`. Errors and Traces set `recommended: true`, + because the SDK's default setup turns them on. + +Signals the organization has not enabled are left out, using the organization +features Sentry's own onboarding checks: `ourlogs-enabled` for Logs, +`tracemetrics-enabled` for Metrics, and `session-replay` for Session Replay. +The features lookup is best effort. When it fails, `signals` lists everything +the platform supports. + +Which signals each platform supports, and their docs pages, come from +`packages/mcp-core/src/tools/support/project-setup/platforms.json`. Regenerate +it with `pnpm --filter @sentry/mcp-core run generate-platform-setup`, which reads +Sentry's platform list (`static/app/data/platforms.tsx` in getsentry/sentry) and +the published docs tree (`https://docs.sentry.io/doctree.json`). A platform +supports a signal when its docs page has that signal's child page. ## Metadata Updates diff --git a/packages/mcp-core/package.json b/packages/mcp-core/package.json index b43b0b86cb..adbd9a2ff1 100644 --- a/packages/mcp-core/package.json +++ b/packages/mcp-core/package.json @@ -160,6 +160,7 @@ "test:watch": "pnpm run generate-definitions && vitest", "tsc": "tsc --noEmit", "generate-definitions": "node --experimental-strip-types --import ../../scripts/strip-types-resolve.mjs scripts/generate-definitions.ts && oxfmt --write src/toolDefinitions.json src/skillDefinitions.json", + "generate-platform-setup": "node --experimental-strip-types --import ../../scripts/strip-types-resolve.mjs scripts/generate-platform-setup.ts && oxfmt --write src/tools/support/project-setup/platforms.json", "generate-otel-namespaces": "node --experimental-strip-types --import ../../scripts/strip-types-resolve.mjs scripts/generate-otel-namespaces.ts", "measure-tokens": "node --experimental-strip-types --import ../../scripts/strip-types-resolve.mjs scripts/measure-token-cost.ts", "validate-skills": "node --experimental-strip-types --import ../../scripts/strip-types-resolve.mjs scripts/validate-skills-mapping.ts" diff --git a/packages/mcp-core/scripts/generate-platform-setup.ts b/packages/mcp-core/scripts/generate-platform-setup.ts new file mode 100644 index 0000000000..2035bd9234 --- /dev/null +++ b/packages/mcp-core/scripts/generate-platform-setup.ts @@ -0,0 +1,243 @@ +/** + * Generates src/tools/support/project-setup/platforms.json: for each Sentry + * platform ID, its display name, its setup docs page, and the docs page of + * each core signal (traces, logs, metrics, session replay) that its SDK + * supports. `create_project` returns this as setup knowledge. + * + * Sources: + * - getsentry/sentry static/app/data/platforms.tsx: platform IDs, names, + * and docs links, the same list Sentry's project creation uses. + * - docs.sentry.io/doctree.json: the published docs tree. A platform page + * has a `tracing`, `logs`, `metrics`, or `session-replay` child only when + * the docs say its SDK supports that signal. + * + * Usage (from packages/mcp-core): + * pnpm run generate-platform-setup + * + * The output is committed. Rerun this when Sentry adds a platform or the docs + * change which signals a platform supports. + */ +import { writeFileSync } from "node:fs"; +import { dirname, resolve } from "node:path"; +import { fileURLToPath } from "node:url"; +import { z } from "zod"; + +const __dirname = dirname(fileURLToPath(import.meta.url)); + +const PLATFORMS_URL = + "https://raw.githubusercontent.com/getsentry/sentry/master/static/app/data/platforms.tsx"; +const DOCS_ORIGIN = "https://docs.sentry.io"; +const OUTPUT_PATH = resolve( + __dirname, + "../src/tools/support/project-setup/platforms.json", +); + +// Docs child page slug for each signal, in the order the result lists them. +const SIGNAL_PAGES = { + traces: "tracing", + logs: "logs", + metrics: "metrics", + sessionReplay: "session-replay", +} as const; + +type SignalKey = keyof typeof SIGNAL_PAGES; + +// Platforms whose link in platforms.tsx points at a broader page than the +// platform's own guide. Mirrors CANONICAL_OVERRIDES in getsentry/sentry +// scripts/genPlatformProductInfo.ts. +const DOCS_PATH_OVERRIDES: Record = { + "apple-ios": "/platforms/apple/guides/ios/", + "apple-macos": "/platforms/apple/guides/macos/", +}; + +interface DocTreeNode { + path: string; + slug: string; + frontmatter?: { + title?: string; + fallbackGuide?: string; + sidebar_hidden?: boolean; + }; + children?: DocTreeNode[]; +} + +const DocTreeNodeSchema: z.ZodType = z.lazy(() => + z.object({ + path: z.string(), + slug: z.string(), + frontmatter: z + .object({ + title: z.string().optional(), + fallbackGuide: z.string().optional(), + sidebar_hidden: z.boolean().optional(), + }) + .optional(), + children: z.array(DocTreeNodeSchema).optional(), + }), +); + +interface PlatformEntry { + id: string; + name: string; + link: string; +} + +interface PlatformSetupEntry { + name: string; + docsPath: string; + signals: Partial>; +} + +function readField(block: string, field: string): string | undefined { + return block.match( + new RegExp(`(?:^|\\n)\\s*${field}:\\s*['"]([^'"]*)['"]`), + )?.[1]; +} + +/** Reads the static `platforms` array literal from platforms.tsx. */ +function parsePlatforms(source: string): PlatformEntry[] { + const body = source.split("export const platforms")[1]?.split("\n];")[0]; + if (!body) { + throw new Error("platforms array not found in platforms.tsx"); + } + const platforms: PlatformEntry[] = []; + for (const block of body.split(/\n {2}\{\n/).slice(1)) { + const id = readField(block, "id"); + const name = readField(block, "name"); + const link = readField(block, "link"); + if (!id || !name || !link || /\n\s*deprecated:\s*true/.test(block)) { + continue; + } + platforms.push({ id, name, link }); + } + if (platforms.length === 0) { + throw new Error("no platforms parsed from platforms.tsx"); + } + return platforms; +} + +function normalizePath(path: string): string { + return path.replace(/^\/+|\/+$/g, ""); +} + +function indexDocTree(root: DocTreeNode): Map { + const index = new Map(); + const visit = (node: DocTreeNode) => { + if (node.frontmatter?.sidebar_hidden) { + return; + } + index.set(normalizePath(node.path), node); + for (const child of node.children ?? []) { + visit(child); + } + }; + visit(root); + return index; +} + +function hasSignalPages(node: DocTreeNode): boolean { + const pages = new Set(Object.values(SIGNAL_PAGES)); + return (node.children ?? []).some((child) => pages.has(child.slug)); +} + +/** + * Finds the page whose children list the signals for a platform page. Guides + * that share another guide's SDK, such as Express on Node.js, name it in + * `fallbackGuide`. Integration pages, such as Django under Python, inherit + * from the nearest ancestor that lists signals. + */ +function findSignalSource( + index: Map, + path: string, +): DocTreeNode | null { + const node = index.get(path); + if (!node) { + return null; + } + if (hasSignalPages(node)) { + return node; + } + const fallbackGuide = node.frontmatter?.fallbackGuide; + if (fallbackGuide) { + const [lang, guide] = fallbackGuide.split("."); + const fallback = index.get(`platforms/${lang}/guides/${guide}`); + if (fallback && hasSignalPages(fallback)) { + return fallback; + } + } + const segments = path.split("/"); + while (segments.length > 2) { + segments.pop(); + const ancestor = index.get(segments.join("/")); + if (ancestor && hasSignalPages(ancestor)) { + return ancestor; + } + } + return node; +} + +async function resolveRedirects(path: string): Promise { + const response = await fetch(new URL(path, DOCS_ORIGIN), { + method: "HEAD", + redirect: "follow", + }); + return new URL(response.url).pathname; +} + +async function fetchText(url: string): Promise { + const response = await fetch(url); + if (!response.ok) { + throw new Error(`GET ${url} failed with ${response.status}`); + } + return await response.text(); +} + +async function main() { + const [platformsSource, docTreeText] = await Promise.all([ + fetchText(PLATFORMS_URL), + fetchText(`${DOCS_ORIGIN}/doctree.json`), + ]); + const platforms = parsePlatforms(platformsSource); + const index = indexDocTree(DocTreeNodeSchema.parse(JSON.parse(docTreeText))); + + const output: Record = {}; + const skipped: string[] = []; + for (const platform of platforms) { + const linkPath = + DOCS_PATH_OVERRIDES[platform.id] ?? new URL(platform.link).pathname; + const path = normalizePath(await resolveRedirects(linkPath)); + // The platform list page is not a setup guide (for example `other`). + if (path === "platforms" || !index.has(path)) { + skipped.push(`${platform.id} (${path})`); + continue; + } + const source = findSignalSource(index, path); + const childSlugs = new Set( + (source?.children ?? []).map((child) => child.slug), + ); + const signals: Partial> = {}; + for (const [key, slug] of Object.entries(SIGNAL_PAGES) as [ + SignalKey, + string, + ][]) { + if (source && childSlugs.has(slug)) { + signals[key] = `/${normalizePath(source.path)}/${slug}/`; + } + } + output[platform.id] = { + name: platform.name, + docsPath: `/${path}/`, + signals, + }; + } + + writeFileSync(OUTPUT_PATH, `${JSON.stringify(output, null, 2)}\n`); + console.log( + `Wrote ${Object.keys(output).length} platforms to ${OUTPUT_PATH}`, + ); + if (skipped.length > 0) { + console.log(`Skipped (no docs setup page): ${skipped.join(", ")}`); + } +} + +await main(); diff --git a/packages/mcp-core/src/skillDefinitions.json b/packages/mcp-core/src/skillDefinitions.json index a7701bc123..cd770a91c3 100644 --- a/packages/mcp-core/src/skillDefinitions.json +++ b/packages/mcp-core/src/skillDefinitions.json @@ -585,7 +585,7 @@ }, { "name": "create_project", - "description": "Create a new Sentry project for an app or service and provision its DSN (client key) for SDK setup. Optionally links a connected repository with a root code mapping. Returns the project, its DSN, and whether the repository linked.", + "description": "Create a new Sentry project for an app or service and provision its DSN (client key) for SDK setup. Optionally links a connected repository with a root code mapping. Returns the project, its DSN, whether the repository linked, and the Sentry signals its platform supports, each with a docs link.", "requiredScopes": ["project:write", "team:read", "org:read"] }, { diff --git a/packages/mcp-core/src/toolDefinitions.json b/packages/mcp-core/src/toolDefinitions.json index 0965114a63..53f80c5dfd 100644 --- a/packages/mcp-core/src/toolDefinitions.json +++ b/packages/mcp-core/src/toolDefinitions.json @@ -1218,7 +1218,7 @@ { "name": "create_project", "title": "Create Project", - "description": "Create a new Sentry project for an app or service and provision its DSN (client key) for SDK setup. Optionally links a connected repository with a root code mapping. Returns the project, its DSN, and whether the repository linked.", + "description": "Create a new Sentry project for an app or service and provision its DSN (client key) for SDK setup. Optionally links a connected repository with a root code mapping. Returns the project, its DSN, whether the repository linked, and the Sentry signals its platform supports, each with a docs link.", "inputSchema": { "type": "object", "properties": { @@ -1321,11 +1321,83 @@ } ] }, - "guidance": { - "type": "string" + "setup": { + "anyOf": [ + { + "type": "object", + "properties": { + "platform": { + "type": "string", + "description": "Platform display name, such as `Next.js`." + }, + "docsUrl": { + "type": "string", + "description": "Sentry setup guide for the platform." + }, + "signals": { + "type": "array", + "items": { + "type": "object", + "properties": { + "name": { + "type": "string" + }, + "usefulFor": { + "type": "string" + }, + "recommended": { + "description": "Set on signals the SDK's default setup turns on.", + "type": "boolean", + "const": true + }, + "docsUrl": { + "type": "string" + } + }, + "required": ["name", "usefulFor", "docsUrl"], + "additionalProperties": false + }, + "description": "Core signals the platform supports and the organization has enabled." + } + }, + "required": ["platform", "docsUrl", "signals"], + "additionalProperties": false + }, + { + "type": "null" + } + ], + "description": "Setup knowledge for the project's platform, or null without one." + }, + "suggestedActions": { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "const": "tool_call" + }, + "toolName": { + "type": "string" + }, + "arguments": { + "type": "object", + "propertyNames": { + "type": "string" + }, + "additionalProperties": {} + }, + "reason": { + "type": "string" + } + }, + "required": ["type", "toolName", "arguments", "reason"], + "additionalProperties": false + } } }, - "required": ["project", "dsn", "repository", "guidance"], + "required": ["project", "dsn", "repository", "setup", "suggestedActions"], "additionalProperties": false }, "requiredScopes": ["project:write", "team:read", "org:read"], diff --git a/packages/mcp-core/src/tools/catalog/create-project.test.ts b/packages/mcp-core/src/tools/catalog/create-project.test.ts index 4d7d3b6324..1d918a1339 100644 --- a/packages/mcp-core/src/tools/catalog/create-project.test.ts +++ b/packages/mcp-core/src/tools/catalog/create-project.test.ts @@ -1,6 +1,7 @@ import { clientKeyFixture, mswServer, + organizationFixture, projectFixture, } from "@sentry/mcp-server-mocks"; import { http, HttpResponse } from "msw"; @@ -59,13 +60,41 @@ describe("create_project", () => { expect(output).toMatchInlineSnapshot(` { "dsn": "https://d20df0a1ab5031c7f3c7edca9c02814d@o4509106732793856.ingest.us.sentry.io/4509109104082945", - "guidance": "Tell the user the project slug and DSN; the SDK needs the DSN.", "project": { "id": "4509109104082945", "name": "cloudflare-mcp", "slug": "cloudflare-mcp", }, "repository": null, + "setup": { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/", + "platform": "Node.js", + "signals": [ + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/", + "name": "Errors", + "recommended": true, + "usefulFor": "Exceptions and crashes, with stack traces", + }, + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/tracing/", + "name": "Traces", + "recommended": true, + "usefulFor": "Following requests, services, and agent runs end to end", + }, + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/logs/", + "name": "Logs", + "usefulFor": "App context around failures, linked to traces", + }, + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/metrics/", + "name": "Metrics", + "usefulFor": "Tracking and alerting on app and business health", + }, + ], + }, + "suggestedActions": [], } `); // Only the public DSN is exposed; secret keys and other key metadata stay private. @@ -260,8 +289,153 @@ describe("create_project", () => { project: { slug: "cloudflare-mcp" }, dsn: null, repository: null, - guidance: expect.stringContaining("Create one with create_dsn."), + suggestedActions: [ + { + type: "tool_call", + toolName: "create_dsn", + arguments: { + organizationSlug: "sentry-mcp-evals", + projectSlug: "cloudflare-mcp", + name: "Default", + }, + }, + ], + }); + }); + + it("lists only the setup signals the organization has enabled", async () => { + mswServer.use( + http.post( + "https://sentry.io/api/0/teams/sentry-mcp-evals/the-goats/projects/", + () => + HttpResponse.json({ + ...projectFixture, + platform: "javascript-nextjs", + }), + ), + http.get( + "https://sentry.io/api/0/organizations/sentry-mcp-evals/", + ({ request }) => { + expect( + new URL(request.url).searchParams.get("include_feature_flags"), + ).toBe("1"); + return HttpResponse.json({ + ...organizationFixture, + features: ["session-replay", "ourlogs-enabled"], + }); + }, + ), + ); + + const result = await createProject.handler( + { + organizationSlug: "sentry-mcp-evals", + teamSlug: "the-goats", + name: "cloudflare-mcp", + slug: null, + platform: "javascript-nextjs", + regionUrl: null, + repository: null, + }, + context, + ); + + expect(getOutput(result).setup).toMatchInlineSnapshot(` + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/", + "platform": "Next.js", + "signals": [ + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/", + "name": "Errors", + "recommended": true, + "usefulFor": "Exceptions and crashes, with stack traces", + }, + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/tracing/", + "name": "Traces", + "recommended": true, + "usefulFor": "Following requests, services, and agent runs end to end", + }, + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/logs/", + "name": "Logs", + "usefulFor": "App context around failures, linked to traces", + }, + { + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/session-replay/", + "name": "Session Replay", + "usefulFor": "Seeing what a user did before a bug", + }, + ], + } + `); + }); + + it("lists every supported setup signal when organization features fail to load", async () => { + mswServer.use( + http.get("https://sentry.io/api/0/organizations/sentry-mcp-evals/", () => + HttpResponse.json({ detail: "lookup failed" }, { status: 500 }), + ), + ); + + const result = await createProject.handler( + { + organizationSlug: "sentry-mcp-evals", + teamSlug: "the-goats", + name: "cloudflare-mcp", + slug: null, + platform: "node", + regionUrl: null, + repository: null, + }, + context, + ); + + const output = getOutput(result); + expect(output.dsn).not.toBeNull(); + expect(output.setup?.signals.map((signal) => signal.name)).toEqual([ + "Errors", + "Traces", + "Logs", + "Metrics", + ]); + }); + + it("returns no setup knowledge without a platform", async () => { + let organizationRequested = false; + mswServer.use( + http.post( + "https://sentry.io/api/0/teams/sentry-mcp-evals/the-goats/projects/", + () => HttpResponse.json({ ...projectFixture, platform: null }), + ), + http.get( + "https://sentry.io/api/0/organizations/sentry-mcp-evals/", + () => { + organizationRequested = true; + return HttpResponse.json(organizationFixture); + }, + ), + ); + + const result = await createProject.handler( + { + organizationSlug: "sentry-mcp-evals", + teamSlug: "the-goats", + name: "cloudflare-mcp", + slug: null, + platform: null, + regionUrl: null, + repository: null, + }, + context, + ); + + expect(getOutput(result)).toMatchObject({ + setup: null, + suggestedActions: [], }); + expect(organizationRequested).toBe(false); }); it("passes an optional slug through project creation", async () => { @@ -437,7 +611,7 @@ describe("create_project", () => { project: { slug: "cloudflare-mcp" }, dsn: expect.any(String), repository: { name: "getsentry/sentry", linked: false }, - guidance: expect.stringContaining("The repository did not link."), + suggestedActions: [], }); }); diff --git a/packages/mcp-core/src/tools/catalog/create-project.ts b/packages/mcp-core/src/tools/catalog/create-project.ts index 75e5f5d641..6368b0bd25 100644 --- a/packages/mcp-core/src/tools/catalog/create-project.ts +++ b/packages/mcp-core/src/tools/catalog/create-project.ts @@ -4,6 +4,10 @@ import { UserInputError } from "../../errors"; import { apiServiceFromContext } from "../../internal/tool-helpers/api"; import { defineTool } from "../../internal/tool-helpers/define"; import { structuredResult } from "../../internal/tool-helpers/results"; +import { + buildSuggestedToolAction, + suggestedToolActionSchema, +} from "../../internal/tool-helpers/suggested-actions"; import { ParamOrganizationSlug, ParamPlatform, @@ -14,6 +18,10 @@ import { import { logWarn } from "../../telem/logging"; import { setTargetTagsAndAttributes } from "../../telem/scope"; import type { ServerContext } from "../../types"; +import { + buildProjectSetup, + projectSetupSchema, +} from "../support/project-setup/project-setup"; export const createProjectOutputSchema = z.object({ project: z.object({ @@ -33,7 +41,8 @@ export const createProjectOutputSchema = z.object({ linked: z.boolean(), }) .nullable(), - guidance: z.string(), + setup: projectSetupSchema, + suggestedActions: z.array(suggestedToolActionSchema), }); type RepositoryMatch = { @@ -84,6 +93,29 @@ function getRepositoryProvider(repository: RepositoryMatch): string | null { return repository.provider.id.replace(/^integrations:/, "") || null; } +async function getOrganizationFeatures({ + apiService, + organizationSlug, +}: { + apiService: SentryApiService; + organizationSlug: string; +}): Promise { + try { + // Sentry omits `features` unless explicitly requested. + const organization = await apiService.getOrganization(organizationSlug, { + includeFeatureFlags: true, + detailed: false, + }); + return organization.features ?? null; + } catch (err) { + logWarn(err, { + loggerScope: ["runtime", "project-management"], + extra: { action: "get_organization_features" }, + }); + return null; + } +} + async function getOrCreateClientKey({ apiService, organizationSlug, @@ -134,7 +166,7 @@ export default defineTool({ skills: ["project-management"], // Only available in project-management skill requiredScopes: ["project:write", "team:read", "org:read"], description: - "Create a new Sentry project for an app or service and provision its DSN (client key) for SDK setup. Optionally links a connected repository with a root code mapping. Returns the project, its DSN, and whether the repository linked.", + "Create a new Sentry project for an app or service and provision its DSN (client key) for SDK setup. Optionally links a connected repository with a root code mapping. Returns the project, its DSN, whether the repository linked, and the Sentry signals its platform supports, each with a docs link.", inputSchema: { organizationSlug: ParamOrganizationSlug, regionUrl: ParamRegionUrl.nullable().default(null), @@ -215,22 +247,33 @@ export default defineTool({ } } - const clientKey = await getOrCreateClientKey({ - apiService, - organizationSlug, - projectSlug: project.slug, - }); + const platform = params.platform ?? project.platform ?? null; + const [clientKey, organizationFeatures] = await Promise.all([ + getOrCreateClientKey({ + apiService, + organizationSlug, + projectSlug: project.slug, + }), + // Only needed to filter setup signals, so skip it without a platform. + platform + ? getOrganizationFeatures({ apiService, organizationSlug }) + : null, + ]); const dsn = clientKey?.dsn.public ?? null; - const guidance = [ - dsn - ? "Tell the user the project slug and DSN; the SDK needs the DSN." - : "The project exists, but its DSN could not be set up. Create one with create_dsn.", - ]; - if (repositoryMatch && !repositoryLinked) { - guidance.push( - "The repository did not link. Ask the user to check that the integration can access it, or link it in the project's Sentry settings.", - ); - } + const createDsnAction = dsn + ? null + : buildSuggestedToolAction({ + toolName: "create_dsn", + arguments: { + organizationSlug, + projectSlug: project.slug, + name: "Default", + }, + reason: "The project was created without a DSN.", + experimentalMode: context.experimentalMode ?? false, + availableToolNames: context.availableToolNames, + directToolNames: context.directToolNames, + }); return structuredResult({ project: { id: String(project.id), @@ -241,7 +284,8 @@ export default defineTool({ repository: repositoryMatch ? { name: repositoryMatch.name, linked: repositoryLinked } : null, - guidance: guidance.join(" "), + setup: buildProjectSetup(platform, organizationFeatures), + suggestedActions: createDsnAction ? [createDsnAction] : [], }); }, }); diff --git a/packages/mcp-core/src/tools/support/project-setup/platforms.json b/packages/mcp-core/src/tools/support/project-setup/platforms.json new file mode 100644 index 0000000000..de67ef4bed --- /dev/null +++ b/packages/mcp-core/src/tools/support/project-setup/platforms.json @@ -0,0 +1,989 @@ +{ + "android": { + "name": "Android", + "docsPath": "/platforms/android/", + "signals": { + "traces": "/platforms/android/tracing/", + "logs": "/platforms/android/logs/", + "metrics": "/platforms/android/metrics/", + "sessionReplay": "/platforms/android/session-replay/" + } + }, + "apple": { + "name": "Apple", + "docsPath": "/platforms/apple/", + "signals": { + "traces": "/platforms/apple/tracing/", + "logs": "/platforms/apple/logs/", + "metrics": "/platforms/apple/metrics/", + "sessionReplay": "/platforms/apple/session-replay/" + } + }, + "apple-ios": { + "name": "iOS", + "docsPath": "/platforms/apple/guides/ios/", + "signals": { + "traces": "/platforms/apple/guides/ios/tracing/", + "logs": "/platforms/apple/guides/ios/logs/", + "metrics": "/platforms/apple/guides/ios/metrics/", + "sessionReplay": "/platforms/apple/guides/ios/session-replay/" + } + }, + "apple-macos": { + "name": "macOS", + "docsPath": "/platforms/apple/guides/macos/", + "signals": { + "traces": "/platforms/apple/guides/macos/tracing/", + "logs": "/platforms/apple/guides/macos/logs/", + "metrics": "/platforms/apple/guides/macos/metrics/", + "sessionReplay": "/platforms/apple/guides/macos/session-replay/" + } + }, + "bun": { + "name": "Bun", + "docsPath": "/platforms/javascript/guides/bun/", + "signals": { + "traces": "/platforms/javascript/guides/bun/tracing/", + "logs": "/platforms/javascript/guides/bun/logs/", + "metrics": "/platforms/javascript/guides/bun/metrics/" + } + }, + "capacitor": { + "name": "Capacitor", + "docsPath": "/platforms/javascript/guides/capacitor/", + "signals": { + "traces": "/platforms/javascript/guides/capacitor/tracing/", + "logs": "/platforms/javascript/guides/capacitor/logs/", + "sessionReplay": "/platforms/javascript/guides/capacitor/session-replay/" + } + }, + "cordova": { + "name": "Cordova", + "docsPath": "/platforms/javascript/guides/cordova/", + "signals": { + "traces": "/platforms/javascript/guides/cordova/tracing/" + } + }, + "dart": { + "name": "Dart", + "docsPath": "/platforms/dart/", + "signals": { + "traces": "/platforms/dart/tracing/", + "logs": "/platforms/dart/logs/", + "metrics": "/platforms/dart/metrics/" + } + }, + "deno": { + "name": "Deno", + "docsPath": "/platforms/javascript/guides/deno/", + "signals": { + "traces": "/platforms/javascript/guides/deno/tracing/", + "logs": "/platforms/javascript/guides/deno/logs/", + "metrics": "/platforms/javascript/guides/deno/metrics/" + } + }, + "dotnet": { + "name": ".NET", + "docsPath": "/platforms/dotnet/", + "signals": { + "traces": "/platforms/dotnet/tracing/", + "logs": "/platforms/dotnet/logs/", + "metrics": "/platforms/dotnet/metrics/" + } + }, + "dotnet-aspnet": { + "name": "ASP.NET", + "docsPath": "/platforms/dotnet/guides/aspnet/", + "signals": { + "traces": "/platforms/dotnet/guides/aspnet/tracing/", + "logs": "/platforms/dotnet/guides/aspnet/logs/", + "metrics": "/platforms/dotnet/guides/aspnet/metrics/" + } + }, + "dotnet-aspnetcore": { + "name": "ASP.NET Core", + "docsPath": "/platforms/dotnet/guides/aspnetcore/", + "signals": { + "traces": "/platforms/dotnet/guides/aspnetcore/tracing/", + "logs": "/platforms/dotnet/guides/aspnetcore/logs/", + "metrics": "/platforms/dotnet/guides/aspnetcore/metrics/" + } + }, + "dotnet-awslambda": { + "name": "AWS Lambda (.NET)", + "docsPath": "/platforms/dotnet/guides/aws-lambda/", + "signals": { + "traces": "/platforms/dotnet/guides/aws-lambda/tracing/", + "logs": "/platforms/dotnet/guides/aws-lambda/logs/", + "metrics": "/platforms/dotnet/guides/aws-lambda/metrics/" + } + }, + "dotnet-gcpfunctions": { + "name": "Google Cloud Functions (.NET)", + "docsPath": "/platforms/dotnet/guides/google-cloud-functions/", + "signals": { + "traces": "/platforms/dotnet/guides/google-cloud-functions/tracing/", + "metrics": "/platforms/dotnet/guides/google-cloud-functions/metrics/" + } + }, + "dotnet-maui": { + "name": ".NET MAUI", + "docsPath": "/platforms/dotnet/guides/maui/", + "signals": { + "traces": "/platforms/dotnet/guides/maui/tracing/", + "logs": "/platforms/dotnet/guides/maui/logs/", + "metrics": "/platforms/dotnet/guides/maui/metrics/" + } + }, + "dotnet-winforms": { + "name": "Windows Forms", + "docsPath": "/platforms/dotnet/guides/winforms/", + "signals": { + "traces": "/platforms/dotnet/guides/winforms/tracing/", + "logs": "/platforms/dotnet/guides/winforms/logs/", + "metrics": "/platforms/dotnet/guides/winforms/metrics/" + } + }, + "dotnet-wpf": { + "name": "WPF", + "docsPath": "/platforms/dotnet/guides/wpf/", + "signals": { + "traces": "/platforms/dotnet/guides/wpf/tracing/", + "logs": "/platforms/dotnet/guides/wpf/logs/", + "metrics": "/platforms/dotnet/guides/wpf/metrics/" + } + }, + "dotnet-xamarin": { + "name": "Xamarin", + "docsPath": "/platforms/dotnet/guides/xamarin/", + "signals": { + "traces": "/platforms/dotnet/guides/xamarin/tracing/" + } + }, + "electron": { + "name": "Electron", + "docsPath": "/platforms/javascript/guides/electron/", + "signals": { + "traces": "/platforms/javascript/guides/electron/tracing/", + "logs": "/platforms/javascript/guides/electron/logs/", + "metrics": "/platforms/javascript/guides/electron/metrics/", + "sessionReplay": "/platforms/javascript/guides/electron/session-replay/" + } + }, + "elixir": { + "name": "Elixir", + "docsPath": "/platforms/elixir/", + "signals": { + "traces": "/platforms/elixir/tracing/", + "logs": "/platforms/elixir/logs/", + "metrics": "/platforms/elixir/metrics/" + } + }, + "expo": { + "name": "Expo", + "docsPath": "/platforms/react-native/guides/expo/", + "signals": { + "traces": "/platforms/react-native/guides/expo/tracing/", + "logs": "/platforms/react-native/guides/expo/logs/", + "metrics": "/platforms/react-native/guides/expo/metrics/", + "sessionReplay": "/platforms/react-native/guides/expo/session-replay/" + } + }, + "flutter": { + "name": "Flutter", + "docsPath": "/platforms/dart/guides/flutter/", + "signals": { + "traces": "/platforms/dart/guides/flutter/tracing/", + "logs": "/platforms/dart/guides/flutter/logs/", + "metrics": "/platforms/dart/guides/flutter/metrics/", + "sessionReplay": "/platforms/dart/guides/flutter/session-replay/" + } + }, + "go": { + "name": "Go", + "docsPath": "/platforms/go/", + "signals": { + "traces": "/platforms/go/tracing/", + "logs": "/platforms/go/logs/", + "metrics": "/platforms/go/metrics/" + } + }, + "go-echo": { + "name": "Echo", + "docsPath": "/platforms/go/guides/echo/", + "signals": { + "traces": "/platforms/go/guides/echo/tracing/", + "logs": "/platforms/go/guides/echo/logs/", + "metrics": "/platforms/go/guides/echo/metrics/" + } + }, + "go-fasthttp": { + "name": "FastHTTP", + "docsPath": "/platforms/go/guides/fasthttp/", + "signals": { + "traces": "/platforms/go/guides/fasthttp/tracing/", + "logs": "/platforms/go/guides/fasthttp/logs/", + "metrics": "/platforms/go/guides/fasthttp/metrics/" + } + }, + "go-fiber": { + "name": "Fiber", + "docsPath": "/platforms/go/guides/fiber/", + "signals": { + "traces": "/platforms/go/guides/fiber/tracing/", + "logs": "/platforms/go/guides/fiber/logs/", + "metrics": "/platforms/go/guides/fiber/metrics/" + } + }, + "go-gin": { + "name": "Gin", + "docsPath": "/platforms/go/guides/gin/", + "signals": { + "traces": "/platforms/go/guides/gin/tracing/", + "logs": "/platforms/go/guides/gin/logs/", + "metrics": "/platforms/go/guides/gin/metrics/" + } + }, + "go-http": { + "name": "Net/Http", + "docsPath": "/platforms/go/guides/http/", + "signals": { + "traces": "/platforms/go/guides/http/tracing/", + "logs": "/platforms/go/guides/http/logs/", + "metrics": "/platforms/go/guides/http/metrics/" + } + }, + "go-iris": { + "name": "Iris", + "docsPath": "/platforms/go/guides/iris/", + "signals": { + "traces": "/platforms/go/guides/iris/tracing/", + "logs": "/platforms/go/guides/iris/logs/", + "metrics": "/platforms/go/guides/iris/metrics/" + } + }, + "go-negroni": { + "name": "Negroni", + "docsPath": "/platforms/go/guides/negroni/", + "signals": { + "traces": "/platforms/go/guides/negroni/tracing/", + "logs": "/platforms/go/guides/negroni/logs/", + "metrics": "/platforms/go/guides/negroni/metrics/" + } + }, + "godot": { + "name": "Godot", + "docsPath": "/platforms/godot/", + "signals": { + "traces": "/platforms/godot/tracing/", + "logs": "/platforms/godot/logs/", + "metrics": "/platforms/godot/metrics/" + } + }, + "ionic": { + "name": "Ionic", + "docsPath": "/platforms/javascript/guides/capacitor/", + "signals": { + "traces": "/platforms/javascript/guides/capacitor/tracing/", + "logs": "/platforms/javascript/guides/capacitor/logs/", + "sessionReplay": "/platforms/javascript/guides/capacitor/session-replay/" + } + }, + "java": { + "name": "Java", + "docsPath": "/platforms/java/", + "signals": { + "traces": "/platforms/java/tracing/", + "logs": "/platforms/java/logs/", + "metrics": "/platforms/java/metrics/" + } + }, + "java-log4j2": { + "name": "Log4j 2.x", + "docsPath": "/platforms/java/guides/log4j2/", + "signals": { + "traces": "/platforms/java/guides/log4j2/tracing/", + "logs": "/platforms/java/guides/log4j2/logs/", + "metrics": "/platforms/java/guides/log4j2/metrics/" + } + }, + "java-logback": { + "name": "Logback", + "docsPath": "/platforms/java/guides/logback/", + "signals": { + "traces": "/platforms/java/guides/logback/tracing/", + "logs": "/platforms/java/guides/logback/logs/", + "metrics": "/platforms/java/guides/logback/metrics/" + } + }, + "java-spring": { + "name": "Spring", + "docsPath": "/platforms/java/guides/spring/", + "signals": { + "traces": "/platforms/java/guides/spring/tracing/", + "logs": "/platforms/java/guides/spring/logs/", + "metrics": "/platforms/java/guides/spring/metrics/" + } + }, + "java-spring-boot": { + "name": "Spring Boot", + "docsPath": "/platforms/java/guides/spring-boot/", + "signals": { + "traces": "/platforms/java/guides/spring-boot/tracing/", + "logs": "/platforms/java/guides/spring-boot/logs/", + "metrics": "/platforms/java/guides/spring-boot/metrics/" + } + }, + "javascript": { + "name": "Browser JavaScript", + "docsPath": "/platforms/javascript/", + "signals": { + "traces": "/platforms/javascript/tracing/", + "logs": "/platforms/javascript/logs/", + "metrics": "/platforms/javascript/metrics/", + "sessionReplay": "/platforms/javascript/session-replay/" + } + }, + "javascript-angular": { + "name": "Angular", + "docsPath": "/platforms/javascript/guides/angular/", + "signals": { + "traces": "/platforms/javascript/guides/angular/tracing/", + "logs": "/platforms/javascript/guides/angular/logs/", + "metrics": "/platforms/javascript/guides/angular/metrics/", + "sessionReplay": "/platforms/javascript/guides/angular/session-replay/" + } + }, + "javascript-astro": { + "name": "Astro", + "docsPath": "/platforms/javascript/guides/astro/", + "signals": { + "traces": "/platforms/javascript/guides/astro/tracing/", + "logs": "/platforms/javascript/guides/astro/logs/", + "metrics": "/platforms/javascript/guides/astro/metrics/", + "sessionReplay": "/platforms/javascript/guides/astro/session-replay/" + } + }, + "javascript-ember": { + "name": "Ember", + "docsPath": "/platforms/javascript/guides/ember/", + "signals": { + "traces": "/platforms/javascript/guides/ember/tracing/", + "logs": "/platforms/javascript/guides/ember/logs/", + "metrics": "/platforms/javascript/guides/ember/metrics/", + "sessionReplay": "/platforms/javascript/guides/ember/session-replay/" + } + }, + "javascript-gatsby": { + "name": "Gatsby", + "docsPath": "/platforms/javascript/guides/gatsby/", + "signals": { + "traces": "/platforms/javascript/guides/gatsby/tracing/", + "logs": "/platforms/javascript/guides/gatsby/logs/", + "metrics": "/platforms/javascript/guides/gatsby/metrics/", + "sessionReplay": "/platforms/javascript/guides/gatsby/session-replay/" + } + }, + "javascript-nextjs": { + "name": "Next.js", + "docsPath": "/platforms/javascript/guides/nextjs/", + "signals": { + "traces": "/platforms/javascript/guides/nextjs/tracing/", + "logs": "/platforms/javascript/guides/nextjs/logs/", + "metrics": "/platforms/javascript/guides/nextjs/metrics/", + "sessionReplay": "/platforms/javascript/guides/nextjs/session-replay/" + } + }, + "javascript-react": { + "name": "React", + "docsPath": "/platforms/javascript/guides/react/", + "signals": { + "traces": "/platforms/javascript/guides/react/tracing/", + "logs": "/platforms/javascript/guides/react/logs/", + "metrics": "/platforms/javascript/guides/react/metrics/", + "sessionReplay": "/platforms/javascript/guides/react/session-replay/" + } + }, + "javascript-react-router": { + "name": "React Router Framework", + "docsPath": "/platforms/javascript/guides/react-router/", + "signals": { + "traces": "/platforms/javascript/guides/react-router/tracing/", + "logs": "/platforms/javascript/guides/react-router/logs/", + "metrics": "/platforms/javascript/guides/react-router/metrics/", + "sessionReplay": "/platforms/javascript/guides/react-router/session-replay/" + } + }, + "javascript-remix": { + "name": "Remix", + "docsPath": "/platforms/javascript/guides/remix/", + "signals": { + "traces": "/platforms/javascript/guides/remix/tracing/", + "logs": "/platforms/javascript/guides/remix/logs/", + "metrics": "/platforms/javascript/guides/remix/metrics/", + "sessionReplay": "/platforms/javascript/guides/remix/session-replay/" + } + }, + "javascript-solid": { + "name": "Solid", + "docsPath": "/platforms/javascript/guides/solid/", + "signals": { + "traces": "/platforms/javascript/guides/solid/tracing/", + "logs": "/platforms/javascript/guides/solid/logs/", + "metrics": "/platforms/javascript/guides/solid/metrics/", + "sessionReplay": "/platforms/javascript/guides/solid/session-replay/" + } + }, + "javascript-solidstart": { + "name": "SolidStart", + "docsPath": "/platforms/javascript/guides/solidstart/", + "signals": { + "traces": "/platforms/javascript/guides/solidstart/tracing/", + "logs": "/platforms/javascript/guides/solidstart/logs/", + "metrics": "/platforms/javascript/guides/solidstart/metrics/", + "sessionReplay": "/platforms/javascript/guides/solidstart/session-replay/" + } + }, + "javascript-svelte": { + "name": "Svelte", + "docsPath": "/platforms/javascript/guides/svelte/", + "signals": { + "traces": "/platforms/javascript/guides/svelte/tracing/", + "logs": "/platforms/javascript/guides/svelte/logs/", + "metrics": "/platforms/javascript/guides/svelte/metrics/", + "sessionReplay": "/platforms/javascript/guides/svelte/session-replay/" + } + }, + "javascript-sveltekit": { + "name": "SvelteKit", + "docsPath": "/platforms/javascript/guides/sveltekit/", + "signals": { + "traces": "/platforms/javascript/guides/sveltekit/tracing/", + "logs": "/platforms/javascript/guides/sveltekit/logs/", + "metrics": "/platforms/javascript/guides/sveltekit/metrics/", + "sessionReplay": "/platforms/javascript/guides/sveltekit/session-replay/" + } + }, + "javascript-tanstackstart-react": { + "name": "TanStack Start React", + "docsPath": "/platforms/javascript/guides/tanstackstart-react/", + "signals": { + "traces": "/platforms/javascript/guides/tanstackstart-react/tracing/", + "logs": "/platforms/javascript/guides/tanstackstart-react/logs/", + "metrics": "/platforms/javascript/guides/tanstackstart-react/metrics/", + "sessionReplay": "/platforms/javascript/guides/tanstackstart-react/session-replay/" + } + }, + "javascript-vue": { + "name": "Vue", + "docsPath": "/platforms/javascript/guides/vue/", + "signals": { + "traces": "/platforms/javascript/guides/vue/tracing/", + "logs": "/platforms/javascript/guides/vue/logs/", + "metrics": "/platforms/javascript/guides/vue/metrics/", + "sessionReplay": "/platforms/javascript/guides/vue/session-replay/" + } + }, + "javascript-nuxt": { + "name": "Nuxt", + "docsPath": "/platforms/javascript/guides/nuxt/", + "signals": { + "traces": "/platforms/javascript/guides/nuxt/tracing/", + "logs": "/platforms/javascript/guides/nuxt/logs/", + "metrics": "/platforms/javascript/guides/nuxt/metrics/", + "sessionReplay": "/platforms/javascript/guides/nuxt/session-replay/" + } + }, + "kotlin": { + "name": "Kotlin", + "docsPath": "/platforms/kotlin/", + "signals": {} + }, + "minidump": { + "name": "Minidump", + "docsPath": "/platforms/native/guides/minidumps/", + "signals": { + "traces": "/platforms/native/guides/minidumps/tracing/" + } + }, + "native": { + "name": "Native", + "docsPath": "/platforms/native/", + "signals": { + "traces": "/platforms/native/tracing/", + "logs": "/platforms/native/logs/", + "metrics": "/platforms/native/metrics/" + } + }, + "native-qt": { + "name": "Qt", + "docsPath": "/platforms/native/guides/qt/", + "signals": { + "traces": "/platforms/native/guides/qt/tracing/" + } + }, + "nintendo-switch": { + "name": "Nintendo Switch", + "docsPath": "/platforms/nintendo-switch/", + "signals": {} + }, + "node": { + "name": "Node.js", + "docsPath": "/platforms/javascript/guides/node/", + "signals": { + "traces": "/platforms/javascript/guides/node/tracing/", + "logs": "/platforms/javascript/guides/node/logs/", + "metrics": "/platforms/javascript/guides/node/metrics/" + } + }, + "node-awslambda": { + "name": "AWS Lambda (Node)", + "docsPath": "/platforms/javascript/guides/aws-lambda/", + "signals": { + "traces": "/platforms/javascript/guides/aws-lambda/tracing/", + "logs": "/platforms/javascript/guides/aws-lambda/logs/", + "metrics": "/platforms/javascript/guides/aws-lambda/metrics/" + } + }, + "node-azurefunctions": { + "name": "Azure Functions (Node)", + "docsPath": "/platforms/javascript/guides/azure-functions/", + "signals": { + "traces": "/platforms/javascript/guides/azure-functions/tracing/", + "logs": "/platforms/javascript/guides/azure-functions/logs/", + "metrics": "/platforms/javascript/guides/azure-functions/metrics/" + } + }, + "node-cloudflare-pages": { + "name": "Cloudflare (Node)", + "docsPath": "/platforms/javascript/guides/cloudflare/", + "signals": { + "traces": "/platforms/javascript/guides/cloudflare/tracing/", + "logs": "/platforms/javascript/guides/cloudflare/logs/", + "metrics": "/platforms/javascript/guides/cloudflare/metrics/" + } + }, + "node-cloudflare-workers": { + "name": "Cloudflare (Node)", + "docsPath": "/platforms/javascript/guides/cloudflare/", + "signals": { + "traces": "/platforms/javascript/guides/cloudflare/tracing/", + "logs": "/platforms/javascript/guides/cloudflare/logs/", + "metrics": "/platforms/javascript/guides/cloudflare/metrics/" + } + }, + "node-connect": { + "name": "Connect", + "docsPath": "/platforms/javascript/guides/node/", + "signals": { + "traces": "/platforms/javascript/guides/node/tracing/", + "logs": "/platforms/javascript/guides/node/logs/", + "metrics": "/platforms/javascript/guides/node/metrics/" + } + }, + "node-eve": { + "name": "Eve", + "docsPath": "/platforms/javascript/guides/eve/", + "signals": { + "traces": "/platforms/javascript/guides/eve/tracing/", + "logs": "/platforms/javascript/guides/eve/logs/", + "metrics": "/platforms/javascript/guides/eve/metrics/" + } + }, + "node-express": { + "name": "Express", + "docsPath": "/platforms/javascript/guides/express/", + "signals": { + "traces": "/platforms/javascript/guides/node/tracing/", + "logs": "/platforms/javascript/guides/node/logs/", + "metrics": "/platforms/javascript/guides/node/metrics/" + } + }, + "node-fastify": { + "name": "Fastify", + "docsPath": "/platforms/javascript/guides/fastify/", + "signals": { + "traces": "/platforms/javascript/guides/node/tracing/", + "logs": "/platforms/javascript/guides/node/logs/", + "metrics": "/platforms/javascript/guides/node/metrics/" + } + }, + "node-flue": { + "name": "Flue", + "docsPath": "/platforms/javascript/guides/flue/", + "signals": { + "traces": "/platforms/javascript/guides/flue/tracing/", + "logs": "/platforms/javascript/guides/flue/logs/", + "metrics": "/platforms/javascript/guides/flue/metrics/" + } + }, + "node-hapi": { + "name": "Hapi", + "docsPath": "/platforms/javascript/guides/hapi/", + "signals": { + "traces": "/platforms/javascript/guides/node/tracing/", + "logs": "/platforms/javascript/guides/node/logs/", + "metrics": "/platforms/javascript/guides/node/metrics/" + } + }, + "node-hono": { + "name": "Hono", + "docsPath": "/platforms/javascript/guides/hono/", + "signals": { + "traces": "/platforms/javascript/guides/hono/tracing/", + "logs": "/platforms/javascript/guides/hono/logs/", + "metrics": "/platforms/javascript/guides/hono/metrics/" + } + }, + "node-gcpfunctions": { + "name": "Google Cloud Functions (Node)", + "docsPath": "/platforms/javascript/guides/gcp-functions/", + "signals": { + "traces": "/platforms/javascript/guides/gcp-functions/tracing/", + "logs": "/platforms/javascript/guides/gcp-functions/logs/", + "metrics": "/platforms/javascript/guides/gcp-functions/metrics/" + } + }, + "node-koa": { + "name": "Koa", + "docsPath": "/platforms/javascript/guides/koa/", + "signals": { + "traces": "/platforms/javascript/guides/node/tracing/", + "logs": "/platforms/javascript/guides/node/logs/", + "metrics": "/platforms/javascript/guides/node/metrics/" + } + }, + "node-mastra": { + "name": "Mastra", + "docsPath": "/platforms/javascript/guides/mastra/", + "signals": { + "traces": "/platforms/javascript/guides/mastra/tracing/", + "logs": "/platforms/javascript/guides/mastra/logs/", + "metrics": "/platforms/javascript/guides/mastra/metrics/" + } + }, + "node-nestjs": { + "name": "Nest.js", + "docsPath": "/platforms/javascript/guides/nestjs/", + "signals": { + "traces": "/platforms/javascript/guides/nestjs/tracing/", + "logs": "/platforms/javascript/guides/nestjs/logs/", + "metrics": "/platforms/javascript/guides/nestjs/metrics/" + } + }, + "node-pi-durable": { + "name": "Pi Durable", + "docsPath": "/platforms/javascript/guides/pi-durable/", + "signals": { + "traces": "/platforms/javascript/guides/pi-durable/tracing/", + "logs": "/platforms/javascript/guides/pi-durable/logs/", + "metrics": "/platforms/javascript/guides/pi-durable/metrics/" + } + }, + "php": { + "name": "PHP", + "docsPath": "/platforms/php/", + "signals": { + "traces": "/platforms/php/tracing/", + "logs": "/platforms/php/logs/", + "metrics": "/platforms/php/metrics/" + } + }, + "php-laravel": { + "name": "Laravel", + "docsPath": "/platforms/php/guides/laravel/", + "signals": { + "traces": "/platforms/php/guides/laravel/tracing/", + "logs": "/platforms/php/guides/laravel/logs/", + "metrics": "/platforms/php/guides/laravel/metrics/" + } + }, + "php-symfony": { + "name": "Symfony", + "docsPath": "/platforms/php/guides/symfony/", + "signals": { + "traces": "/platforms/php/guides/symfony/tracing/", + "logs": "/platforms/php/guides/symfony/logs/", + "metrics": "/platforms/php/guides/symfony/metrics/" + } + }, + "playstation": { + "name": "PlayStation", + "docsPath": "/platforms/playstation/", + "signals": {} + }, + "powershell": { + "name": "PowerShell", + "docsPath": "/platforms/powershell/", + "signals": { + "traces": "/platforms/powershell/tracing/" + } + }, + "python": { + "name": "Python", + "docsPath": "/platforms/python/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-aiohttp": { + "name": "AIOHTTP", + "docsPath": "/platforms/python/integrations/aiohttp/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-asgi": { + "name": "ASGI", + "docsPath": "/platforms/python/integrations/asgi/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-awslambda": { + "name": "AWS Lambda (Python)", + "docsPath": "/platforms/python/integrations/aws-lambda/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-bottle": { + "name": "Bottle", + "docsPath": "/platforms/python/integrations/bottle/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-celery": { + "name": "Celery", + "docsPath": "/platforms/python/integrations/celery/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-chalice": { + "name": "Chalice", + "docsPath": "/platforms/python/integrations/chalice/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-django": { + "name": "Django", + "docsPath": "/platforms/python/integrations/django/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-falcon": { + "name": "Falcon", + "docsPath": "/platforms/python/integrations/falcon/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-fastapi": { + "name": "FastAPI", + "docsPath": "/platforms/python/integrations/fastapi/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-flask": { + "name": "Flask", + "docsPath": "/platforms/python/integrations/flask/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-litestar": { + "name": "Litestar", + "docsPath": "/platforms/python/integrations/litestar/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-gcpfunctions": { + "name": "Google Cloud Functions (Python)", + "docsPath": "/platforms/python/integrations/gcp-functions/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-pyramid": { + "name": "Pyramid", + "docsPath": "/platforms/python/integrations/pyramid/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-quart": { + "name": "Quart", + "docsPath": "/platforms/python/integrations/quart/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-rq": { + "name": "RQ (Redis Queue)", + "docsPath": "/platforms/python/integrations/rq/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-sanic": { + "name": "Sanic", + "docsPath": "/platforms/python/integrations/sanic/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-serverless": { + "name": "Serverless (Python)", + "docsPath": "/platforms/python/integrations/serverless/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-starlette": { + "name": "Starlette", + "docsPath": "/platforms/python/integrations/starlette/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-tornado": { + "name": "Tornado", + "docsPath": "/platforms/python/integrations/tornado/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-tryton": { + "name": "Tryton", + "docsPath": "/platforms/python/integrations/tryton/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "python-wsgi": { + "name": "WSGI", + "docsPath": "/platforms/python/integrations/wsgi/", + "signals": { + "traces": "/platforms/python/tracing/", + "logs": "/platforms/python/logs/", + "metrics": "/platforms/python/metrics/" + } + }, + "react-native": { + "name": "React Native", + "docsPath": "/platforms/react-native/", + "signals": { + "traces": "/platforms/react-native/tracing/", + "logs": "/platforms/react-native/logs/", + "metrics": "/platforms/react-native/metrics/", + "sessionReplay": "/platforms/react-native/session-replay/" + } + }, + "ruby": { + "name": "Ruby", + "docsPath": "/platforms/ruby/", + "signals": { + "traces": "/platforms/ruby/tracing/", + "logs": "/platforms/ruby/logs/", + "metrics": "/platforms/ruby/metrics/" + } + }, + "ruby-rack": { + "name": "Rack Middleware", + "docsPath": "/platforms/ruby/guides/rack/", + "signals": { + "traces": "/platforms/ruby/guides/rack/tracing/", + "metrics": "/platforms/ruby/guides/rack/metrics/" + } + }, + "ruby-rails": { + "name": "Rails", + "docsPath": "/platforms/ruby/guides/rails/", + "signals": { + "traces": "/platforms/ruby/guides/rails/tracing/", + "logs": "/platforms/ruby/guides/rails/logs/", + "metrics": "/platforms/ruby/guides/rails/metrics/" + } + }, + "rust": { + "name": "Rust", + "docsPath": "/platforms/rust/", + "signals": { + "traces": "/platforms/rust/tracing/", + "logs": "/platforms/rust/logs/", + "metrics": "/platforms/rust/metrics/" + } + }, + "unity": { + "name": "Unity", + "docsPath": "/platforms/unity/", + "signals": { + "traces": "/platforms/unity/tracing/", + "logs": "/platforms/unity/logs/", + "metrics": "/platforms/unity/metrics/" + } + }, + "unreal": { + "name": "Unreal Engine", + "docsPath": "/platforms/unreal/", + "signals": { + "traces": "/platforms/unreal/tracing/", + "logs": "/platforms/unreal/logs/", + "metrics": "/platforms/unreal/metrics/", + "sessionReplay": "/platforms/unreal/session-replay/" + } + }, + "xbox": { + "name": "Xbox", + "docsPath": "/platforms/xbox/", + "signals": {} + } +} diff --git a/packages/mcp-core/src/tools/support/project-setup/project-setup.ts b/packages/mcp-core/src/tools/support/project-setup/project-setup.ts new file mode 100644 index 0000000000..8d17b39943 --- /dev/null +++ b/packages/mcp-core/src/tools/support/project-setup/project-setup.ts @@ -0,0 +1,145 @@ +import { z } from "zod"; +import platforms from "./platforms.json" with { type: "json" }; + +const DOCS_ORIGIN = "https://docs.sentry.io"; + +export const projectSetupSchema = z + .object({ + platform: z.string().describe("Platform display name, such as `Next.js`."), + docsUrl: z.string().describe("Sentry setup guide for the platform."), + signals: z + .array( + z.object({ + name: z.string(), + usefulFor: z.string(), + recommended: z + .literal(true) + .optional() + .describe("Set on signals the SDK's default setup turns on."), + docsUrl: z.string(), + }), + ) + .describe( + "Core signals the platform supports and the organization has enabled.", + ), + }) + .nullable() + .describe("Setup knowledge for the project's platform, or null without one."); + +type ProjectSetup = z.output; + +type PlatformSignalKey = "traces" | "logs" | "metrics" | "sessionReplay"; + +interface PlatformSetupEntry { + name: string; + docsPath: string; + signals: Partial>; +} + +const PLATFORM_SETUP: Readonly> = platforms; + +interface SignalDefinition { + name: string; + usefulFor: string; + recommended: boolean; + /** Organization feature that must be on, as Sentry's onboarding checks it. */ + feature?: string; +} + +// Order is the order the result lists signals in. Errors has no key: every +// platform supports it, and its docs are the platform setup guide. +const SIGNALS: ReadonlyArray<[PlatformSignalKey | "errors", SignalDefinition]> = + [ + [ + "errors", + { + name: "Errors", + usefulFor: "Exceptions and crashes, with stack traces", + recommended: true, + }, + ], + [ + "traces", + { + name: "Traces", + usefulFor: "Following requests, services, and agent runs end to end", + recommended: true, + }, + ], + [ + "logs", + { + name: "Logs", + usefulFor: "App context around failures, linked to traces", + recommended: false, + feature: "ourlogs-enabled", + }, + ], + [ + "metrics", + { + name: "Metrics", + usefulFor: "Tracking and alerting on app and business health", + recommended: false, + feature: "tracemetrics-enabled", + }, + ], + [ + "sessionReplay", + { + name: "Session Replay", + usefulFor: "Seeing what a user did before a bug", + recommended: false, + feature: "session-replay", + }, + ], + ]; + +function docsUrl(path: string): string { + return new URL(path, DOCS_ORIGIN).toString(); +} + +/** + * Builds setup knowledge for a Sentry platform ID: its setup guide and the + * core signals its SDK supports, each with a docs link. + * + * `organizationFeatures` drops signals the organization has not enabled. Pass + * null when the features are unknown, and every supported signal is listed. + * Returns null for a missing or unknown platform. + */ +export function buildProjectSetup( + platform: string | null | undefined, + organizationFeatures: readonly string[] | null, +): ProjectSetup { + const entry = platform ? PLATFORM_SETUP[platform] : undefined; + if (!entry) { + return null; + } + + const signals: NonNullable["signals"] = []; + for (const [key, definition] of SIGNALS) { + const path = key === "errors" ? entry.docsPath : entry.signals[key]; + if (!path) { + continue; + } + if ( + definition.feature && + organizationFeatures && + !organizationFeatures.includes(definition.feature) + ) { + continue; + } + signals.push({ + name: definition.name, + usefulFor: definition.usefulFor, + ...(definition.recommended ? { recommended: true as const } : {}), + docsUrl: docsUrl(path), + }); + } + + return { + platform: entry.name, + docsUrl: docsUrl(entry.docsPath), + signals, + }; +} From 6939abbc15a6d62fcd623020242166f7badd9bac Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 18 Nov 2026 09:12:59 +0000 Subject: [PATCH 2/5] test(mcp): Cover create_project setup fallbacks for missing platforms Co-Authored-By: David Cramer <23610+dcramer@users.noreply.github.com> --- .../src/tools/catalog/create-project.test.ts | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) diff --git a/packages/mcp-core/src/tools/catalog/create-project.test.ts b/packages/mcp-core/src/tools/catalog/create-project.test.ts index 1d918a1339..dc90bec15f 100644 --- a/packages/mcp-core/src/tools/catalog/create-project.test.ts +++ b/packages/mcp-core/src/tools/catalog/create-project.test.ts @@ -438,6 +438,70 @@ describe("create_project", () => { expect(organizationRequested).toBe(false); }); + it("uses the created project's platform when none is passed", async () => { + mswServer.use( + http.post( + "https://sentry.io/api/0/teams/sentry-mcp-evals/the-goats/projects/", + () => + HttpResponse.json({ ...projectFixture, platform: "python-django" }), + ), + ); + + const result = await createProject.handler( + { + organizationSlug: "sentry-mcp-evals", + teamSlug: "the-goats", + name: "cloudflare-mcp", + slug: null, + platform: null, + regionUrl: null, + repository: null, + }, + context, + ); + + const setup = getOutput(result).setup; + expect(setup).toMatchObject({ + platform: "Django", + docsUrl: "https://docs.sentry.io/platforms/python/integrations/django/", + }); + // Integration pages take their signals from the Python SDK page. + expect(setup?.signals.map((signal) => signal.docsUrl)).toEqual([ + "https://docs.sentry.io/platforms/python/integrations/django/", + "https://docs.sentry.io/platforms/python/tracing/", + "https://docs.sentry.io/platforms/python/logs/", + "https://docs.sentry.io/platforms/python/metrics/", + ]); + }); + + it("returns no setup knowledge for a platform without a setup guide", async () => { + mswServer.use( + http.post( + "https://sentry.io/api/0/teams/sentry-mcp-evals/the-goats/projects/", + () => HttpResponse.json({ ...projectFixture, platform: "other" }), + ), + ); + + const result = await createProject.handler( + { + organizationSlug: "sentry-mcp-evals", + teamSlug: "the-goats", + name: "cloudflare-mcp", + slug: null, + platform: "other", + regionUrl: null, + repository: null, + }, + context, + ); + + expect(getOutput(result)).toMatchObject({ + dsn: expect.any(String), + setup: null, + suggestedActions: [], + }); + }); + it("passes an optional slug through project creation", async () => { let createBody: unknown; mswServer.use( From de96842d3ca94b05c6062441e7c458a72d3e3416 Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 18 Nov 2026 16:22:50 +0000 Subject: [PATCH 3/5] fix(mcp): Keep regionUrl in create_project's create_dsn suggestion --- .../src/tools/catalog/create-project.test.ts | 48 +++++++++++++++++++ .../src/tools/catalog/create-project.ts | 1 + 2 files changed, 49 insertions(+) diff --git a/packages/mcp-core/src/tools/catalog/create-project.test.ts b/packages/mcp-core/src/tools/catalog/create-project.test.ts index dc90bec15f..44912fbc32 100644 --- a/packages/mcp-core/src/tools/catalog/create-project.test.ts +++ b/packages/mcp-core/src/tools/catalog/create-project.test.ts @@ -303,6 +303,54 @@ describe("create_project", () => { }); }); + it("keeps the region in the create_dsn suggestion when DSN setup fails", async () => { + mswServer.use( + http.post( + "https://us.sentry.io/api/0/teams/sentry-mcp-evals/the-goats/projects/", + () => HttpResponse.json(projectFixture), + ), + http.get( + "https://us.sentry.io/api/0/projects/sentry-mcp-evals/cloudflare-mcp/keys/", + () => HttpResponse.json({ detail: "lookup failed" }, { status: 500 }), + ), + http.post( + "https://us.sentry.io/api/0/projects/sentry-mcp-evals/cloudflare-mcp/keys/", + () => HttpResponse.json({ detail: "create failed" }, { status: 500 }), + ), + http.get( + "https://us.sentry.io/api/0/organizations/sentry-mcp-evals/", + () => HttpResponse.json(organizationFixture), + ), + ); + + const result = await createProject.handler( + { + organizationSlug: "sentry-mcp-evals", + teamSlug: "the-goats", + name: "cloudflare-mcp", + slug: null, + platform: "node", + regionUrl: "https://us.sentry.io", + repository: null, + }, + context, + ); + + expect(getOutput(result).suggestedActions).toEqual([ + { + type: "tool_call", + toolName: "create_dsn", + arguments: { + organizationSlug: "sentry-mcp-evals", + regionUrl: "https://us.sentry.io", + projectSlug: "cloudflare-mcp", + name: "Default", + }, + reason: "The project was created without a DSN.", + }, + ]); + }); + it("lists only the setup signals the organization has enabled", async () => { mswServer.use( http.post( diff --git a/packages/mcp-core/src/tools/catalog/create-project.ts b/packages/mcp-core/src/tools/catalog/create-project.ts index 6368b0bd25..f0c83862de 100644 --- a/packages/mcp-core/src/tools/catalog/create-project.ts +++ b/packages/mcp-core/src/tools/catalog/create-project.ts @@ -266,6 +266,7 @@ export default defineTool({ toolName: "create_dsn", arguments: { organizationSlug, + ...(params.regionUrl ? { regionUrl: params.regionUrl } : {}), projectSlug: project.slug, name: "Default", }, From 7155424ce8974c1658691b6bcd8c47dcae45c5a5 Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 18 Nov 2026 16:41:57 +0000 Subject: [PATCH 4/5] docs: Drop project-management spec change from this PR The specs are being removed in a separate PR. --- docs/specs/project-management.md | 31 +------------------------------ 1 file changed, 1 insertion(+), 30 deletions(-) diff --git a/docs/specs/project-management.md b/docs/specs/project-management.md index 907be54ab3..caa8a3270e 100644 --- a/docs/specs/project-management.md +++ b/docs/specs/project-management.md @@ -85,36 +85,7 @@ creating the project. Unknown or ambiguous repositories fail before the project is created. After creation, the tool links the repository by creating a root code mapping (`/` to `/`) through Sentry's organization code-mappings endpoint. If linking fails after project creation, the response still includes the project -slug and DSN, with `repository.linked: false`. - -When DSN setup fails, the project still comes back with `dsn: null`, and -`suggestedActions` holds a `create_dsn` call for it. Otherwise -`suggestedActions` is empty. - -### Setup Knowledge - -The response includes `setup` for the project's platform, or `null` when the -project has no platform or the platform has no Sentry setup guide: - -- `platform`: display name, such as `Next.js`. -- `docsUrl`: the platform's setup guide on docs.sentry.io. -- `signals`: the core signals the platform supports, in this order: Errors, - Traces, Logs, Metrics, and Session Replay. Each has a `name`, a one-line - `usefulFor`, and its `docsUrl`. Errors and Traces set `recommended: true`, - because the SDK's default setup turns them on. - -Signals the organization has not enabled are left out, using the organization -features Sentry's own onboarding checks: `ourlogs-enabled` for Logs, -`tracemetrics-enabled` for Metrics, and `session-replay` for Session Replay. -The features lookup is best effort. When it fails, `signals` lists everything -the platform supports. - -Which signals each platform supports, and their docs pages, come from -`packages/mcp-core/src/tools/support/project-setup/platforms.json`. Regenerate -it with `pnpm --filter @sentry/mcp-core run generate-platform-setup`, which reads -Sentry's platform list (`static/app/data/platforms.tsx` in getsentry/sentry) and -the published docs tree (`https://docs.sentry.io/doctree.json`). A platform -supports a signal when its docs page has that signal's child page. +slug and DSN and notes that the repository must be linked manually. ## Metadata Updates From 192f1c9a5a0a9e354073ba86e1a537ba8233a9c6 Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 18 Nov 2026 17:00:38 +0000 Subject: [PATCH 5/5] feat(mcp): Sharpen setup signal descriptions and store full docs URLs Rewrite each signal's usefulFor so an agent can judge whether it fits the app, and expand Session Replay to cover understanding user behavior in web and mobile UIs. The generator now writes absolute docs.sentry.io URLs, so platforms.json and the runtime no longer join relative paths. --- .../scripts/generate-platform-setup.ts | 6 +- .../src/tools/catalog/create-project.test.ts | 16 +- .../support/project-setup/platforms.json | 882 +++++++++--------- .../support/project-setup/project-setup.ts | 31 +- 4 files changed, 467 insertions(+), 468 deletions(-) diff --git a/packages/mcp-core/scripts/generate-platform-setup.ts b/packages/mcp-core/scripts/generate-platform-setup.ts index 2035bd9234..0f4b81d908 100644 --- a/packages/mcp-core/scripts/generate-platform-setup.ts +++ b/packages/mcp-core/scripts/generate-platform-setup.ts @@ -84,7 +84,7 @@ interface PlatformEntry { interface PlatformSetupEntry { name: string; - docsPath: string; + docsUrl: string; signals: Partial>; } @@ -221,12 +221,12 @@ async function main() { string, ][]) { if (source && childSlugs.has(slug)) { - signals[key] = `/${normalizePath(source.path)}/${slug}/`; + signals[key] = `${DOCS_ORIGIN}/${normalizePath(source.path)}/${slug}/`; } } output[platform.id] = { name: platform.name, - docsPath: `/${path}/`, + docsUrl: `${DOCS_ORIGIN}/${path}/`, signals, }; } diff --git a/packages/mcp-core/src/tools/catalog/create-project.test.ts b/packages/mcp-core/src/tools/catalog/create-project.test.ts index 44912fbc32..3da2813548 100644 --- a/packages/mcp-core/src/tools/catalog/create-project.test.ts +++ b/packages/mcp-core/src/tools/catalog/create-project.test.ts @@ -74,23 +74,23 @@ describe("create_project", () => { "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/", "name": "Errors", "recommended": true, - "usefulFor": "Exceptions and crashes, with stack traces", + "usefulFor": "Unhandled exceptions and crashes, grouped into issues with stack traces and the state that led to them", }, { "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/tracing/", "name": "Traces", "recommended": true, - "usefulFor": "Following requests, services, and agent runs end to end", + "usefulFor": "Debugging how requests, background jobs, and AI agent runs flow across services, and where they fail or slow down", }, { "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/logs/", "name": "Logs", - "usefulFor": "App context around failures, linked to traces", + "usefulFor": "Structured app logs linked to the trace and error they came from, for context a stack trace lacks", }, { "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/metrics/", "name": "Metrics", - "usefulFor": "Tracking and alerting on app and business health", + "usefulFor": "Counters, gauges, and distributions to chart and alert on, such as signups, queue depth, or token usage", }, ], }, @@ -397,23 +397,23 @@ describe("create_project", () => { "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/", "name": "Errors", "recommended": true, - "usefulFor": "Exceptions and crashes, with stack traces", + "usefulFor": "Unhandled exceptions and crashes, grouped into issues with stack traces and the state that led to them", }, { "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/tracing/", "name": "Traces", "recommended": true, - "usefulFor": "Following requests, services, and agent runs end to end", + "usefulFor": "Debugging how requests, background jobs, and AI agent runs flow across services, and where they fail or slow down", }, { "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/logs/", "name": "Logs", - "usefulFor": "App context around failures, linked to traces", + "usefulFor": "Structured app logs linked to the trace and error they came from, for context a stack trace lacks", }, { "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/session-replay/", "name": "Session Replay", - "usefulFor": "Seeing what a user did before a bug", + "usefulFor": "Understanding how users behave in a web or mobile UI: clicks, navigation, network calls, and errors in a replay, to reproduce bugs and find friction", }, ], } diff --git a/packages/mcp-core/src/tools/support/project-setup/platforms.json b/packages/mcp-core/src/tools/support/project-setup/platforms.json index de67ef4bed..43f4f2c92c 100644 --- a/packages/mcp-core/src/tools/support/project-setup/platforms.json +++ b/packages/mcp-core/src/tools/support/project-setup/platforms.json @@ -1,989 +1,989 @@ { "android": { "name": "Android", - "docsPath": "/platforms/android/", + "docsUrl": "https://docs.sentry.io/platforms/android/", "signals": { - "traces": "/platforms/android/tracing/", - "logs": "/platforms/android/logs/", - "metrics": "/platforms/android/metrics/", - "sessionReplay": "/platforms/android/session-replay/" + "traces": "https://docs.sentry.io/platforms/android/tracing/", + "logs": "https://docs.sentry.io/platforms/android/logs/", + "metrics": "https://docs.sentry.io/platforms/android/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/android/session-replay/" } }, "apple": { "name": "Apple", - "docsPath": "/platforms/apple/", + "docsUrl": "https://docs.sentry.io/platforms/apple/", "signals": { - "traces": "/platforms/apple/tracing/", - "logs": "/platforms/apple/logs/", - "metrics": "/platforms/apple/metrics/", - "sessionReplay": "/platforms/apple/session-replay/" + "traces": "https://docs.sentry.io/platforms/apple/tracing/", + "logs": "https://docs.sentry.io/platforms/apple/logs/", + "metrics": "https://docs.sentry.io/platforms/apple/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/apple/session-replay/" } }, "apple-ios": { "name": "iOS", - "docsPath": "/platforms/apple/guides/ios/", + "docsUrl": "https://docs.sentry.io/platforms/apple/guides/ios/", "signals": { - "traces": "/platforms/apple/guides/ios/tracing/", - "logs": "/platforms/apple/guides/ios/logs/", - "metrics": "/platforms/apple/guides/ios/metrics/", - "sessionReplay": "/platforms/apple/guides/ios/session-replay/" + "traces": "https://docs.sentry.io/platforms/apple/guides/ios/tracing/", + "logs": "https://docs.sentry.io/platforms/apple/guides/ios/logs/", + "metrics": "https://docs.sentry.io/platforms/apple/guides/ios/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/apple/guides/ios/session-replay/" } }, "apple-macos": { "name": "macOS", - "docsPath": "/platforms/apple/guides/macos/", + "docsUrl": "https://docs.sentry.io/platforms/apple/guides/macos/", "signals": { - "traces": "/platforms/apple/guides/macos/tracing/", - "logs": "/platforms/apple/guides/macos/logs/", - "metrics": "/platforms/apple/guides/macos/metrics/", - "sessionReplay": "/platforms/apple/guides/macos/session-replay/" + "traces": "https://docs.sentry.io/platforms/apple/guides/macos/tracing/", + "logs": "https://docs.sentry.io/platforms/apple/guides/macos/logs/", + "metrics": "https://docs.sentry.io/platforms/apple/guides/macos/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/apple/guides/macos/session-replay/" } }, "bun": { "name": "Bun", - "docsPath": "/platforms/javascript/guides/bun/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/bun/", "signals": { - "traces": "/platforms/javascript/guides/bun/tracing/", - "logs": "/platforms/javascript/guides/bun/logs/", - "metrics": "/platforms/javascript/guides/bun/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/bun/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/bun/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/bun/metrics/" } }, "capacitor": { "name": "Capacitor", - "docsPath": "/platforms/javascript/guides/capacitor/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/capacitor/", "signals": { - "traces": "/platforms/javascript/guides/capacitor/tracing/", - "logs": "/platforms/javascript/guides/capacitor/logs/", - "sessionReplay": "/platforms/javascript/guides/capacitor/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/capacitor/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/capacitor/logs/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/capacitor/session-replay/" } }, "cordova": { "name": "Cordova", - "docsPath": "/platforms/javascript/guides/cordova/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/cordova/", "signals": { - "traces": "/platforms/javascript/guides/cordova/tracing/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/cordova/tracing/" } }, "dart": { "name": "Dart", - "docsPath": "/platforms/dart/", + "docsUrl": "https://docs.sentry.io/platforms/dart/", "signals": { - "traces": "/platforms/dart/tracing/", - "logs": "/platforms/dart/logs/", - "metrics": "/platforms/dart/metrics/" + "traces": "https://docs.sentry.io/platforms/dart/tracing/", + "logs": "https://docs.sentry.io/platforms/dart/logs/", + "metrics": "https://docs.sentry.io/platforms/dart/metrics/" } }, "deno": { "name": "Deno", - "docsPath": "/platforms/javascript/guides/deno/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/deno/", "signals": { - "traces": "/platforms/javascript/guides/deno/tracing/", - "logs": "/platforms/javascript/guides/deno/logs/", - "metrics": "/platforms/javascript/guides/deno/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/deno/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/deno/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/deno/metrics/" } }, "dotnet": { "name": ".NET", - "docsPath": "/platforms/dotnet/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/", "signals": { - "traces": "/platforms/dotnet/tracing/", - "logs": "/platforms/dotnet/logs/", - "metrics": "/platforms/dotnet/metrics/" + "traces": "https://docs.sentry.io/platforms/dotnet/tracing/", + "logs": "https://docs.sentry.io/platforms/dotnet/logs/", + "metrics": "https://docs.sentry.io/platforms/dotnet/metrics/" } }, "dotnet-aspnet": { "name": "ASP.NET", - "docsPath": "/platforms/dotnet/guides/aspnet/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/guides/aspnet/", "signals": { - "traces": "/platforms/dotnet/guides/aspnet/tracing/", - "logs": "/platforms/dotnet/guides/aspnet/logs/", - "metrics": "/platforms/dotnet/guides/aspnet/metrics/" + "traces": "https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/", + "logs": "https://docs.sentry.io/platforms/dotnet/guides/aspnet/logs/", + "metrics": "https://docs.sentry.io/platforms/dotnet/guides/aspnet/metrics/" } }, "dotnet-aspnetcore": { "name": "ASP.NET Core", - "docsPath": "/platforms/dotnet/guides/aspnetcore/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/guides/aspnetcore/", "signals": { - "traces": "/platforms/dotnet/guides/aspnetcore/tracing/", - "logs": "/platforms/dotnet/guides/aspnetcore/logs/", - "metrics": "/platforms/dotnet/guides/aspnetcore/metrics/" + "traces": "https://docs.sentry.io/platforms/dotnet/guides/aspnetcore/tracing/", + "logs": "https://docs.sentry.io/platforms/dotnet/guides/aspnetcore/logs/", + "metrics": "https://docs.sentry.io/platforms/dotnet/guides/aspnetcore/metrics/" } }, "dotnet-awslambda": { "name": "AWS Lambda (.NET)", - "docsPath": "/platforms/dotnet/guides/aws-lambda/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/guides/aws-lambda/", "signals": { - "traces": "/platforms/dotnet/guides/aws-lambda/tracing/", - "logs": "/platforms/dotnet/guides/aws-lambda/logs/", - "metrics": "/platforms/dotnet/guides/aws-lambda/metrics/" + "traces": "https://docs.sentry.io/platforms/dotnet/guides/aws-lambda/tracing/", + "logs": "https://docs.sentry.io/platforms/dotnet/guides/aws-lambda/logs/", + "metrics": "https://docs.sentry.io/platforms/dotnet/guides/aws-lambda/metrics/" } }, "dotnet-gcpfunctions": { "name": "Google Cloud Functions (.NET)", - "docsPath": "/platforms/dotnet/guides/google-cloud-functions/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/guides/google-cloud-functions/", "signals": { - "traces": "/platforms/dotnet/guides/google-cloud-functions/tracing/", - "metrics": "/platforms/dotnet/guides/google-cloud-functions/metrics/" + "traces": "https://docs.sentry.io/platforms/dotnet/guides/google-cloud-functions/tracing/", + "metrics": "https://docs.sentry.io/platforms/dotnet/guides/google-cloud-functions/metrics/" } }, "dotnet-maui": { "name": ".NET MAUI", - "docsPath": "/platforms/dotnet/guides/maui/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/guides/maui/", "signals": { - "traces": "/platforms/dotnet/guides/maui/tracing/", - "logs": "/platforms/dotnet/guides/maui/logs/", - "metrics": "/platforms/dotnet/guides/maui/metrics/" + "traces": "https://docs.sentry.io/platforms/dotnet/guides/maui/tracing/", + "logs": "https://docs.sentry.io/platforms/dotnet/guides/maui/logs/", + "metrics": "https://docs.sentry.io/platforms/dotnet/guides/maui/metrics/" } }, "dotnet-winforms": { "name": "Windows Forms", - "docsPath": "/platforms/dotnet/guides/winforms/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/guides/winforms/", "signals": { - "traces": "/platforms/dotnet/guides/winforms/tracing/", - "logs": "/platforms/dotnet/guides/winforms/logs/", - "metrics": "/platforms/dotnet/guides/winforms/metrics/" + "traces": "https://docs.sentry.io/platforms/dotnet/guides/winforms/tracing/", + "logs": "https://docs.sentry.io/platforms/dotnet/guides/winforms/logs/", + "metrics": "https://docs.sentry.io/platforms/dotnet/guides/winforms/metrics/" } }, "dotnet-wpf": { "name": "WPF", - "docsPath": "/platforms/dotnet/guides/wpf/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/guides/wpf/", "signals": { - "traces": "/platforms/dotnet/guides/wpf/tracing/", - "logs": "/platforms/dotnet/guides/wpf/logs/", - "metrics": "/platforms/dotnet/guides/wpf/metrics/" + "traces": "https://docs.sentry.io/platforms/dotnet/guides/wpf/tracing/", + "logs": "https://docs.sentry.io/platforms/dotnet/guides/wpf/logs/", + "metrics": "https://docs.sentry.io/platforms/dotnet/guides/wpf/metrics/" } }, "dotnet-xamarin": { "name": "Xamarin", - "docsPath": "/platforms/dotnet/guides/xamarin/", + "docsUrl": "https://docs.sentry.io/platforms/dotnet/guides/xamarin/", "signals": { - "traces": "/platforms/dotnet/guides/xamarin/tracing/" + "traces": "https://docs.sentry.io/platforms/dotnet/guides/xamarin/tracing/" } }, "electron": { "name": "Electron", - "docsPath": "/platforms/javascript/guides/electron/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/electron/", "signals": { - "traces": "/platforms/javascript/guides/electron/tracing/", - "logs": "/platforms/javascript/guides/electron/logs/", - "metrics": "/platforms/javascript/guides/electron/metrics/", - "sessionReplay": "/platforms/javascript/guides/electron/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/electron/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/electron/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/electron/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/electron/session-replay/" } }, "elixir": { "name": "Elixir", - "docsPath": "/platforms/elixir/", + "docsUrl": "https://docs.sentry.io/platforms/elixir/", "signals": { - "traces": "/platforms/elixir/tracing/", - "logs": "/platforms/elixir/logs/", - "metrics": "/platforms/elixir/metrics/" + "traces": "https://docs.sentry.io/platforms/elixir/tracing/", + "logs": "https://docs.sentry.io/platforms/elixir/logs/", + "metrics": "https://docs.sentry.io/platforms/elixir/metrics/" } }, "expo": { "name": "Expo", - "docsPath": "/platforms/react-native/guides/expo/", + "docsUrl": "https://docs.sentry.io/platforms/react-native/guides/expo/", "signals": { - "traces": "/platforms/react-native/guides/expo/tracing/", - "logs": "/platforms/react-native/guides/expo/logs/", - "metrics": "/platforms/react-native/guides/expo/metrics/", - "sessionReplay": "/platforms/react-native/guides/expo/session-replay/" + "traces": "https://docs.sentry.io/platforms/react-native/guides/expo/tracing/", + "logs": "https://docs.sentry.io/platforms/react-native/guides/expo/logs/", + "metrics": "https://docs.sentry.io/platforms/react-native/guides/expo/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/react-native/guides/expo/session-replay/" } }, "flutter": { "name": "Flutter", - "docsPath": "/platforms/dart/guides/flutter/", + "docsUrl": "https://docs.sentry.io/platforms/dart/guides/flutter/", "signals": { - "traces": "/platforms/dart/guides/flutter/tracing/", - "logs": "/platforms/dart/guides/flutter/logs/", - "metrics": "/platforms/dart/guides/flutter/metrics/", - "sessionReplay": "/platforms/dart/guides/flutter/session-replay/" + "traces": "https://docs.sentry.io/platforms/dart/guides/flutter/tracing/", + "logs": "https://docs.sentry.io/platforms/dart/guides/flutter/logs/", + "metrics": "https://docs.sentry.io/platforms/dart/guides/flutter/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/dart/guides/flutter/session-replay/" } }, "go": { "name": "Go", - "docsPath": "/platforms/go/", + "docsUrl": "https://docs.sentry.io/platforms/go/", "signals": { - "traces": "/platforms/go/tracing/", - "logs": "/platforms/go/logs/", - "metrics": "/platforms/go/metrics/" + "traces": "https://docs.sentry.io/platforms/go/tracing/", + "logs": "https://docs.sentry.io/platforms/go/logs/", + "metrics": "https://docs.sentry.io/platforms/go/metrics/" } }, "go-echo": { "name": "Echo", - "docsPath": "/platforms/go/guides/echo/", + "docsUrl": "https://docs.sentry.io/platforms/go/guides/echo/", "signals": { - "traces": "/platforms/go/guides/echo/tracing/", - "logs": "/platforms/go/guides/echo/logs/", - "metrics": "/platforms/go/guides/echo/metrics/" + "traces": "https://docs.sentry.io/platforms/go/guides/echo/tracing/", + "logs": "https://docs.sentry.io/platforms/go/guides/echo/logs/", + "metrics": "https://docs.sentry.io/platforms/go/guides/echo/metrics/" } }, "go-fasthttp": { "name": "FastHTTP", - "docsPath": "/platforms/go/guides/fasthttp/", + "docsUrl": "https://docs.sentry.io/platforms/go/guides/fasthttp/", "signals": { - "traces": "/platforms/go/guides/fasthttp/tracing/", - "logs": "/platforms/go/guides/fasthttp/logs/", - "metrics": "/platforms/go/guides/fasthttp/metrics/" + "traces": "https://docs.sentry.io/platforms/go/guides/fasthttp/tracing/", + "logs": "https://docs.sentry.io/platforms/go/guides/fasthttp/logs/", + "metrics": "https://docs.sentry.io/platforms/go/guides/fasthttp/metrics/" } }, "go-fiber": { "name": "Fiber", - "docsPath": "/platforms/go/guides/fiber/", + "docsUrl": "https://docs.sentry.io/platforms/go/guides/fiber/", "signals": { - "traces": "/platforms/go/guides/fiber/tracing/", - "logs": "/platforms/go/guides/fiber/logs/", - "metrics": "/platforms/go/guides/fiber/metrics/" + "traces": "https://docs.sentry.io/platforms/go/guides/fiber/tracing/", + "logs": "https://docs.sentry.io/platforms/go/guides/fiber/logs/", + "metrics": "https://docs.sentry.io/platforms/go/guides/fiber/metrics/" } }, "go-gin": { "name": "Gin", - "docsPath": "/platforms/go/guides/gin/", + "docsUrl": "https://docs.sentry.io/platforms/go/guides/gin/", "signals": { - "traces": "/platforms/go/guides/gin/tracing/", - "logs": "/platforms/go/guides/gin/logs/", - "metrics": "/platforms/go/guides/gin/metrics/" + "traces": "https://docs.sentry.io/platforms/go/guides/gin/tracing/", + "logs": "https://docs.sentry.io/platforms/go/guides/gin/logs/", + "metrics": "https://docs.sentry.io/platforms/go/guides/gin/metrics/" } }, "go-http": { "name": "Net/Http", - "docsPath": "/platforms/go/guides/http/", + "docsUrl": "https://docs.sentry.io/platforms/go/guides/http/", "signals": { - "traces": "/platforms/go/guides/http/tracing/", - "logs": "/platforms/go/guides/http/logs/", - "metrics": "/platforms/go/guides/http/metrics/" + "traces": "https://docs.sentry.io/platforms/go/guides/http/tracing/", + "logs": "https://docs.sentry.io/platforms/go/guides/http/logs/", + "metrics": "https://docs.sentry.io/platforms/go/guides/http/metrics/" } }, "go-iris": { "name": "Iris", - "docsPath": "/platforms/go/guides/iris/", + "docsUrl": "https://docs.sentry.io/platforms/go/guides/iris/", "signals": { - "traces": "/platforms/go/guides/iris/tracing/", - "logs": "/platforms/go/guides/iris/logs/", - "metrics": "/platforms/go/guides/iris/metrics/" + "traces": "https://docs.sentry.io/platforms/go/guides/iris/tracing/", + "logs": "https://docs.sentry.io/platforms/go/guides/iris/logs/", + "metrics": "https://docs.sentry.io/platforms/go/guides/iris/metrics/" } }, "go-negroni": { "name": "Negroni", - "docsPath": "/platforms/go/guides/negroni/", + "docsUrl": "https://docs.sentry.io/platforms/go/guides/negroni/", "signals": { - "traces": "/platforms/go/guides/negroni/tracing/", - "logs": "/platforms/go/guides/negroni/logs/", - "metrics": "/platforms/go/guides/negroni/metrics/" + "traces": "https://docs.sentry.io/platforms/go/guides/negroni/tracing/", + "logs": "https://docs.sentry.io/platforms/go/guides/negroni/logs/", + "metrics": "https://docs.sentry.io/platforms/go/guides/negroni/metrics/" } }, "godot": { "name": "Godot", - "docsPath": "/platforms/godot/", + "docsUrl": "https://docs.sentry.io/platforms/godot/", "signals": { - "traces": "/platforms/godot/tracing/", - "logs": "/platforms/godot/logs/", - "metrics": "/platforms/godot/metrics/" + "traces": "https://docs.sentry.io/platforms/godot/tracing/", + "logs": "https://docs.sentry.io/platforms/godot/logs/", + "metrics": "https://docs.sentry.io/platforms/godot/metrics/" } }, "ionic": { "name": "Ionic", - "docsPath": "/platforms/javascript/guides/capacitor/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/capacitor/", "signals": { - "traces": "/platforms/javascript/guides/capacitor/tracing/", - "logs": "/platforms/javascript/guides/capacitor/logs/", - "sessionReplay": "/platforms/javascript/guides/capacitor/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/capacitor/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/capacitor/logs/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/capacitor/session-replay/" } }, "java": { "name": "Java", - "docsPath": "/platforms/java/", + "docsUrl": "https://docs.sentry.io/platforms/java/", "signals": { - "traces": "/platforms/java/tracing/", - "logs": "/platforms/java/logs/", - "metrics": "/platforms/java/metrics/" + "traces": "https://docs.sentry.io/platforms/java/tracing/", + "logs": "https://docs.sentry.io/platforms/java/logs/", + "metrics": "https://docs.sentry.io/platforms/java/metrics/" } }, "java-log4j2": { "name": "Log4j 2.x", - "docsPath": "/platforms/java/guides/log4j2/", + "docsUrl": "https://docs.sentry.io/platforms/java/guides/log4j2/", "signals": { - "traces": "/platforms/java/guides/log4j2/tracing/", - "logs": "/platforms/java/guides/log4j2/logs/", - "metrics": "/platforms/java/guides/log4j2/metrics/" + "traces": "https://docs.sentry.io/platforms/java/guides/log4j2/tracing/", + "logs": "https://docs.sentry.io/platforms/java/guides/log4j2/logs/", + "metrics": "https://docs.sentry.io/platforms/java/guides/log4j2/metrics/" } }, "java-logback": { "name": "Logback", - "docsPath": "/platforms/java/guides/logback/", + "docsUrl": "https://docs.sentry.io/platforms/java/guides/logback/", "signals": { - "traces": "/platforms/java/guides/logback/tracing/", - "logs": "/platforms/java/guides/logback/logs/", - "metrics": "/platforms/java/guides/logback/metrics/" + "traces": "https://docs.sentry.io/platforms/java/guides/logback/tracing/", + "logs": "https://docs.sentry.io/platforms/java/guides/logback/logs/", + "metrics": "https://docs.sentry.io/platforms/java/guides/logback/metrics/" } }, "java-spring": { "name": "Spring", - "docsPath": "/platforms/java/guides/spring/", + "docsUrl": "https://docs.sentry.io/platforms/java/guides/spring/", "signals": { - "traces": "/platforms/java/guides/spring/tracing/", - "logs": "/platforms/java/guides/spring/logs/", - "metrics": "/platforms/java/guides/spring/metrics/" + "traces": "https://docs.sentry.io/platforms/java/guides/spring/tracing/", + "logs": "https://docs.sentry.io/platforms/java/guides/spring/logs/", + "metrics": "https://docs.sentry.io/platforms/java/guides/spring/metrics/" } }, "java-spring-boot": { "name": "Spring Boot", - "docsPath": "/platforms/java/guides/spring-boot/", + "docsUrl": "https://docs.sentry.io/platforms/java/guides/spring-boot/", "signals": { - "traces": "/platforms/java/guides/spring-boot/tracing/", - "logs": "/platforms/java/guides/spring-boot/logs/", - "metrics": "/platforms/java/guides/spring-boot/metrics/" + "traces": "https://docs.sentry.io/platforms/java/guides/spring-boot/tracing/", + "logs": "https://docs.sentry.io/platforms/java/guides/spring-boot/logs/", + "metrics": "https://docs.sentry.io/platforms/java/guides/spring-boot/metrics/" } }, "javascript": { "name": "Browser JavaScript", - "docsPath": "/platforms/javascript/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/", "signals": { - "traces": "/platforms/javascript/tracing/", - "logs": "/platforms/javascript/logs/", - "metrics": "/platforms/javascript/metrics/", - "sessionReplay": "/platforms/javascript/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/session-replay/" } }, "javascript-angular": { "name": "Angular", - "docsPath": "/platforms/javascript/guides/angular/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/angular/", "signals": { - "traces": "/platforms/javascript/guides/angular/tracing/", - "logs": "/platforms/javascript/guides/angular/logs/", - "metrics": "/platforms/javascript/guides/angular/metrics/", - "sessionReplay": "/platforms/javascript/guides/angular/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/angular/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/angular/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/angular/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/angular/session-replay/" } }, "javascript-astro": { "name": "Astro", - "docsPath": "/platforms/javascript/guides/astro/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/astro/", "signals": { - "traces": "/platforms/javascript/guides/astro/tracing/", - "logs": "/platforms/javascript/guides/astro/logs/", - "metrics": "/platforms/javascript/guides/astro/metrics/", - "sessionReplay": "/platforms/javascript/guides/astro/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/astro/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/astro/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/astro/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/astro/session-replay/" } }, "javascript-ember": { "name": "Ember", - "docsPath": "/platforms/javascript/guides/ember/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/ember/", "signals": { - "traces": "/platforms/javascript/guides/ember/tracing/", - "logs": "/platforms/javascript/guides/ember/logs/", - "metrics": "/platforms/javascript/guides/ember/metrics/", - "sessionReplay": "/platforms/javascript/guides/ember/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/ember/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/ember/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/ember/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/ember/session-replay/" } }, "javascript-gatsby": { "name": "Gatsby", - "docsPath": "/platforms/javascript/guides/gatsby/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/gatsby/", "signals": { - "traces": "/platforms/javascript/guides/gatsby/tracing/", - "logs": "/platforms/javascript/guides/gatsby/logs/", - "metrics": "/platforms/javascript/guides/gatsby/metrics/", - "sessionReplay": "/platforms/javascript/guides/gatsby/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/gatsby/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/gatsby/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/gatsby/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/gatsby/session-replay/" } }, "javascript-nextjs": { "name": "Next.js", - "docsPath": "/platforms/javascript/guides/nextjs/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nextjs/", "signals": { - "traces": "/platforms/javascript/guides/nextjs/tracing/", - "logs": "/platforms/javascript/guides/nextjs/logs/", - "metrics": "/platforms/javascript/guides/nextjs/metrics/", - "sessionReplay": "/platforms/javascript/guides/nextjs/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/nextjs/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/nextjs/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/nextjs/session-replay/" } }, "javascript-react": { "name": "React", - "docsPath": "/platforms/javascript/guides/react/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/react/", "signals": { - "traces": "/platforms/javascript/guides/react/tracing/", - "logs": "/platforms/javascript/guides/react/logs/", - "metrics": "/platforms/javascript/guides/react/metrics/", - "sessionReplay": "/platforms/javascript/guides/react/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/react/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/react/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/react/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/react/session-replay/" } }, "javascript-react-router": { "name": "React Router Framework", - "docsPath": "/platforms/javascript/guides/react-router/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/react-router/", "signals": { - "traces": "/platforms/javascript/guides/react-router/tracing/", - "logs": "/platforms/javascript/guides/react-router/logs/", - "metrics": "/platforms/javascript/guides/react-router/metrics/", - "sessionReplay": "/platforms/javascript/guides/react-router/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/react-router/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/react-router/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/react-router/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/react-router/session-replay/" } }, "javascript-remix": { "name": "Remix", - "docsPath": "/platforms/javascript/guides/remix/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/remix/", "signals": { - "traces": "/platforms/javascript/guides/remix/tracing/", - "logs": "/platforms/javascript/guides/remix/logs/", - "metrics": "/platforms/javascript/guides/remix/metrics/", - "sessionReplay": "/platforms/javascript/guides/remix/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/remix/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/remix/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/remix/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/remix/session-replay/" } }, "javascript-solid": { "name": "Solid", - "docsPath": "/platforms/javascript/guides/solid/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/solid/", "signals": { - "traces": "/platforms/javascript/guides/solid/tracing/", - "logs": "/platforms/javascript/guides/solid/logs/", - "metrics": "/platforms/javascript/guides/solid/metrics/", - "sessionReplay": "/platforms/javascript/guides/solid/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/solid/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/solid/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/solid/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/solid/session-replay/" } }, "javascript-solidstart": { "name": "SolidStart", - "docsPath": "/platforms/javascript/guides/solidstart/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/solidstart/", "signals": { - "traces": "/platforms/javascript/guides/solidstart/tracing/", - "logs": "/platforms/javascript/guides/solidstart/logs/", - "metrics": "/platforms/javascript/guides/solidstart/metrics/", - "sessionReplay": "/platforms/javascript/guides/solidstart/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/solidstart/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/solidstart/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/solidstart/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/solidstart/session-replay/" } }, "javascript-svelte": { "name": "Svelte", - "docsPath": "/platforms/javascript/guides/svelte/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/svelte/", "signals": { - "traces": "/platforms/javascript/guides/svelte/tracing/", - "logs": "/platforms/javascript/guides/svelte/logs/", - "metrics": "/platforms/javascript/guides/svelte/metrics/", - "sessionReplay": "/platforms/javascript/guides/svelte/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/svelte/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/svelte/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/svelte/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/svelte/session-replay/" } }, "javascript-sveltekit": { "name": "SvelteKit", - "docsPath": "/platforms/javascript/guides/sveltekit/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/sveltekit/", "signals": { - "traces": "/platforms/javascript/guides/sveltekit/tracing/", - "logs": "/platforms/javascript/guides/sveltekit/logs/", - "metrics": "/platforms/javascript/guides/sveltekit/metrics/", - "sessionReplay": "/platforms/javascript/guides/sveltekit/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/sveltekit/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/sveltekit/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/sveltekit/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/sveltekit/session-replay/" } }, "javascript-tanstackstart-react": { "name": "TanStack Start React", - "docsPath": "/platforms/javascript/guides/tanstackstart-react/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/tanstackstart-react/", "signals": { - "traces": "/platforms/javascript/guides/tanstackstart-react/tracing/", - "logs": "/platforms/javascript/guides/tanstackstart-react/logs/", - "metrics": "/platforms/javascript/guides/tanstackstart-react/metrics/", - "sessionReplay": "/platforms/javascript/guides/tanstackstart-react/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/tanstackstart-react/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/tanstackstart-react/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/tanstackstart-react/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/tanstackstart-react/session-replay/" } }, "javascript-vue": { "name": "Vue", - "docsPath": "/platforms/javascript/guides/vue/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/vue/", "signals": { - "traces": "/platforms/javascript/guides/vue/tracing/", - "logs": "/platforms/javascript/guides/vue/logs/", - "metrics": "/platforms/javascript/guides/vue/metrics/", - "sessionReplay": "/platforms/javascript/guides/vue/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/vue/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/vue/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/vue/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/vue/session-replay/" } }, "javascript-nuxt": { "name": "Nuxt", - "docsPath": "/platforms/javascript/guides/nuxt/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nuxt/", "signals": { - "traces": "/platforms/javascript/guides/nuxt/tracing/", - "logs": "/platforms/javascript/guides/nuxt/logs/", - "metrics": "/platforms/javascript/guides/nuxt/metrics/", - "sessionReplay": "/platforms/javascript/guides/nuxt/session-replay/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/nuxt/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/nuxt/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/nuxt/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/javascript/guides/nuxt/session-replay/" } }, "kotlin": { "name": "Kotlin", - "docsPath": "/platforms/kotlin/", + "docsUrl": "https://docs.sentry.io/platforms/kotlin/", "signals": {} }, "minidump": { "name": "Minidump", - "docsPath": "/platforms/native/guides/minidumps/", + "docsUrl": "https://docs.sentry.io/platforms/native/guides/minidumps/", "signals": { - "traces": "/platforms/native/guides/minidumps/tracing/" + "traces": "https://docs.sentry.io/platforms/native/guides/minidumps/tracing/" } }, "native": { "name": "Native", - "docsPath": "/platforms/native/", + "docsUrl": "https://docs.sentry.io/platforms/native/", "signals": { - "traces": "/platforms/native/tracing/", - "logs": "/platforms/native/logs/", - "metrics": "/platforms/native/metrics/" + "traces": "https://docs.sentry.io/platforms/native/tracing/", + "logs": "https://docs.sentry.io/platforms/native/logs/", + "metrics": "https://docs.sentry.io/platforms/native/metrics/" } }, "native-qt": { "name": "Qt", - "docsPath": "/platforms/native/guides/qt/", + "docsUrl": "https://docs.sentry.io/platforms/native/guides/qt/", "signals": { - "traces": "/platforms/native/guides/qt/tracing/" + "traces": "https://docs.sentry.io/platforms/native/guides/qt/tracing/" } }, "nintendo-switch": { "name": "Nintendo Switch", - "docsPath": "/platforms/nintendo-switch/", + "docsUrl": "https://docs.sentry.io/platforms/nintendo-switch/", "signals": {} }, "node": { "name": "Node.js", - "docsPath": "/platforms/javascript/guides/node/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/", "signals": { - "traces": "/platforms/javascript/guides/node/tracing/", - "logs": "/platforms/javascript/guides/node/logs/", - "metrics": "/platforms/javascript/guides/node/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/node/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/node/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/node/metrics/" } }, "node-awslambda": { "name": "AWS Lambda (Node)", - "docsPath": "/platforms/javascript/guides/aws-lambda/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/aws-lambda/", "signals": { - "traces": "/platforms/javascript/guides/aws-lambda/tracing/", - "logs": "/platforms/javascript/guides/aws-lambda/logs/", - "metrics": "/platforms/javascript/guides/aws-lambda/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/aws-lambda/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/aws-lambda/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/aws-lambda/metrics/" } }, "node-azurefunctions": { "name": "Azure Functions (Node)", - "docsPath": "/platforms/javascript/guides/azure-functions/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/azure-functions/", "signals": { - "traces": "/platforms/javascript/guides/azure-functions/tracing/", - "logs": "/platforms/javascript/guides/azure-functions/logs/", - "metrics": "/platforms/javascript/guides/azure-functions/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/azure-functions/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/azure-functions/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/azure-functions/metrics/" } }, "node-cloudflare-pages": { "name": "Cloudflare (Node)", - "docsPath": "/platforms/javascript/guides/cloudflare/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/cloudflare/", "signals": { - "traces": "/platforms/javascript/guides/cloudflare/tracing/", - "logs": "/platforms/javascript/guides/cloudflare/logs/", - "metrics": "/platforms/javascript/guides/cloudflare/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/cloudflare/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/cloudflare/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/cloudflare/metrics/" } }, "node-cloudflare-workers": { "name": "Cloudflare (Node)", - "docsPath": "/platforms/javascript/guides/cloudflare/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/cloudflare/", "signals": { - "traces": "/platforms/javascript/guides/cloudflare/tracing/", - "logs": "/platforms/javascript/guides/cloudflare/logs/", - "metrics": "/platforms/javascript/guides/cloudflare/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/cloudflare/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/cloudflare/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/cloudflare/metrics/" } }, "node-connect": { "name": "Connect", - "docsPath": "/platforms/javascript/guides/node/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/node/", "signals": { - "traces": "/platforms/javascript/guides/node/tracing/", - "logs": "/platforms/javascript/guides/node/logs/", - "metrics": "/platforms/javascript/guides/node/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/node/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/node/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/node/metrics/" } }, "node-eve": { "name": "Eve", - "docsPath": "/platforms/javascript/guides/eve/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/eve/", "signals": { - "traces": "/platforms/javascript/guides/eve/tracing/", - "logs": "/platforms/javascript/guides/eve/logs/", - "metrics": "/platforms/javascript/guides/eve/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/eve/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/eve/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/eve/metrics/" } }, "node-express": { "name": "Express", - "docsPath": "/platforms/javascript/guides/express/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/express/", "signals": { - "traces": "/platforms/javascript/guides/node/tracing/", - "logs": "/platforms/javascript/guides/node/logs/", - "metrics": "/platforms/javascript/guides/node/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/node/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/node/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/node/metrics/" } }, "node-fastify": { "name": "Fastify", - "docsPath": "/platforms/javascript/guides/fastify/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/fastify/", "signals": { - "traces": "/platforms/javascript/guides/node/tracing/", - "logs": "/platforms/javascript/guides/node/logs/", - "metrics": "/platforms/javascript/guides/node/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/node/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/node/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/node/metrics/" } }, "node-flue": { "name": "Flue", - "docsPath": "/platforms/javascript/guides/flue/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/flue/", "signals": { - "traces": "/platforms/javascript/guides/flue/tracing/", - "logs": "/platforms/javascript/guides/flue/logs/", - "metrics": "/platforms/javascript/guides/flue/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/flue/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/flue/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/flue/metrics/" } }, "node-hapi": { "name": "Hapi", - "docsPath": "/platforms/javascript/guides/hapi/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/hapi/", "signals": { - "traces": "/platforms/javascript/guides/node/tracing/", - "logs": "/platforms/javascript/guides/node/logs/", - "metrics": "/platforms/javascript/guides/node/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/node/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/node/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/node/metrics/" } }, "node-hono": { "name": "Hono", - "docsPath": "/platforms/javascript/guides/hono/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/hono/", "signals": { - "traces": "/platforms/javascript/guides/hono/tracing/", - "logs": "/platforms/javascript/guides/hono/logs/", - "metrics": "/platforms/javascript/guides/hono/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/hono/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/hono/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/hono/metrics/" } }, "node-gcpfunctions": { "name": "Google Cloud Functions (Node)", - "docsPath": "/platforms/javascript/guides/gcp-functions/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/gcp-functions/", "signals": { - "traces": "/platforms/javascript/guides/gcp-functions/tracing/", - "logs": "/platforms/javascript/guides/gcp-functions/logs/", - "metrics": "/platforms/javascript/guides/gcp-functions/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/gcp-functions/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/gcp-functions/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/gcp-functions/metrics/" } }, "node-koa": { "name": "Koa", - "docsPath": "/platforms/javascript/guides/koa/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/koa/", "signals": { - "traces": "/platforms/javascript/guides/node/tracing/", - "logs": "/platforms/javascript/guides/node/logs/", - "metrics": "/platforms/javascript/guides/node/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/node/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/node/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/node/metrics/" } }, "node-mastra": { "name": "Mastra", - "docsPath": "/platforms/javascript/guides/mastra/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/mastra/", "signals": { - "traces": "/platforms/javascript/guides/mastra/tracing/", - "logs": "/platforms/javascript/guides/mastra/logs/", - "metrics": "/platforms/javascript/guides/mastra/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/mastra/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/mastra/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/mastra/metrics/" } }, "node-nestjs": { "name": "Nest.js", - "docsPath": "/platforms/javascript/guides/nestjs/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/nestjs/", "signals": { - "traces": "/platforms/javascript/guides/nestjs/tracing/", - "logs": "/platforms/javascript/guides/nestjs/logs/", - "metrics": "/platforms/javascript/guides/nestjs/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/nestjs/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/nestjs/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/nestjs/metrics/" } }, "node-pi-durable": { "name": "Pi Durable", - "docsPath": "/platforms/javascript/guides/pi-durable/", + "docsUrl": "https://docs.sentry.io/platforms/javascript/guides/pi-durable/", "signals": { - "traces": "/platforms/javascript/guides/pi-durable/tracing/", - "logs": "/platforms/javascript/guides/pi-durable/logs/", - "metrics": "/platforms/javascript/guides/pi-durable/metrics/" + "traces": "https://docs.sentry.io/platforms/javascript/guides/pi-durable/tracing/", + "logs": "https://docs.sentry.io/platforms/javascript/guides/pi-durable/logs/", + "metrics": "https://docs.sentry.io/platforms/javascript/guides/pi-durable/metrics/" } }, "php": { "name": "PHP", - "docsPath": "/platforms/php/", + "docsUrl": "https://docs.sentry.io/platforms/php/", "signals": { - "traces": "/platforms/php/tracing/", - "logs": "/platforms/php/logs/", - "metrics": "/platforms/php/metrics/" + "traces": "https://docs.sentry.io/platforms/php/tracing/", + "logs": "https://docs.sentry.io/platforms/php/logs/", + "metrics": "https://docs.sentry.io/platforms/php/metrics/" } }, "php-laravel": { "name": "Laravel", - "docsPath": "/platforms/php/guides/laravel/", + "docsUrl": "https://docs.sentry.io/platforms/php/guides/laravel/", "signals": { - "traces": "/platforms/php/guides/laravel/tracing/", - "logs": "/platforms/php/guides/laravel/logs/", - "metrics": "/platforms/php/guides/laravel/metrics/" + "traces": "https://docs.sentry.io/platforms/php/guides/laravel/tracing/", + "logs": "https://docs.sentry.io/platforms/php/guides/laravel/logs/", + "metrics": "https://docs.sentry.io/platforms/php/guides/laravel/metrics/" } }, "php-symfony": { "name": "Symfony", - "docsPath": "/platforms/php/guides/symfony/", + "docsUrl": "https://docs.sentry.io/platforms/php/guides/symfony/", "signals": { - "traces": "/platforms/php/guides/symfony/tracing/", - "logs": "/platforms/php/guides/symfony/logs/", - "metrics": "/platforms/php/guides/symfony/metrics/" + "traces": "https://docs.sentry.io/platforms/php/guides/symfony/tracing/", + "logs": "https://docs.sentry.io/platforms/php/guides/symfony/logs/", + "metrics": "https://docs.sentry.io/platforms/php/guides/symfony/metrics/" } }, "playstation": { "name": "PlayStation", - "docsPath": "/platforms/playstation/", + "docsUrl": "https://docs.sentry.io/platforms/playstation/", "signals": {} }, "powershell": { "name": "PowerShell", - "docsPath": "/platforms/powershell/", + "docsUrl": "https://docs.sentry.io/platforms/powershell/", "signals": { - "traces": "/platforms/powershell/tracing/" + "traces": "https://docs.sentry.io/platforms/powershell/tracing/" } }, "python": { "name": "Python", - "docsPath": "/platforms/python/", + "docsUrl": "https://docs.sentry.io/platforms/python/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-aiohttp": { "name": "AIOHTTP", - "docsPath": "/platforms/python/integrations/aiohttp/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/aiohttp/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-asgi": { "name": "ASGI", - "docsPath": "/platforms/python/integrations/asgi/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/asgi/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-awslambda": { "name": "AWS Lambda (Python)", - "docsPath": "/platforms/python/integrations/aws-lambda/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/aws-lambda/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-bottle": { "name": "Bottle", - "docsPath": "/platforms/python/integrations/bottle/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/bottle/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-celery": { "name": "Celery", - "docsPath": "/platforms/python/integrations/celery/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/celery/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-chalice": { "name": "Chalice", - "docsPath": "/platforms/python/integrations/chalice/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/chalice/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-django": { "name": "Django", - "docsPath": "/platforms/python/integrations/django/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/django/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-falcon": { "name": "Falcon", - "docsPath": "/platforms/python/integrations/falcon/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/falcon/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-fastapi": { "name": "FastAPI", - "docsPath": "/platforms/python/integrations/fastapi/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/fastapi/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-flask": { "name": "Flask", - "docsPath": "/platforms/python/integrations/flask/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/flask/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-litestar": { "name": "Litestar", - "docsPath": "/platforms/python/integrations/litestar/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/litestar/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-gcpfunctions": { "name": "Google Cloud Functions (Python)", - "docsPath": "/platforms/python/integrations/gcp-functions/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/gcp-functions/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-pyramid": { "name": "Pyramid", - "docsPath": "/platforms/python/integrations/pyramid/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/pyramid/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-quart": { "name": "Quart", - "docsPath": "/platforms/python/integrations/quart/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/quart/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-rq": { "name": "RQ (Redis Queue)", - "docsPath": "/platforms/python/integrations/rq/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/rq/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-sanic": { "name": "Sanic", - "docsPath": "/platforms/python/integrations/sanic/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/sanic/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-serverless": { "name": "Serverless (Python)", - "docsPath": "/platforms/python/integrations/serverless/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/serverless/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-starlette": { "name": "Starlette", - "docsPath": "/platforms/python/integrations/starlette/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/starlette/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-tornado": { "name": "Tornado", - "docsPath": "/platforms/python/integrations/tornado/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/tornado/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-tryton": { "name": "Tryton", - "docsPath": "/platforms/python/integrations/tryton/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/tryton/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "python-wsgi": { "name": "WSGI", - "docsPath": "/platforms/python/integrations/wsgi/", + "docsUrl": "https://docs.sentry.io/platforms/python/integrations/wsgi/", "signals": { - "traces": "/platforms/python/tracing/", - "logs": "/platforms/python/logs/", - "metrics": "/platforms/python/metrics/" + "traces": "https://docs.sentry.io/platforms/python/tracing/", + "logs": "https://docs.sentry.io/platforms/python/logs/", + "metrics": "https://docs.sentry.io/platforms/python/metrics/" } }, "react-native": { "name": "React Native", - "docsPath": "/platforms/react-native/", + "docsUrl": "https://docs.sentry.io/platforms/react-native/", "signals": { - "traces": "/platforms/react-native/tracing/", - "logs": "/platforms/react-native/logs/", - "metrics": "/platforms/react-native/metrics/", - "sessionReplay": "/platforms/react-native/session-replay/" + "traces": "https://docs.sentry.io/platforms/react-native/tracing/", + "logs": "https://docs.sentry.io/platforms/react-native/logs/", + "metrics": "https://docs.sentry.io/platforms/react-native/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/react-native/session-replay/" } }, "ruby": { "name": "Ruby", - "docsPath": "/platforms/ruby/", + "docsUrl": "https://docs.sentry.io/platforms/ruby/", "signals": { - "traces": "/platforms/ruby/tracing/", - "logs": "/platforms/ruby/logs/", - "metrics": "/platforms/ruby/metrics/" + "traces": "https://docs.sentry.io/platforms/ruby/tracing/", + "logs": "https://docs.sentry.io/platforms/ruby/logs/", + "metrics": "https://docs.sentry.io/platforms/ruby/metrics/" } }, "ruby-rack": { "name": "Rack Middleware", - "docsPath": "/platforms/ruby/guides/rack/", + "docsUrl": "https://docs.sentry.io/platforms/ruby/guides/rack/", "signals": { - "traces": "/platforms/ruby/guides/rack/tracing/", - "metrics": "/platforms/ruby/guides/rack/metrics/" + "traces": "https://docs.sentry.io/platforms/ruby/guides/rack/tracing/", + "metrics": "https://docs.sentry.io/platforms/ruby/guides/rack/metrics/" } }, "ruby-rails": { "name": "Rails", - "docsPath": "/platforms/ruby/guides/rails/", + "docsUrl": "https://docs.sentry.io/platforms/ruby/guides/rails/", "signals": { - "traces": "/platforms/ruby/guides/rails/tracing/", - "logs": "/platforms/ruby/guides/rails/logs/", - "metrics": "/platforms/ruby/guides/rails/metrics/" + "traces": "https://docs.sentry.io/platforms/ruby/guides/rails/tracing/", + "logs": "https://docs.sentry.io/platforms/ruby/guides/rails/logs/", + "metrics": "https://docs.sentry.io/platforms/ruby/guides/rails/metrics/" } }, "rust": { "name": "Rust", - "docsPath": "/platforms/rust/", + "docsUrl": "https://docs.sentry.io/platforms/rust/", "signals": { - "traces": "/platforms/rust/tracing/", - "logs": "/platforms/rust/logs/", - "metrics": "/platforms/rust/metrics/" + "traces": "https://docs.sentry.io/platforms/rust/tracing/", + "logs": "https://docs.sentry.io/platforms/rust/logs/", + "metrics": "https://docs.sentry.io/platforms/rust/metrics/" } }, "unity": { "name": "Unity", - "docsPath": "/platforms/unity/", + "docsUrl": "https://docs.sentry.io/platforms/unity/", "signals": { - "traces": "/platforms/unity/tracing/", - "logs": "/platforms/unity/logs/", - "metrics": "/platforms/unity/metrics/" + "traces": "https://docs.sentry.io/platforms/unity/tracing/", + "logs": "https://docs.sentry.io/platforms/unity/logs/", + "metrics": "https://docs.sentry.io/platforms/unity/metrics/" } }, "unreal": { "name": "Unreal Engine", - "docsPath": "/platforms/unreal/", + "docsUrl": "https://docs.sentry.io/platforms/unreal/", "signals": { - "traces": "/platforms/unreal/tracing/", - "logs": "/platforms/unreal/logs/", - "metrics": "/platforms/unreal/metrics/", - "sessionReplay": "/platforms/unreal/session-replay/" + "traces": "https://docs.sentry.io/platforms/unreal/tracing/", + "logs": "https://docs.sentry.io/platforms/unreal/logs/", + "metrics": "https://docs.sentry.io/platforms/unreal/metrics/", + "sessionReplay": "https://docs.sentry.io/platforms/unreal/session-replay/" } }, "xbox": { "name": "Xbox", - "docsPath": "/platforms/xbox/", + "docsUrl": "https://docs.sentry.io/platforms/xbox/", "signals": {} } } diff --git a/packages/mcp-core/src/tools/support/project-setup/project-setup.ts b/packages/mcp-core/src/tools/support/project-setup/project-setup.ts index 8d17b39943..c8223b662d 100644 --- a/packages/mcp-core/src/tools/support/project-setup/project-setup.ts +++ b/packages/mcp-core/src/tools/support/project-setup/project-setup.ts @@ -1,8 +1,6 @@ import { z } from "zod"; import platforms from "./platforms.json" with { type: "json" }; -const DOCS_ORIGIN = "https://docs.sentry.io"; - export const projectSetupSchema = z .object({ platform: z.string().describe("Platform display name, such as `Next.js`."), @@ -32,7 +30,7 @@ type PlatformSignalKey = "traces" | "logs" | "metrics" | "sessionReplay"; interface PlatformSetupEntry { name: string; - docsPath: string; + docsUrl: string; signals: Partial>; } @@ -54,7 +52,8 @@ const SIGNALS: ReadonlyArray<[PlatformSignalKey | "errors", SignalDefinition]> = "errors", { name: "Errors", - usefulFor: "Exceptions and crashes, with stack traces", + usefulFor: + "Unhandled exceptions and crashes, grouped into issues with stack traces and the state that led to them", recommended: true, }, ], @@ -62,7 +61,8 @@ const SIGNALS: ReadonlyArray<[PlatformSignalKey | "errors", SignalDefinition]> = "traces", { name: "Traces", - usefulFor: "Following requests, services, and agent runs end to end", + usefulFor: + "Debugging how requests, background jobs, and AI agent runs flow across services, and where they fail or slow down", recommended: true, }, ], @@ -70,7 +70,8 @@ const SIGNALS: ReadonlyArray<[PlatformSignalKey | "errors", SignalDefinition]> = "logs", { name: "Logs", - usefulFor: "App context around failures, linked to traces", + usefulFor: + "Structured app logs linked to the trace and error they came from, for context a stack trace lacks", recommended: false, feature: "ourlogs-enabled", }, @@ -79,7 +80,8 @@ const SIGNALS: ReadonlyArray<[PlatformSignalKey | "errors", SignalDefinition]> = "metrics", { name: "Metrics", - usefulFor: "Tracking and alerting on app and business health", + usefulFor: + "Counters, gauges, and distributions to chart and alert on, such as signups, queue depth, or token usage", recommended: false, feature: "tracemetrics-enabled", }, @@ -88,17 +90,14 @@ const SIGNALS: ReadonlyArray<[PlatformSignalKey | "errors", SignalDefinition]> = "sessionReplay", { name: "Session Replay", - usefulFor: "Seeing what a user did before a bug", + usefulFor: + "Understanding how users behave in a web or mobile UI: clicks, navigation, network calls, and errors in a replay, to reproduce bugs and find friction", recommended: false, feature: "session-replay", }, ], ]; -function docsUrl(path: string): string { - return new URL(path, DOCS_ORIGIN).toString(); -} - /** * Builds setup knowledge for a Sentry platform ID: its setup guide and the * core signals its SDK supports, each with a docs link. @@ -118,8 +117,8 @@ export function buildProjectSetup( const signals: NonNullable["signals"] = []; for (const [key, definition] of SIGNALS) { - const path = key === "errors" ? entry.docsPath : entry.signals[key]; - if (!path) { + const signalDocsUrl = key === "errors" ? entry.docsUrl : entry.signals[key]; + if (!signalDocsUrl) { continue; } if ( @@ -133,13 +132,13 @@ export function buildProjectSetup( name: definition.name, usefulFor: definition.usefulFor, ...(definition.recommended ? { recommended: true as const } : {}), - docsUrl: docsUrl(path), + docsUrl: signalDocsUrl, }); } return { platform: entry.name, - docsUrl: docsUrl(entry.docsPath), + docsUrl: entry.docsUrl, signals, }; }