kibana/docs/dashboard.asciidoc

117 lines
4.6 KiB
Plaintext

[float]
[[dashboard]]
== Dashboard
A Kibana _dashboard_ displays saved visualizations in groups that you can arrange. You can save a dashboard to share or
reload at a later time.
[float]
[[getting-started]]
=== Getting Started
You need at least one saved <<visualize, visualization>> to use a dashboard.
[float]
[[creating-a-new-dashboard]]
==== Creating a New Dashboard
The first time you click the *Dashboard* tab, Kibana displays an empty dashboard.
image:images/NewDashboard.png[New Dashboard screen]
Add visualizations to start creating your dashboard.
[float]
[[adding-visualizations-to-a-dashboard]]
==== Adding Visualizations to a Dashboard
To add a visualization to the dashboard, click the *Add Visualization* image:images/AddVis.png[Plus] button in the
toolbar panel. Select a saved visualization from the list. You can filter the list of visualizations by typing a filter
string into the *Visualization Filter* field.
The visualization you select appears in a _container_ on your dashboard.
*NOTE:* If you see a message about the container's height or width being too small, <<resizing-containers,resize the
container>>.
[float]
[[saving-dashboards]]
==== Saving Dashboards
To save the dashboard, click the *Save Dashboard* button in the toolbar panel, enter a name for the dashboard in the *Save As* field, and click the *Save* button.
[float]
[[loading-a-saved-dashboard]]
==== Loading a Saved Dashboard
Click the *Load Saved Dashboard* button to display a list of existing dashboards. The saved dashboard selector includes a text field to filter by dashboard name and a link to the Object Editor, accessible through *Settings > Edit Saved
Objects*, to manage your saved dashboards.
[float]
[[sharing-dashboards]]
==== Sharing Dashboards
Click the *Share* button to display HTML code to embed the dashboard in another Web page, along with a direct link to the dashboard. Click the copy button image:images/Clipboard.png[Copy to Clipboard button] next to either option to copy the code or the link to your clipboard.
[float]
[[embedding-dashboards]]
==== Embedding Dashboards
To embed a dashboard, copy the embed code from the _Share_ display into your external web application.
NOTE: A user must have Kibana access in order to view embedded dashboards.
[float]
[[customizing-your-dashboard]]
=== Customizing Dashboard Elements
The visualizations in your dashboard are stored in _containers_. This section discusses customizing these containers.
[float]
[[moving-containers]]
==== Moving Containers
Click and hold a container's header to move the container around the dashboard. Other containers will shift as needed
to make room for the moving container. Release the mouse button to confirm the container's new location.
[float]
[[resizing-containers]]
==== Resizing Containers
Move the cursor to the bottom right corner of the container until the cursor changes to point at the corner. After the
cursor changes, click and drag the corner of the container to change the container's size. Release the mouse button to
confirm the new container size.
// enhancement request: a way to specify specific dimensions for a container in pixels, or at least display that info?
[float]
[[removing-containers]]
==== Removing Containers
Click the *x* icon at the top right corner of a container to remove that container from the dashboard. Removing a container from a dashboard does not affect the saved visualization in that container.
[float]
[[viewing-detailed-information]]
==== Viewing Detailed Information
To display the data that creates the visualization, click the bar at the bottom of the container. The raw data
replaces the visualization with four tabs with detailed information about the data, as in this example:
[horizontal]
*Table*:: A representation of the underlying data, presented as a paginated data grid. You can sort the items
in the table by clicking on the table headers at the top of each column.
image:images/NYCTA-Table.png[]
*Request*:: The raw request used to query the server, presented in JSON format.
image:images/NYCTA-Request.png[]
*Response*:: The raw response from the server, presented in JSON format.
image:images/NYCTA-Response.png[]
*Statistics*:: A summary of the statistics related to the request and the response, presented as a data grid. The data
grid includes the query duration, the request duration, the total number of records found on the server, and the
index pattern used to make the query.
image:images/NYCTA-Statistics.png[]
[float]
[[changing-the-visualization]]
=== Changing the Visualization
Click the _Edit_ button image:images/EditVis.png[Pencil button] at the top right of a container to open the visualization in the <<visualize,Visualize>> app.