mirror of
https://github.com/elastic/kibana.git
synced 2025-06-28 11:05:39 -04:00
418281b2d1
# Backport This will backport the following commits from `main` to `8.x`: - [[Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163)](https://github.com/elastic/kibana/pull/199163) <!--- Backport version: 9.4.3 --> ### Questions ? Please refer to the [Backport tool documentation](https://github.com/sqren/backport) <!--BACKPORT [{"author":{"name":"florent-leborgne","email":"florent.leborgne@elastic.co"},"sourceCommit":{"committedDate":"2024-11-08T10:10:32Z","message":"[Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163)\n\nThis PR:\r\n- updates navigation instructions to accommodate for the navigation\r\nchanges related to solution views.\r\n- updates instructions for adding sample data to rely on the\r\nintegrations page instead of the home page, that only exists with the\r\nclassic solution view\r\n- updates references to the home page to avoid confusing users using one\r\nof the new solution views\r\n\r\nCloses: https://github.com/elastic/platform-docs-team/issues/529\r\nCloses: https://github.com/elastic/platform-docs-team/issues/540","sha":"8e7fb7a77e2399e3e946bbba0462517fd7dad0f7","branchLabelMapping":{"^v9.0.0$":"main","^v8.17.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","v9.0.0","docs","v8.16.0","backport:version","v8.17.0"],"title":"[Docs] Update nav instructions and sample data installation to accommodate for the solution views","number":199163,"url":"https://github.com/elastic/kibana/pull/199163","mergeCommit":{"message":"[Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163)\n\nThis PR:\r\n- updates navigation instructions to accommodate for the navigation\r\nchanges related to solution views.\r\n- updates instructions for adding sample data to rely on the\r\nintegrations page instead of the home page, that only exists with the\r\nclassic solution view\r\n- updates references to the home page to avoid confusing users using one\r\nof the new solution views\r\n\r\nCloses: https://github.com/elastic/platform-docs-team/issues/529\r\nCloses: https://github.com/elastic/platform-docs-team/issues/540","sha":"8e7fb7a77e2399e3e946bbba0462517fd7dad0f7"}},"sourceBranch":"main","suggestedTargetBranches":["8.16","8.x"],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","branchLabelMappingKey":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/199163","number":199163,"mergeCommit":{"message":"[Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163)\n\nThis PR:\r\n- updates navigation instructions to accommodate for the navigation\r\nchanges related to solution views.\r\n- updates instructions for adding sample data to rely on the\r\nintegrations page instead of the home page, that only exists with the\r\nclassic solution view\r\n- updates references to the home page to avoid confusing users using one\r\nof the new solution views\r\n\r\nCloses: https://github.com/elastic/platform-docs-team/issues/529\r\nCloses: https://github.com/elastic/platform-docs-team/issues/540","sha":"8e7fb7a77e2399e3e946bbba0462517fd7dad0f7"}},{"branch":"8.16","label":"v8.16.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.x","label":"v8.17.0","branchLabelMappingKey":"^v8.17.0$","isSourceBranch":false,"state":"NOT_CREATED"}]}] BACKPORT--> Co-authored-by: florent-leborgne <florent.leborgne@elastic.co>
154 lines
6.1 KiB
Text
154 lines
6.1 KiB
Text
[[get-started]]
|
|
== Quick start
|
|
|
|
To quickly get up and running with {kib}, set up on Cloud, then add a sample data set that you can explore and visualize.
|
|
|
|
When you're done, you'll know how to:
|
|
|
|
* <<explore-the-data,Explore the data with *Discover*.>>
|
|
|
|
* <<view-and-analyze-the-data,Visualize the data with *Dashboard*.>>
|
|
|
|
[float]
|
|
=== Required privileges
|
|
You must have `read`, `write`, and `manage` privileges on the `kibana_sample_data_*` indices.
|
|
Learn how to <<tutorial-secure-access-to-kibana, secure access to {kib}>>, or refer to {ref}/security-privileges.html[Security privileges] for more information.
|
|
|
|
[float]
|
|
[[set-up-on-cloud]]
|
|
== Set up on cloud
|
|
|
|
include::{docs-root}/shared/cloud/ess-getting-started.asciidoc[]
|
|
|
|
[float]
|
|
[[gs-get-data-into-kibana]]
|
|
== Add sample data
|
|
|
|
Sample data sets come with sample visualizations, dashboards, and more to help you explore {kib} before you ingest or add your own data.
|
|
|
|
. Open the **Integrations** page from the navigation menu or using the <<kibana-navigation-search,global search field>>.
|
|
|
|
. In the list of integrations, select **Sample Data**.
|
|
|
|
. On the page that opens, select *Other sample data sets*.
|
|
|
|
. Install the sample data sets that you want.
|
|
|
|
Once installed, you can access the sample data in the various {kib} apps available to you.
|
|
|
|
[float]
|
|
[[explore-the-data]]
|
|
== Explore the data
|
|
|
|
*Discover* displays the data in an interactive histogram that shows the distribution of data, or documents, over time, and a table that lists the fields for each document that matches the {data-source}. To view a subset of the documents, you can apply filters to the data, and customize the table to display only the fields you want to explore.
|
|
|
|
. Go to *Discover*.
|
|
|
|
. Change the <<set-time-filter, time filter>> to *Last 7 days*.
|
|
+
|
|
[role="screenshot"]
|
|
image::images/timeFilter_discover_8.4.0.png[Time filter menu with Last 7 days filter configured]
|
|
|
|
. To view the sales orders for women's clothing that are $60 or more, use the <<kuery-query,*KQL*>> search field:
|
|
+
|
|
[source,text]
|
|
products.taxless_price >= 60 and category : Women's Clothing
|
|
+
|
|
[role="screenshot"]
|
|
image::images/kql_discover_8.4.0.png[Discover tables that displays only the orders for women's clothing that are $60 or more]
|
|
|
|
. To view only the product categories that contain sales orders, hover over the *category* field, then click *+*.
|
|
+
|
|
[role="screenshot"]
|
|
image::images/availableFields_discover_8.4.0.png[Discover table that displays only the product categories that contain orders]
|
|
|
|
[float]
|
|
[[view-and-analyze-the-data]]
|
|
== Visualize the data
|
|
|
|
A dashboard is a collection of panels that you can use to visualize the data. Panels contain visualizations, interactive controls, text, and more.
|
|
|
|
. Go to *Dashboards*.
|
|
|
|
. Click *[eCommerce] Revenue Dashboard*.
|
|
+
|
|
[role="screenshot"]
|
|
image::images/dashboard_ecommerceRevenueDashboard_8.6.0.png[The [eCommerce] Revenue Dashboard that comes with the Sample eCommerce order data set]
|
|
|
|
[float]
|
|
[[create-a-visualization]]
|
|
=== Create a visualization panel
|
|
|
|
Create a treemap visualization panel that shows the top sales regions and manufacturers, then add the panel to the dashboard.
|
|
|
|
. In the toolbar, click *Edit*.
|
|
|
|
. On the dashboard, click *Create visualization*.
|
|
|
|
. In the drag-and-drop visualization editor, open the *Visualization type* dropdown, then select *Treemap*.
|
|
+
|
|
[role="screenshot"]
|
|
image::getting-started/images/visualizationTypeDropdown_lens_8.4.0.png[Chart type menu with Treemap selected]
|
|
|
|
. From the *Available fields* list, drag the following fields to the workspace:
|
|
|
|
* *geoip.city_name*
|
|
|
|
* *manufacturer.keyword*
|
|
+
|
|
[role="screenshot"]
|
|
image::getting-started/images/ecommerceTreemap_lens_8.4.0.png[Treemap that displays Top values of geoip.city_name and Top values or manufacturer.keyword fields]
|
|
|
|
. Click *Save and return*.
|
|
+
|
|
The treemap appears as the last visualization panel on the dashboard.
|
|
|
|
[float]
|
|
[[interact-with-the-data]]
|
|
=== Interact with the data
|
|
|
|
You can interact with the dashboard data using controls that allow you to apply dashboard-level filters. Interact with the *[eCommerce] Controls* panel to view the women's clothing data from the Gnomehouse manufacturer.
|
|
|
|
. From the *Manufacturer* dropdown, select *Gnomehouse*.
|
|
|
|
. From the *Category* dropdown, select *Women's Clothing*.
|
|
+
|
|
[role="screenshot"]
|
|
image::images/sampleDataFilter_dashboard_8.6.0.png[The [eCommerce] Revenue Dashboard that shows only the women's clothing data from the Gnomehouse manufacturer]
|
|
|
|
[float]
|
|
[[filter-and-query-the-data]]
|
|
=== Filter the data
|
|
|
|
To view a subset of the data, you can apply filters to the dashboard data. Apply a filter to view the women's clothing data generated on Wednesday from the Gnomehouse manufacturer.
|
|
|
|
. Click *Add filter*.
|
|
+
|
|
[role="screenshot"]
|
|
image::images/addFilter_dashboard_8.6.0.png[The Add filter action that applies dashboard-level filters]
|
|
|
|
. From the *Field* dropdown, select *day_of_week*.
|
|
|
|
. From the *Operator* dropdown, select *is*.
|
|
|
|
. From the *Value* dropdown, select *Wednesday*.
|
|
+
|
|
[role="screenshot"]
|
|
image::images/addFilterOptions_dashboard_8.6.0.png[The Add filter options configured to display only the women's clothing data generated on Wednesday from the Gnomehouse manufacturer]
|
|
|
|
. Click *Add filter*.
|
|
+
|
|
[role="screenshot"]
|
|
image::images/dashboard_sampleDataAddFilter_8.6.0.png[The [eCommerce] Revenue Dashboard that shows only the women's clothing data generated on Wednesday from the Gnomehouse manufacturer]
|
|
|
|
[float]
|
|
[[quick-start-whats-next]]
|
|
== What's next?
|
|
|
|
*Add your own data.* Ready to add your own data? Go to {observability-guide}/observability-get-started.html[Get started with Elastic Observability], or go to <<connect-to-elasticsearch,Add data to {kib}>> and learn about all the ways you can add data.
|
|
|
|
*Explore your own data in Discover.* Ready to learn more about exploring your data in *Discover*? Go to <<discover, Discover>>.
|
|
|
|
*Create a dashboard with your own data.* Ready to learn more about visualizing your data on a *Dashboard*? Go to <<dashboard, Dashboard>>.
|
|
|
|
*Try out the {ml-features}.* Ready to analyze the sample data sets and generate models for its patterns of behavior? Go to {ml-docs}/ml-getting-started.html[Getting started with {ml}].
|