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] Updates images and content in Dashboard docs #42500

Merged
merged 3 commits into from
Aug 2, 2019
Merged
Show file tree
Hide file tree
Changes from 1 commit
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
163 changes: 94 additions & 69 deletions docs/dashboard.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,66 +3,86 @@

[partintro]
--
A Kibana _dashboard_ displays a collection of visualizations, searches, and {kibana-ref}/maps.html[maps].
You can arrange, resize, and edit the dashboard content and then save the dashboard
so you can share it.

[role="screenshot"]
image:images/Dashboard_example.png[Example dashboard]
A {kib} _dashboard_ is a collection of visualizations, searches, and
maps, typically in real-time. Dashboards provide
at-a-glance insights into your data and enable you to drill down into details.

--
To start working with dashboards, click *Dashboard* in the side navigation.
You can:
Copy link
Contributor

Choose a reason for hiding this comment

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

How about:

With dashboards, you can:


[[dashboard-getting-started]]
== Building a Dashboard
* <<dashboard-create-new-dashboard, Create a dashboard>>
* <<customizing-your-dashboard, Arrange dashboard elements>>
* <<sharing-dashboards, Share a dashboard>>
* <<import-dashboards, Import and export dashboards>>
* <<viewing-detailed-information, Inspect and edit dashboard elements>>


[role="screenshot"]
image:images/Dashboard_example.png[Example dashboard]

If you haven't yet indexed data into {es} or created an index pattern,
you'll be prompted to do so as you follow the steps for creating a dashboard.
Or, you can use one of the prebuilt sample data sets, available from the
Kibana home page.

[float]
[[dashboard-read-only-access]]
=== [xpack]#Read only access#
Copy link
Contributor

Choose a reason for hiding this comment

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

Totally outside the parameters of this PR, but could we make this an attribute? I've been sticking this text in my PRs too, so I'm wondering if we could keep and maintain it in one place?

When you have insufficient privileges to create or save dashboards, the following
indicator in Kibana will be displayed. The buttons to create new dashboards or edit
existing dashboard won't be visible. For more information on granting access to
Kibana see <<xpack-security-authorization>>.
If you see
the read-only icon in the application header,
then you don't have sufficient privileges to create and save dashboards. The buttons to create and edit
dashboards are not visible. For more information, see <<xpack-security-authorization>>.

[role="screenshot"]
image::images/dashboard-read-only-badge.png[Example of Dashboard's read only access indicator in Kibana's header]

[float]
[[dashboard-getting-started]]
=== Interact with dashboards

When you open *Dashhboard*, you're presented an overview of your dashboards.
If you don't have any dashboards, you can add
<<add-sample-data, sample data sets>>,
Copy link
Contributor

Choose a reason for hiding this comment

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

How about:
...you can add sample data sets and check out the pre-built dashboards.

or:

you can add sample data sets, or checkout the pre-built dashboards.

and check out the pre-built dashboards.

Once you open a dashboard, you can filter the data
by entering a search query, changing the time filter, or clicking
in the visualization, search, or map. If a dashboard element has a stored query,
Copy link
Contributor

Choose a reason for hiding this comment

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

wouldn't that be "clicking in a visualization, search, or map" or "clicking in the visualizations, searches, or maps"?

both queries are applied.

Actions for using fullscreen mode and sharing, cloning, and editing the dashboard
are in the upper left.

--

[[dashboard-create-new-dashboard]]
=== Creating a new Dashboard
== Create a dashboard

To create a dashboard, you must have data indexed into {es}, an index pattern
to retrieve the data from Elasticsearch, and
visualizations, saved searches, or maps. If these don't exist, you're prompted to
add them as you create the dashboard.

For an end-to-end example, see <<tutorial-build-dashboard, Building your own dashboard>>.

. In the side navigation, click *Dashboard*.
. Open *Dashboard.*
. Click *Create new dashboard.*
. Click *Add*.
. [[adding-visualizations-to-a-dashboard]]Use *Add Panels* to add visualizations
and saved searches to the dashboard. If you have a large number of
visualizations, you can filter the lists.
. Use *Add panels* to add elements to the dashboard.
+
The visualizations, saved searches, and maps
are stored in panels that you can move, resize,
and customize in the dashboard. You can add elements from
multiple indices, and the same element can appear in multiple dashboards.
+
[role="screenshot"]
image:images/Dashboard_add_visualization.png[Example add visualization to dashboard]

