-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[DOCS] Dashboard-first docs refresh (#76194)
* [DOCS] Dashboard-first refresh * Fixes broken links and partinto error * Fixes images in panel table * Fixes broken links * Fixes broken drilldowns link * Fixes images and table * Removed un needed files and added edit content * Update docs/getting-started/tutorial-visualizing.asciidoc Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com> * Review comments * Review comments * Removed blocks * Typo fix * Update docs/getting-started/tutorial-sample-data.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-discovering.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-sample-data.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/getting-started/tutorial-visualizing.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/edit-dashboards.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/dashboard.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/dashboard.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Update docs/user/dashboard/aggregation-reference.asciidoc Co-authored-by: Wylie Conlon <wylieconlon@gmail.com> * Review comments Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com> Co-authored-by: Wylie Conlon <wylieconlon@gmail.com>
- Loading branch information
1 parent
60986d4
commit c84532a
Showing
87 changed files
with
2,309 additions
and
2,305 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,167 @@ | ||
[role="xpack"] | ||
[[add-canvas-elements]] | ||
=== Add elements | ||
|
||
Create a story about your data by adding elements to your workpad that include images, text, charts, and more. You can create your own elements and connect them to your data sources, add saved objects, and add your own images. | ||
|
||
[float] | ||
[[create-canvas-element]] | ||
==== Create an element | ||
|
||
Choose the type of element you want to use, then connect it to your own data. | ||
|
||
. Click *Add element*, then select the element you want to use. | ||
+ | ||
[role="screenshot"] | ||
image::images/canvas-element-select.gif[Canvas elements] | ||
|
||
. To familiarize yourself with the element, use the preconfigured data demo data. | ||
+ | ||
By default, most of the elements you create use demo data until you change the data source. The demo data includes a small data set that you can use to experiment with your element. | ||
|
||
. To connect the element to your data, select *Data*, then select one of the following data sources: | ||
|
||
* *{es} SQL* — Access your data in {es} using SQL syntax. For information about SQL syntax, refer to {ref}/sql-spec.html[SQL language]. | ||
|
||
* *{es} documents* — Access your data in {es} without using aggregations. To use, select an index and fields, and optionally enter a query using the <<lucene-query,Lucene Query Syntax>>. Use the *{es} documents* data source when you have low volume datasets, to view raw documents, or to plot exact, non-aggregated values on a chart. | ||
|
||
* *Timelion* — Access your time series data using <<timelion,Timelion>> queries. To use Timelion queries, you can enter a query using the <<lucene-query,Lucene Query Syntax>>. | ||
|
||
Each element can display a different data source. Pages and workpads often contain multiple data sources. | ||
|
||
[float] | ||
[[canvas-add-object]] | ||
==== Add a saved object | ||
|
||
Add <<managing-saved-objects,saved objects>> to your workpad, such as maps and visualizations. | ||
|
||
. Click *Add element > Add from Visualize Library*. | ||
|
||
. Select the saved object you want to add. | ||
+ | ||
[role="screenshot"] | ||
image::images/canvas-map-embed.gif[] | ||
|
||
. To use the customization options, click the panel menu, then select one of the following options: | ||
|
||
* *Edit map* — Opens <<maps,Maps>> or <<create-panels,Dashboard>> so that you can edit the original saved object. | ||
|
||
* *Edit panel title* — Adds a title to the saved object. | ||
|
||
* *Customize time range* — Exposes a time filter dedicated to the saved object. | ||
|
||
* *Inspect* — Allows you to drill down into the element data. | ||
|
||
[float] | ||
[[canvas-add-image]] | ||
==== Add your own image | ||
|
||
To personalize your workpad, add your own logos and graphics. | ||
|
||
. Click *Add element > Manage assets*. | ||
|
||
. On the *Manage workpad assets* window, drag and drop your images. | ||
|
||
. To add the image to the workpad, click the *Create image element* icon. | ||
+ | ||
[role="screenshot"] | ||
image::images/canvas-add-image.gif[] | ||
|
||
[float] | ||
[[move-canvas-elements]] | ||
==== Organize elements | ||
|
||
Move and resize your elements to meet your design needs. | ||
|
||
* To move, click and hold the element, then drag to the new location. | ||
|
||
* To move by 1 pixel, select the element, press and hold Shift, then use your arrow keys. | ||
|
||
* To move by 10 pixels, select the element, then use your arrow keys. | ||
|
||
* To resize, click and drag the resize handles to the new dimensions. | ||
|
||
[float] | ||
[[format-canvas-elements]] | ||
==== Format elements | ||
|
||
For consistency and readability across your workpad pages, align, distribute, and reorder elements. | ||
|
||
To align two or more elements: | ||
|
||
. Press and hold Shift, then select the elements you want to align. | ||
|
||
. Click *Edit > Alignment*, then select the alignment option. | ||
|
||
To distribute three or more elements: | ||
|
||
. Press and hold Shift, then select the elements you want to distribute. | ||
|
||
. Click *Edit > Distribution*, then select the distribution option. | ||
|
||
To reorder elements: | ||
|
||
. Select the element you want to reorder. | ||
|
||
. Click *Edit > Order*, then select the order option. | ||
|
||
[float] | ||
[[data-display]] | ||
==== Change the element display options | ||
|
||
Each element has its own display options to fit your design needs. | ||
|
||
To choose the display options, click *Display*, then make your changes. | ||
|
||
To define the appearance of the container and border: | ||
|
||
. Next to *Element style*, click *+*, then select *Container style*. | ||
|
||
. Expand *Container style*. | ||
|
||
. Change the *Appearance* and *Border* options. | ||
|
||
To apply CSS overrides: | ||
|
||
. Next to *Element style*, click *+*, then select *CSS*. | ||
|
||
. Enter the *CSS*. | ||
+ | ||
For example, to center the Markdown element, enter: | ||
+ | ||
[source,text] | ||
-------------------------------------------------- | ||
.canvasRenderEl h1 { | ||
text.align: center; | ||
} | ||
-------------------------------------------------- | ||
|
||
. Click *Apply stylesheet*. | ||
|
||
[float] | ||
[[save-elements]] | ||
==== Save elements | ||
|
||
To use the elements across all workpads, save the elements. | ||
|
||
When you're ready to save your element, select the element, then click *Edit > Save as new element*. | ||
|
||
[role="screenshot"] | ||
image::images/canvas_save_element.png[] | ||
|
||
To save a group of elements, press and hold Shift, select the elements you want to save, then click *Edit > Save as new element*. | ||
|
||
To access your saved elements, click *Add element > My elements*. | ||
|
||
[float] | ||
[[delete-elements]] | ||
==== Delete elements | ||
|
||
When you no longer need an element, delete it from your workpad. | ||
|
||
. Select the element you want to delete. | ||
|
||
. Click *Edit > Delete*. | ||
+ | ||
[role="screenshot"] | ||
image::images/canvas_element_options.png[] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.