Skip to content

docs: document ES|QL Data Federation datasets in Kibana (#7633) - #7871

Draft
florent-leborgne wants to merge 1 commit into
mainfrom
docs-issue-7633-esql-fds
Draft

docs: document ES|QL Data Federation datasets in Kibana (#7633)#7871
florent-leborgne wants to merge 1 commit into
mainfrom
docs-issue-7633-esql-fds

Conversation

@florent-leborgne

@florent-leborgne florent-leborgne commented Aug 7, 2026

Copy link
Copy Markdown
Member

Summary

This PR addresses #7633 with the following changes:

  • explore-analyze/query-filter/languages/esql-kibana.md: extends the FROM source-command list to note it can also target ES|QL Data Federation datasets, and adds a tip explaining that Discover and Dashboards now open even without local or remote indices when at least one dataset exists (Kibana PR #279421).
  • explore-analyze/discover/try-esql.md: adds External data to the list of source types shown in the ES|QL data source browser, a pre-existing gap the issue author flagged (Kibana PR #276193, shipped in 9.5.0, not tied to the triggering PR).

Notes for reviewer

  • ES|QL Data Federation itself is stack: experimental =9.5 / serverless: unavailable on its canonical reference page (elastic/elasticsearch), a very recently reviewed and deliberately per-minor-pinned tag (not an open-ended "9.5+"). I mirrored that same exact-version pinning convention on all three new facts here (=9.5 for the two 9.5-era Kibana capabilities, =9.6 for the Discover/Dashboards no-data-screen bypass, which is Kibana-only and targets v9.6.0, not yet released). A fresh-reader comprehension test initially caught a version-notation contradiction between an open-ended tag here and the source page's exact pin; aligning both resolved it.
  • The PR also adds a 5-second timeout fallback (opens an empty ES|QL results table instead of failing) and parallelizes data-source checks for speed. Neither adds a user-facing option or step, so I left them out of the docs per the whether-to-document gate.
  • I did not document the "browse the data source badge" / autocomplete resource-browser mechanics beyond the type-list addition; those were already covered and unaffected by this change.

Companion PR

  • elastic/elasticsearch#156198 — adds a reciprocal link from the ES|QL Data Federation overview page back to "Use ES|QL in the Kibana UI", per this repo's bidirectional cross-discoverability convention.

AI-generated draft — created with Claude Sonnet 5.
Review all generated content for factual accuracy before merging.

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

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.

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