. [[saving-dashboards]]When you're finished adding and arranging the panels,
go to the menu bar and click *Save*.

. In *Save Dashboard*, enter a dashboard title and optionally a description.

. To store the time period specified in the time filter, enable *Store time
with dashboard*.

. Click *Save*.

[[loading-a-saved-dashboard]]
To import, export, and delete dashboards, see <<managing-saved-objects>>.
. When you're finished adding and arranging the panels,
*Save* the dashboard.

[float]
[[customizing-your-dashboard]]
== Arranging Dashboard Elements
=== Arrange dashboard elements

The visualizations and searches in a dashboard are stored in panels that you can move,
resize, edit, and delete. To start editing, click *Edit* in the menu bar.
In *Edit* mode, you can move, resize, customize, and delete the panels to suit your needs.

[[moving-containers]]
* To move a panel, click and hold the panel header and drag to the new location.
Expand All @@ -71,53 +91,58 @@ resize, edit, and delete. To start editing, click *Edit* in the menu bar.
* To resize a panel, click the resize control on the lower right and drag
to the new dimensions.

[[removing-containers]]
Additional commands for managing the panel and its contents
are in the gear menu in the upper right.
* To toggle the use of margins and panel titles, use the *Options* menu in the upper left.

[role="screenshot"]
image:images/Dashboard_Resize_Menu.png[Example dashboard]

NOTE: Deleting a panel from a
* To delete a panel, open the panel menu and select *Delete from dashboard.* Deleting a panel from a
dashboard does *not* delete the saved visualization or search.

[[viewing-detailed-information]]
== Inspecting a Visualization from the Dashboard

Many visualizations allow you to inspect the data and requests behind the
visualization.
[float]
[[sharing-dashboards]]
=== Share a dashboard

In the dashboard, expand the visualization's panel menu (or gear menu if in
*Edit* mode) and select *Inspect*.
[[embedding-dashboards]]
When you've finished your dashboard, you can share it with your teammates.
From the *Share* menu, you can:

The initial view shows the underlying data for the visualization. To view the
requests that were made for the visualization, choose *Requests* from the *View*
menu.
* Embed the code in a web page. Users must have Kibana access
to view an embedded dashboard.
* Share a direct link to a {kib} dashboard
* Generate a PDF report
* Generate a PNG report

TIP: You can create a link to a dashboard by title by doing this: +
`${domain}/${basepath?}/app/kibana#/dashboards?title=${yourdashboardtitle}`

TIP: When sharing a link to a dashboard snapshot, use the *Short URL*. Snapshot
URLs are long and can be problematic for Internet Explorer and other
tools. To create a short URL, you must have write access to {kib}.
Copy link
Contributor

Choose a reason for hiding this comment

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

Double Space: "tools. To" (though I think asciidoc will ignore those?


[float]
[[import-dashboards]]
=== Import and export dashboards

The views you'll see depend on the element that you inspect.
To import and export dashboards, go to *Management > Saved Objects*. For details,
see <<managing-saved-objects, Managing saved objects>>.

[float]
[[viewing-detailed-information]]
=== Inspect and edit elements

Many dashboard elements allow you to drill down into the data and requests
behind the element. Open the panel menu for the element and select *Inspect*.
The views you see depend on the element that you inspect.

[role="screenshot"]
image:images/Dashboard_visualization_data.png[Example of visualization data]
image:images/Dashboard_inspect.png[Inspect in dashboard]

To open an element for editing, put the dashboard in *Edit* mode,
and then select *Edit* from the panel menu. The changes you make appear in
every dashboard that uses the element.


[[sharing-dashboards]]
== Sharing a Dashboard

You can either share a direct link to a Kibana dashboard,
or embed the dashboard in a web page. Users must have Kibana access
to view an embedded dashboard.

[[embedding-dashboards]]

. Open the dashboard you want to share.
. In the menu bar, click *Share*.
. Copy the link you want to share or the iframe you want to embed. You can
share the live dashboard or a static snapshot of the current point in time.

TIP: You can create a link to a dashboard by title by doing this: +
`${domain}/${basepath?}/app/kibana#/dashboards?title=${yourdashboardtitle}`

TIP: When sharing a link to a dashboard snapshot, use the *Short URL*. Snapshot
URLs are long and can be problematic for Internet Explorer and other
tools. To create a short URL, you must have write access to {kib}.
Binary file modified docs/images/Dashboard_Resize_Menu.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/Dashboard_add_visualization.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/Dashboard_example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/Dashboard_inspect.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.