Skip to content

feat(agent): Add alert about other runtimes for meta frameworks#106944

Merged
priscilawebdev merged 19 commits intomasterfrom
priscila/feat/add-fullstack-option-to-agent-monitoring-onboarding
Jan 27, 2026
Merged

feat(agent): Add alert about other runtimes for meta frameworks#106944
priscilawebdev merged 19 commits intomasterfrom
priscila/feat/add-fullstack-option-to-agent-monitoring-onboarding

Conversation

@priscilawebdev
Copy link
Member

@priscilawebdev priscilawebdev commented Jan 25, 2026

Problem

Meta frameworks let the same codebase run in multiple environments - like the browser and the server - and sometimes across different server runtimes.

When setting up Sentry to work with Agent Monitoring, users can choose to instrument the client, the server, or both. If they’re using a server runtime other than Node.js (for example, Deno), they must follow the client-side setup for everything to work correctly.

Right now, the Agent Monitoring onboarding doesn’t offer client-side instrumentation for meta frameworks, and it doesn’t mention runtimes at all. Both are important, since users might need to configure instrumentation on the client or be running on a non-Node.js runtime.

Solution

We are adding a simple alert inside of the configure section, guiding users to go to the documentation.

image

contributes to https://linear.app/getsentry/issue/TET-1759/split-agent-monitoring-onboarding-into-separate-node-and-browser

@linear
Copy link

linear bot commented Jan 25, 2026

@github-actions github-actions bot added the Scope: Frontend Automatically applied to PRs that change frontend components label Jan 25, 2026
…ullstack-option-to-agent-monitoring-onboarding

# Conflicts:
#	static/app/gettingStartedDocs/javascript/agentMonitoring.tsx
#	static/app/gettingStartedDocs/node/utils.tsx
#	static/app/views/insights/pages/agents/onboarding.tsx
Comment on lines 36 to 39
/**
* When used with GuidedSteps component, displays an "Optional" label below the step title.
*/
showOptionalLabel?: boolean;
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wish this prop was called "optional", but that would likely confuse users since we already have "collapse", which conveys a very similar idea. Might be worth revisiting later.

Comment on lines -51 to -61
// Full-stack JS frameworks that support server-side agent SDKs.
const fullStackJsPlatforms = [
'javascript-astro',
'javascript-nextjs',
'javascript-nuxt',
'javascript-react-router',
'javascript-remix',
'javascript-solidstart',
'javascript-sveltekit',
'javascript-tanstackstart-react',
];
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we already have this defined in platformCategories

@priscilawebdev priscilawebdev marked this pull request as ready for review January 26, 2026 07:06
@priscilawebdev priscilawebdev requested a review from a team as a code owner January 26, 2026 07:06
Copy link
Member

@obostjancic obostjancic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As discussed offline I think the runtime selector could be less prominent, and we maybe don't need it here at all. Most users are on Node so it might be better to keep the in‑product flow focused on that common case and point to the docs for other runtimes. For full‑stack frameworks, AI calls are mostly on the backend, so we could mark the client step as optional or omit it.

@priscilawebdev priscilawebdev changed the title feat(agent): Add fullstack onboarding for meta frameworks feat(agent): Add alert about other runtimes for meta frameworks Jan 27, 2026
Comment on lines +103 to +109
const selected =
(params.platformOptions as any)?.integration ?? AgentIntegration.VERCEL_AI;

if (selected === AgentIntegration.MASTRA) {
return [
{
type: StepType.INSTALL,
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In this PR, I separated the install, configure, and verify steps into reusable functions so they could be shared with the full-stack onboarding code. Although I removed the full-stack onboarding changes based on feedback, I decided to keep the separate functions because they improve code readability. It looks like a lot, but the only change really, its the alert for other runtimes in case of meta platforms.

Copy link
Contributor

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

Copy link
Member

@obostjancic obostjancic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

awesome 🚀

@priscilawebdev priscilawebdev merged commit 9e91d2f into master Jan 27, 2026
54 checks passed
@priscilawebdev priscilawebdev deleted the priscila/feat/add-fullstack-option-to-agent-monitoring-onboarding branch January 27, 2026 09:35
priscilawebdev added a commit that referenced this pull request Feb 2, 2026
)

**Problem**

Meta frameworks let the same codebase run in multiple environments -
like the browser and the server - and sometimes across different server
runtimes.

When setting up Sentry to work with Agent Monitoring, users can choose
to instrument the client, the server, or both. If they’re using a server
runtime other than Node.js (for example, Deno), they must follow the
client-side setup for everything to work correctly.

Right now, the Agent Monitoring onboarding doesn’t offer client-side
instrumentation for meta frameworks, and it doesn’t mention runtimes at
all. Both are important, since users might need to configure
instrumentation on the client or be running on a non-Node.js runtime.

**Solution**

We are adding a simple alert inside of the configure section, guiding
users to go to the documentation.



contributes to
https://linear.app/getsentry/issue/TET-1759/split-agent-monitoring-onboarding-into-separate-node-and-browser
@github-actions github-actions bot locked and limited conversation to collaborators Feb 11, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Scope: Frontend Automatically applied to PRs that change frontend components

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants