Skip to content

Conversation

@sfanahata
Copy link
Contributor

@sfanahata sfanahata commented Sep 24, 2025

DESCRIBE YOUR PR

We're rearranging documentation to show the new world of Monitors and Alerts.
This PR purposefully leaves Alerts alone, as we'll be moving through beta before GA, and still getting clarity on timing of Alerts officially going away.

Moved Crons and Uptime monitoring to Monitors.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline: Dec 1
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

@vercel
Copy link

vercel bot commented Sep 24, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
sentry-docs Ready Ready Preview Comment Nov 13, 2025 8:12pm
1 Skipped Deployment
Project Deployment Preview Comments Updated (UTC)
develop-docs Ignored Ignored Preview Nov 13, 2025 8:12pm

@codecov
Copy link

codecov bot commented Sep 24, 2025

Bundle Report

Changes will decrease total bundle size by 5.47kB (-0.02%) ⬇️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
sentry-docs-client-array-push 10.17MB -6 bytes (-0.0%) ⬇️
sentry-docs-server-cjs 12.62MB -5.47kB (-0.04%) ⬇️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name Size Change Total Size Change (%)
1729.js -3 bytes 1.74MB -0.0%
../instrumentation.js -3 bytes 1.07MB -0.0%
9523.js -3 bytes 1.04MB -0.0%
../app/[[...path]]/page.js.nft.json -1.82kB 769.48kB -0.24%
../app/platform-redirect/page.js.nft.json -1.82kB 769.39kB -0.24%
../app/sitemap.xml/route.js.nft.json -1.82kB 766.62kB -0.24%
view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
static/chunks/pages/_app-*.js -3 bytes 882.71kB -0.0%
static/chunks/8321-*.js -3 bytes 425.87kB -0.0%
server/middleware-*.js 6.46kB 7.46kB 645.5% ⚠️
server/middleware-*.js -6.46kB 1.0kB -86.59%
static/_Sedl5L8xEMnSC7BaV-*.js (New) 684 bytes 684 bytes 100.0% 🚀
static/_Sedl5L8xEMnSC7BaV-*.js (New) 77 bytes 77 bytes 100.0% 🚀
static/NdnQOTTlNhpysJCjmizFa/_buildManifest.js (Deleted) -684 bytes 0 bytes -100.0% 🗑️
static/NdnQOTTlNhpysJCjmizFa/_ssgManifest.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️


<Alert>

Automations are an Organization-level feature. By default, only owners, managers, and team admins can create, update, and delete Automations.
Copy link
Member

Choose a reason for hiding this comment

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

We should remove "team admins" from this list, since automations are org-scoped so there are no teams that own the automations.

By default, the org setting "Let Members Create and Edit Alerts" is actually ON, so all members can create automations. Would it worth pointing out where you can change this behavior in settings?

Screenshot 2025-09-30 at 10 21 54 AM

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good to know! I'll update to mention where to change those settings.


<Alert>

Monitors are a Project-level feature. By default, only owners, managers, and team admins can create, update, and delete Monitors.
Copy link
Member

Choose a reason for hiding this comment

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

Similar comment to https://github.com/getsentry/sentry-docs/pull/15041/files#r2392346270 , by default the org setting is actually ON so members can also create monitors.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Got it! Thank you for calling that out.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@ameliahsu - I cannot for the life of me find where that setting is. Mind pointing me in the right direction?

Copy link
Member

Choose a reason for hiding this comment

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

No problem! In organization settings under "General Settings" you should see it if you scroll down to the "Membership" section
Screenshot 2025-11-13 at 11 37 22 AM

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Oh, but that's just for alerts. Is the plan to keep just this one setting for both? If so, we need to update the text.


### General Settings

Monitors are made of attributes that define when to create an issue, and actions that define what to do when an issue is created.
Copy link
Member

@ameliahsu ameliahsu Oct 23, 2025

Choose a reason for hiding this comment

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

actions that define what to do when an issue is created

Is this referring to assigning the issue, setting a priority, etc? Just to refresh my memory, are we differentiating these actions from alerts/automation Actions through capitalization?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, that's what it's referring to. Do we officially want to call these capital A actions? Happy to update.

@sfanahata sfanahata changed the title Documentation for Monitors and Automations Documentation for Monitors and Alerts Nov 5, 2025
Shannon Anahata added 3 commits November 13, 2025 11:22
Resolved conflicts:
- docs/product/alerts/index.mdx: Kept new alert description and sidebar_order, added og_image from master
- docs/security-legal-pii/security/data-retention-periods.mdx: Merged retention period updates from master with documentation links
- Removed 6 old alert documentation files that were restructured (alert-types.mdx, create-alerts/*)
@codeowner-assignment codeowner-assignment bot requested review from a team November 13, 2025 19:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants