Skip to content

CPS: Add project routing section to ES|QL in Kibana and ES|QL visualizations#5424

Merged
florent-leborgne merged 9 commits intocps-tech-previewfrom
cps/685-esql-project-routing
Mar 23, 2026
Merged

CPS: Add project routing section to ES|QL in Kibana and ES|QL visualizations#5424
florent-leborgne merged 9 commits intocps-tech-previewfrom
cps/685-esql-project-routing

Conversation

@florent-leborgne
Copy link
Contributor

@florent-leborgne florent-leborgne commented Mar 10, 2026

Summary

Adds CPS project routing documentation to the ES|QL pages:

ES|QL in Kibana (esql-kibana.md):

  • New "Search across linked projects with SET project_routing" section
  • Documents the SET project_routing syntax, autocomplete values (_alias:_origin, _alias:*), tag-based expressions, and named project routing expressions
  • Notes the Custom CPS scope badge behavior on dashboard panels

ES|QL visualizations (esorql.md):

  • New "Query data from multiple projects" subsection under "Create from dashboard"
  • Explains that SET project_routing in an ES|QL visualization triggers a Custom CPS scope badge on the dashboard panel

Closes elastic/docs-content-internal#685

Test plan

  • Verify pages build correctly at explore-analyze/query-filter/languages/esql-kibana and explore-analyze/visualize/esorql
  • Confirm applies_to tags render properly (serverless preview / stack unavailable)
  • Check cross-links to CPS pages resolve correctly (depend on sibling CPS branches)
  • Test SET project_routing autocomplete in ES|QL editor with CPS enabled

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 new section explaining how to use SET project_routing in ES|QL
queries to control which linked projects a query targets, including
autocomplete values, named routing expressions, and the panel badge.

Closes #685

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

github-actions bot commented Mar 10, 2026

Vale Linting Results

Summary: 1 warning found

⚠️ Warnings (1)
File Line Rule Message
explore-analyze/query-filter/languages/esql-kibana.md 255 Elastic.Spelling 'autocompletes' is a possible misspelling.

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.

Revert alerting rules CPS changes that are covered by the dedicated
alerting PR. Add a CPS section to the ES|QL visualizations page
explaining SET project_routing and the Custom CPS scope badge.

Made-with: Cursor
@florent-leborgne florent-leborgne changed the title CPS: Add project routing section to ES|QL in Kibana docs CPS: Add project routing section to ES|QL in Kibana and ES|QL visualizations Mar 23, 2026
Remove duplicated content (routing expression details, badge note)
already covered by the manage-scope page. Keep the example and
autocomplete values which are unique to the ES|QL editor. Link out
for full query-level override details.

Made-with: Cursor
Made-with: Cursor
@florent-leborgne florent-leborgne marked this pull request as ready for review March 23, 2026 18:51
@florent-leborgne florent-leborgne requested review from a team as code owners March 23, 2026 18:51
@florent-leborgne
Copy link
Contributor Author

@mbondyra I'm merging this one because it'll fix a link that prevents the feature branch from building a preview but feel free to add your thoughts there and I'll make the changes separately

@florent-leborgne florent-leborgne merged commit a8c643a into cps-tech-preview Mar 23, 2026
6 of 7 checks passed
@florent-leborgne florent-leborgne deleted the cps/685-esql-project-routing branch March 23, 2026 18:52
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.

1 participant