Canvas is a data visualization and presentation tool that allows you to pull live data from Elasticsearch, then combine the data with colors, images, text, and your imagination to create dynamic, multi-page, pixel-perfect displays. If you are a little bit creative, a little bit technical, and a whole lot curious, then Canvas is for you.
With Canvas, you can:
- Create and personalize your work space with backgrounds, borders, colors, fonts, and more.
- Customize your workpad with your own visualizations, such as images and text.
- Pull your data directly from Elasticsearch, then show it off with charts, graphs, progress monitors, and more.
- Focus the data you want to display with filters.
A workpad provides you with a space where you can build presentations of your live data. You can create a workpad from scratch, start with a preconfigured workpad, import an existing workpad, or use a sample data workpad.
To create workpads, you must meet the minimum requirements.
- If you need to set up Kibana, use our free trial.
- Make sure you have data indexed into Elasticsearch and an index pattern.
- Have an understanding of Elasticsearch documents and indices.
- Make sure you have sufficient privileges to create and save workpads. When the read-only indicator appears, you have insufficient privileges, and the options to create and save workpads are unavailable. For more information, refer to Granting access to Kibana.
To open Canvas, open the main menu, then click Canvas.
Start with a blank workpadedit
To use the background colors, images, and data of your choice, start with a blank workpad.
- On the Canvas workpads page, click Create workpad.
Specify the Workpad settings.
- Add a Name to your workpad.
- In the Width and Height fields, specify the size, or select one of default layouts.
- Click the Background color picker, then select the color for your workpad.
Create workpads from templatesedit
If you’re unsure about where to start, you can use one of the preconfigured templates that come with Canvas.
- On the Canvas workpads page, select Templates.
- Click the preconfigured template that you want to use.
- Add your own Name to the workpad.
Import existing workpadsedit
When you want to use a workpad that someone else has already started, import the JSON file.
To begin, drag the file to the Import workpad JSON file field on the Canvas workpads page.
Use sample data workpadsedit
Each of the Kibana sample data sets comes with a workpad that you can use for your own workpad inspiration.
- Add a sample data set.
- On the Add Data page, click View data, then select Canvas.
Create a story about your data by adding elements to your workpad that include images, text, charts, and more.
Choose the type of element you want to use, then use the preconfigured demo data to familiarize yourself with the element. When you’re ready, connect the element to your own data. By default, most of the elements you create use the 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.
- Click Add element, then select the element you want to use.
To connect the element to your data, select Data, then select one of the following data sources:
- Elasticsearch SQL — Access your data in Elasticsearch using SQL syntax.
- Elasticsearch documents — Access your data in Elasticsearch without using aggregations. To use, select an index and fields, and optionally enter a query using the Lucene Query Syntax. Use the Elasticsearch documents data source when you have low volume datasets, to view raw documents, or to plot exact, non-aggregated values on a chart.
Each element can display a different data source, and pages and workpads often contain multiple data sources.
To save, use the following options:
- To save a single element, select the element, then click Edit > Save as new element.
- 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.
Add panels from the Visualize Libraryedit
Add a panel that you saved in Visualize Library to your workpad.
- Click Add element > Add from Kibana.
- Select the panel you want to add.
To use the customization options, open the panel menu, then select one of the following options:
- Edit map — Opens Maps so that you can edit the panel.
- Edit visualization — Opens the visualization editor so that you can edit the panel.
- Edit panel title — Allows you to change the panel title.
- Customize time range — Allows you to change the time filter dedicated to the panel.
- Inspect — Allows you to drill down into the panel data.
Add your own imagesedit
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.
Organize and separate your ideas by adding more pages.
- Click Page 1, then click +.
On the Page editor panel, select the page transition from the Transition dropdown.
Share your workpadedit
To share workpads with a larger audience, click Share in the toolbar. For detailed information about the sharing options, refer to Reporting.
Want to export multiple workpads? Go to the Canvas home page, select the workpads you want to export, then click Export.