Skip to content

CPS: Document space-level CPS scope for alerting rules#5427

Merged
nastasha-solomon merged 19 commits intocps-tech-previewfrom
cps/688-alerting-rules-cps
Mar 23, 2026
Merged

CPS: Document space-level CPS scope for alerting rules#5427
nastasha-solomon merged 19 commits intocps-tech-previewfrom
cps/688-alerting-rules-cps

Conversation

@florent-leborgne
Copy link
Contributor

Summary

Adds a new "Cross-project search scope for rules" section to the alerting rules page (create-manage-rules.md), explaining that:

  • Alerting rules query data across linked projects based on the space-level CPS scope, not a per-rule setting
  • The project picker on rule pages is read-only -- to change which projects a rule queries, update the space's CPS configuration

This reflects the actual implementation, which differs from the original issue description (no per-rule CPS scope selector).

Closes elastic/docs-content-internal#688

Test plan

  • Verify the page builds correctly at explore-analyze/alerting/alerts/create-manage-rules
  • Confirm applies_to tags render properly (serverless preview / stack unavailable)
  • Check cross-links to CPS pages resolve correctly

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No
  1. If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).

Tool(s) and model(s) used: Claude (Cursor)

Made with Cursor

Add a section explaining that alerting rules use the space-level CPS
scope (not a per-rule setting), and that the project picker is
read-only on rule pages.

Closes #688

Made-with: Cursor
@github-actions
Copy link
Contributor

github-actions bot commented Mar 10, 2026

✅ Vale Linting Results

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

nastasha-solomon and others added 11 commits March 12, 2026 17:42
Add a new section explaining that when CPS is active, the data view
creation form automatically lists indices from linked projects based
on the current CPS scope, with no opt-in required.

Closes #687

Made-with: Cursor
…lified expressions

- Index listing from linked projects only works from CPS-enabled apps
  (Discover, Dashboards, Lens, Maps), not from Stack Management
- Add note about Stack Management limitation
- Incorporate qualified expressions content (from MW's config PR)
- Add link to search expressions reference

Made-with: Cursor
- Clarify scope selector is read-only when opening a rule (not on list page)
- Narrow project routing claim to ES|QL rules only (verified against codebase)
- Replace placeholder comment with real link on Observability rules page
- Add scope selector and space config link to Security detection rules page
- Fix trailing whitespace in anomaly detection note

Made-with: Cursor
@nastasha-solomon nastasha-solomon marked this pull request as ready for review March 13, 2026 23:08
@nastasha-solomon nastasha-solomon requested review from a team as code owners March 13, 2026 23:08
@nastasha-solomon
Copy link
Contributor

@florent-leborgne just an FYI that I'm trying to verify whether it's just ES|QL rules that support CPS, or all rule types across Stack, Observability, and Security.

@nastasha-solomon
Copy link
Contributor

Will address requested changes in a separate PR.

@nastasha-solomon nastasha-solomon merged commit bdaad85 into cps-tech-preview Mar 23, 2026
7 checks passed
@nastasha-solomon nastasha-solomon deleted the cps/688-alerting-rules-cps branch March 23, 2026 19:12
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.

4 participants