Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] Rework of main get started page #58260

Merged
merged 7 commits into from
Mar 2, 2020
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion docs/redirects.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ This page was deleted. See <<xpack-graph>> and <<xpack-ml>>.
[role="exclude",id="xpack-dashboard-only-mode"]
== Dashboard-only mode

Using the `kibana_dashboard_only_user` role is deprecated.
Using the `kibana_dashboard_only_user` role is deprecated.
Use <<kibana-feature-privileges,feature privileges>> instead.

[role="exclude",id="pdf-layout-modes"]
Expand All @@ -56,4 +56,7 @@ This page has moved. Please see <<reporting-getting-started>>.

This page has moved. Please see <<reporting-getting-started>>.

[role="exclude",id="add-sample-data"]
== Add sample data

This page has moved. Please see <<get-data-in>>.
74 changes: 42 additions & 32 deletions docs/user/getting-started.asciidoc
Original file line number Diff line number Diff line change
@@ -1,55 +1,66 @@
[[getting-started]]
= Getting Started
= Get started

[partintro]
--

You’re new to Kibana and want to give it a try. {kib} has sample data sets and
tutorials to help you get started.
You're new to {kib}, and not sure where to start. To quickly get started with {kib}, set up on Cloud and add a sample data set that you can use to get a handle on the full range of {kib} features.
KOTungseth marked this conversation as resolved.
Show resolved Hide resolved

[float]
=== Sample data
[[cloud-set-up]]
== Set up on Cloud

You can use the <<add-sample-data, sample data
sets>> to take {kib} for a test ride without having
to go through the process of loading data yourself. With one click,
you can install a sample data set and start interacting with
{kib} visualizations in seconds. You can access the sample data
from the {kib} home page.
To easily access {kib} in a single click, run our hosted Elasticsearch Service on Elastic Cloud.
KOTungseth marked this conversation as resolved.
Show resolved Hide resolved

[float]
. Log into the link:https://cloud.elastic.co/[Elasticsearch Service Console].
If you need an account, register for a link:https://www.elastic.co/cloud/elasticsearch-service/signup[free 14-day trial].

. Click *Create deployment*, then give your deployment a name.
KOTungseth marked this conversation as resolved.
Show resolved Hide resolved

=== Add data tutorials
{kib} has built-in *Add Data* tutorials to help you set up
data flows in the Elastic Stack. These tutorials are available
from the Kibana home page. In *Add Data to Kibana*, find the data type
you’re interested in, and click its button to view a list of available tutorials.
. To use the default options, click *Create deployment*. If you want, you can modify the other deployment options, but the default options are great to get started.
KOTungseth marked this conversation as resolved.
Show resolved Hide resolved

Be sure to copy down the password for the `elastic` user and Cloud ID information. You'll need that later.

[float]
=== Hands-on experience
[[get-data-in]]
== Get data into {kib}

The following tutorials walk you through searching, analyzing,
and visualizing data.
Before you create visualizations and analyze your data, you must get the data into {kib}.
KOTungseth marked this conversation as resolved.
Show resolved Hide resolved

* <<tutorial-sample-data, Explore Kibana using sample data>>. You'll
learn to filter and query data, edit visualizations, and interact with dashboards.
The easiest way to get data into {kib} is to add a sample data set. {kib} has several sample data sets that you can use before loading your own data.

* <<tutorial-build-dashboard, Build your own dashboard>>. You'll manually load a data set and build
your own visualizations and dashboard.
These sample data sets showcase a variety of use cases:
KOTungseth marked this conversation as resolved.
Show resolved Hide resolved

[float]
=== Before you begin
* *Sample eCommerce orders* includes visualizations for tracking product-related information,
such as cost, revenue, and price.

Make sure you've <<install, installed Kibana>> and established
a <<connect-to-elasticsearch, connection to Elasticsearch>>.
* *Sample flight data* includes visualizations for monitoring flight routes.

If you are running our https://cloud.elastic.co[hosted Elasticsearch Service]
on Elastic Cloud, you can access Kibana with a single click.
* *Sample web logs* includes visualizations for monitoring website traffic.

To use the sample data sets:

--
. Go to the {kib} home page.

. Click *Load a data set and a {kib} dashboard*.

. Click *View data* and view the prepackaged dashboards, maps, and more.

[role="screenshot"]
image::images/add-sample-data.png[]

include::{kib-repo-dir}/getting-started/add-sample-data.asciidoc[]
NOTE: The timestamps in the sample data sets are relative to when they are installed.
If you uninstall and reinstall a data set, the timestamps change to reflect the most recent installation.

[float]
[[getting-started-next-steps]]
== Next steps

* To get a hands-on experience using the sample flight data, follow the <<tutorial-sample-data, add sample data>> tutorial.
KOTungseth marked this conversation as resolved.
Show resolved Hide resolved

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe here add a bullet point about the add data tutorial

  • To quickly set up a data flow in the Elastic Stack, use our Add data tutorials, available from the home page.

* If you're ready to load an actual data set and build a dashboard, follow the <<tutorial-build-dashboard, build your own dashboard>> tutorial.

--

include::{kib-repo-dir}/getting-started/tutorial-sample-data.asciidoc[]

Expand All @@ -62,4 +73,3 @@ include::{kib-repo-dir}/getting-started/tutorial-discovering.asciidoc[]
include::{kib-repo-dir}/getting-started/tutorial-visualizing.asciidoc[]

include::{kib-repo-dir}/getting-started/tutorial-dashboard.asciidoc[]

4 changes: 2 additions & 2 deletions docs/user/index.asciidoc
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
include::introduction.asciidoc[]

include::getting-started.asciidoc[]

include::setup.asciidoc[]

include::monitoring/configuring-monitoring.asciidoc[]

include::security/securing-kibana.asciidoc[]

include::getting-started.asciidoc[]

include::discover.asciidoc[]

include::visualize.asciidoc[]
Expand Down