WARNING: Version 5.2 of Kibana has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Discovering Your Data Putting it all Together with Dashboards »
Elastic Docs ›Kibana User Guide [5.2] ›Getting Started

Visualizing Your Data

edit

Visualizing Your Data

edit

To start visualizing your data, click Visualize in the side navigation:

tutorial visualize

The Visualize tools enable you to view your data in several ways. For example, let’s use that venerable visualization, the pie chart, to get some insight into the account balances in the sample bank account data.

To get started, click Pie chart in the list of visualizations. You can build visualizations from saved searches, or enter new search criteria. To enter new search criteria, you first need to select an index pattern to specify what indices to search. We want to search the account data, so select the ba* index pattern.

The default search matches all documents. Initially, a single "slice" encompasses the entire pie:

tutorial visualize pie 1

To specify what slices to display in the chart, you use an Elasticsearch bucket aggregation. A bucket aggregation simply sorts the documents that match your search criteria into different categories, aka buckets. For example, the account data includes the balance of each account. Using a bucket aggregation, you can establish multiple ranges of account balances and find out how many accounts fall into each range.

To define a bucket for each range:

  1. Click the Split Slices buckets type.
  2. Select Range from the Aggregation list.
  3. Select the balance field from the Field list.
  4. Click Add Range four times to bring the total number of ranges to six.

  5. Define the following ranges:

    0             999
1000         2999
3000         6999
7000        14999
15000       30999
31000       50000
  6. Click Apply changes apply changes button to update the chart.

Now you can see what proportion of the 1000 accounts fall into each balance range.

tutorial visualize pie 2

Let’s take a look at another dimension of the data: the account holder’s age. By adding another bucket aggregation, you can see the ages of the account holders in each balance range:

  1. Click Add sub-buckets below the buckets list.
  2. Click Split Slices in the buckets type list.
  3. Select Terms from the aggregation list.
  4. Select age from the field list.
  5. Click Apply changes apply changes button.

Now you can see the break down of the account holders' ages displayed in a ring around the balance ranges.

tutorial visualize pie 3

To save this chart so we can use it later, click Save and enter the name Pie Example.

Next, we’re going to look at data in the Shakespeare data set. Let’s find out how the plays compare when it comes to the number of speaking parts and display the information in a bar chart:

  1. Click New and select Vertical bar chart.

  2. Select the shakes* index pattern. Since you haven’t defined any buckets yet, you’ll see a single big bar that shows the total count of documents that match the default wildcard query.

    tutorial visualize bar 1
  3. To show the number of speaking parts per play along the y-axis, you need to configure the Y-axis metric aggregation. A metric aggregation computes metrics based on values extracted from the search results. To get the number of speaking parts per play, select the Unique Count aggregation and choose speaker from the field list. You can also give the axis a custom label, Speaking Parts.
  4. To show the different plays long the x-axis, select the X-Axis buckets type, select Terms from the aggregation list, and choose play_name from the field list. To list them alphabetically, select Ascending order. You can also give the axis a custom label, Play Name.
  5. Click Apply changes apply changes button to view the results.
tutorial visualize bar 2

Notice how the individual play names show up as whole phrases, instead of being broken down into individual words. This is the result of the mapping we did at the beginning of the tutorial, when we marked the play_name field as not analyzed.

Hovering over each bar shows you the number of speaking parts for each play as a tooltip. To turn tooltips off and configure other options for your visualizations, select the Visualization builder’s Options tab.

Now that you have a list of the smallest casts for Shakespeare plays, you might also be curious to see which of these plays makes the greatest demands on an individual actor by showing the maximum number of speeches for a given part.

  1. Click Add metrics to add a Y-axis aggregation.
  2. Choose the Max aggregation and select the speech_number field.
  3. Click Options and change the Bar Mode to grouped.
  4. Click Apply changes apply changes button. Your chart should now look like this:
tutorial visualize bar 3

As you can see, Love’s Labours Lost has an unusually high maximum speech number, compared to the other plays, and might therefore make more demands on an actor’s memory.

Note how the Number of speaking parts Y-axis starts at zero, but the bars don’t begin to differentiate until 18. To make the differences stand out, starting the Y-axis at a value closer to the minimum, go to Options and select Scale Y-Axis to data bounds.

Save this chart with the name Bar Example.

Next, we’re going to use a tile map chart to visualize geographic information in our log file sample data.

  1. Click New.
  2. Select Tile map.
  3. Select the logstash-* index pattern.
  4. Set the time window for the events we’re exploring:
  5. Click the time picker in the Kibana toolbar.
  6. Click Absolute.

  7. Set the start time to May 18, 2015 and the end time to May 20, 2015.

    tutorial timepicker
  8. Once you’ve got the time range set up, click the Go button and close the time picker by clicking the small up arrow in the bottom right corner.

You’ll see a map of the world, since we haven’t defined any buckets yet:

tutorial visualize map 1

To map the geo coordinates from the log files select Geo Coordinates as the bucket and click Apply changes apply changes button. Your chart should now look like this:

tutorial visualize map 2

You can navigate the map by clicking and dragging, zoom with the viz zoom buttons, or hit the Fit Data Bounds viz fit bounds button to zoom to the lowest level that includes all the points. You can also include or exclude a rectangular area by clicking the Latitude/Longitude Filter viz lat long filter button and drawing a bounding box on the map. Applied filters are displayed below the query bar. Hovering over a filter displays controls to toggle, pin, invert, or delete the filter.

tutorial visualize map 3

Save this map with the name Map Example.

Finally, create a Markdown widget to display extra information:

  1. Click New.
  2. Select Markdown widget.

  3. Enter the following text in the field:

    # This is a tutorial dashboard!
The Markdown widget uses **markdown** syntax.
> Blockquotes in Markdown use the > character.

  4. Click Apply changes apply changes button render the Markdown in the preview pane.

    tutorial visualize md 1
tutorial visualize md 2

Save this visualization with the name Markdown Example.

« Discovering Your Data Putting it all Together with Dashboards »