Improve Kibana learning tutorial with richer examples#5399
Improve Kibana learning tutorial with richer examples#5399florent-leborgne wants to merge 4 commits intomainfrom
Conversation
New learning-oriented page covering an end-to-end Kibana workflow: ingest system logs with Elastic Agent, explore data in Discover with ES|QL, build a dashboard with Lens visualizations, and share it. Also updates the explore-analyze index and TOC to link to the new page. Closes elastic/docs-content-internal#811 Made-with: Cursor
Rework the "Learn data exploration and visualization" tutorial to better showcase Kibana's strengths through concrete, experiential examples: - Replace plain count metric with median response size (bytes formatting, dynamic coloring, background sparkline) - Add reference line to line chart for visual threshold context - Make inline editing step concrete (exclude blanks via regex) - Add interactive cross-filtering step (click 404 to filter dashboard) - Add screenshots for each Lens visualization step - Surface Lens smart defaults (auto chart type, auto time axis) - Mention ES|QL autocomplete, Discover contextual adaptation, pre-built integration dashboards, dashboard controls, and collapsible sections - Simplify sharing to link-based flow with accurate access control info - Expand navigation section with saved sessions and ES|QL panel paths - Add machine learning to Next steps Closes elastic/docs-content-internal#811 Made-with: Cursor
✅ Vale Linting ResultsNo 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. |
- Replace {icon}`editorCodeBlock` with {icon}`code` (matching try-esql.md)
- Remove broken /reference/beats.md link (page does not exist)
Made-with: Cursor
Made-with: Cursor
🔍 Preview links for changed docs |
|
Hey @teresaalvarezsoler & @ninoslavmiskovic, some fairly hot SEO issue came our way and I had to quickly get a "core kibana analyst features" learning-oriented page up. The way I went about it is to show some end-to-end story that starts in discover and ends with sharing a dashboard. It shows or mentions some features (sometimes to keep the overall flow centered I "just" linked to features with some context such as controls, collapsible sections, etc.). Let me know what you think about the overall narrative here, and if there are some things you'd like me to better highlight or more concretely show. Keep in mind that this is really meant to be an entry point more than an exhaustive tour of all features 🙏 |
2 participants
Summary
Creates a new hands-on tutorial, "Learn data exploration and visualization with Kibana", that teaches new Kibana users the "core" analyst workflow from raw data to a shareable dashboard. It revives the old 8.x "Quick start" page (which was redirected to a generic hub page) with a proper onboarding experience; in order to fix urgent SEO issues.
The tutorial uses the built-in sample web logs dataset so readers can follow along immediately. It walks through:
The tutorial is designed so readers experience Kibana's strengths naturally through the steps (smart defaults, instant previews, cross-filtering, the Discover-to-dashboard loop) rather than being told about them.
Also updates
explore-analyze/index.mdto fix the tutorial link description.Closes https://github.com/elastic/docs-content-internal/issues/811
Test plan
Generative AI disclosure
Tool(s) and model(s) used: Cursor and
claude-4.6-opus-high