2015-04-01 23:39:33 +02:00
|
|
|
[[pie-chart]]
|
2016-10-25 03:41:32 +02:00
|
|
|
== Pie Charts
|
2015-03-09 06:30:42 +01:00
|
|
|
|
2016-06-30 23:32:21 +02:00
|
|
|
The slice size of a pie chart is determined by the _metrics_ aggregation. The following aggregations are available for
|
2015-03-09 06:30:42 +01:00
|
|
|
this axis:
|
|
|
|
|
2017-06-27 19:13:42 +02:00
|
|
|
*Count*:: The {ref}/search-aggregations-metrics-valuecount-aggregation.html[_count_] aggregation returns a raw count of
|
2015-03-09 06:30:42 +01:00
|
|
|
the elements in the selected index pattern.
|
2017-06-27 19:13:42 +02:00
|
|
|
*Sum*:: The {ref}/search-aggregations-metrics-sum-aggregation.html[_sum_] aggregation returns the total sum of a numeric
|
2015-03-09 06:30:42 +01:00
|
|
|
field. Select a field from the drop-down.
|
2017-06-27 19:13:42 +02:00
|
|
|
*Unique Count*:: The {ref}/search-aggregations-metrics-cardinality-aggregation.html[_cardinality_] aggregation returns
|
2015-03-09 06:30:42 +01:00
|
|
|
the number of unique values in a field. Select a field from the drop-down.
|
|
|
|
|
2016-03-17 01:22:19 +01:00
|
|
|
Enter a string in the *Custom Label* field to change the display label.
|
|
|
|
|
2015-03-09 06:30:42 +01:00
|
|
|
The _buckets_ aggregations determine what information is being retrieved from your data set.
|
|
|
|
|
|
|
|
Before you choose a buckets aggregation, specify if you are splitting slices within a single chart or splitting into
|
2016-06-30 23:32:21 +02:00
|
|
|
multiple charts. A multiple chart split must run before any other aggregations. When you split a chart, you can change
|
2015-03-09 06:30:42 +01:00
|
|
|
if the splits are displayed in a row or a column by clicking the *Rows | Columns* selector.
|
|
|
|
|
|
|
|
You can specify any of the following bucket aggregations for your pie chart:
|
|
|
|
|
2017-06-27 19:13:42 +02:00
|
|
|
*Date Histogram*:: A {ref}/search-aggregations-bucket-datehistogram-aggregation.html[_date histogram_] is built from a
|
2016-06-30 23:32:21 +02:00
|
|
|
numeric field and organized by date. You can specify a time frame for the intervals in seconds, minutes, hours, days,
|
|
|
|
weeks, months, or years. You can also specify a custom interval frame by selecting *Custom* as the interval and
|
|
|
|
specifying a number and a time unit in the text field. Custom interval time units are *s* for seconds, *m* for minutes,
|
|
|
|
*h* for hours, *d* for days, *w* for weeks, and *y* for years. Different units support different levels of precision,
|
2017-08-23 05:42:36 +02:00
|
|
|
down to one second. Intervals are labeled at the start of the interval, using the date-key returned by Elasticsearch.
|
|
|
|
For example, the tooltip for a monthly interval will show the first day of the month.
|
2017-06-27 19:13:42 +02:00
|
|
|
*Histogram*:: A standard {ref}/search-aggregations-bucket-histogram-aggregation.html[_histogram_] is built from a
|
2016-06-30 23:32:21 +02:00
|
|
|
numeric field. Specify an integer interval for this field. Select the *Show empty buckets* checkbox to include empty
|
2015-03-09 06:30:42 +01:00
|
|
|
intervals in the histogram.
|
2017-06-27 19:13:42 +02:00
|
|
|
*Range*:: With a {ref}/search-aggregations-bucket-range-aggregation.html[_range_] aggregation, you can specify ranges
|
2016-06-30 23:32:21 +02:00
|
|
|
of values for a numeric field. Click *Add Range* to add a set of range endpoints. Click the red *(x)* symbol to remove
|
2015-03-09 06:30:42 +01:00
|
|
|
a range.
|
2017-06-27 19:13:42 +02:00
|
|
|
*Date Range*:: A {ref}/search-aggregations-bucket-daterange-aggregation.html[_date range_] aggregation reports values
|
2016-06-30 23:32:21 +02:00
|
|
|
that are within a range of dates that you specify. You can specify the ranges for the dates using
|
2017-06-27 19:13:42 +02:00
|
|
|
{ref}/common-options.html#date-math[_date math_] expressions. Click *Add Range* to add a set of range endpoints.
|
2015-05-12 06:03:19 +02:00
|
|
|
Click the red *(/)* symbol to remove a range.
|
2017-06-27 19:13:42 +02:00
|
|
|
*IPv4 Range*:: The {ref}/search-aggregations-bucket-iprange-aggregation.html[_IPv4 range_] aggregation enables you to
|
2016-06-30 23:32:21 +02:00
|
|
|
specify ranges of IPv4 addresses. Click *Add Range* to add a set of range endpoints. Click the red *(/)* symbol to
|
2015-05-12 06:03:19 +02:00
|
|
|
remove a range.
|
2017-06-27 19:13:42 +02:00
|
|
|
*Terms*:: A {ref}/search-aggregations-bucket-terms-aggregation.html[_terms_] aggregation enables you to specify the top
|
2015-03-09 06:30:42 +01:00
|
|
|
or bottom _n_ elements of a given field to display, ordered by count or a custom metric.
|
2017-06-27 19:13:42 +02:00
|
|
|
*Filters*:: You can specify a set of {ref}/search-aggregations-bucket-filters-aggregation.html[_filters_] for the data.
|
2016-06-30 23:32:21 +02:00
|
|
|
You can specify a filter as a query string or in JSON format, just as in the Discover search bar. Click *Add Filter* to
|
|
|
|
add another filter. Click the image:images/labelbutton.png[] *label* button to open the label field, where you can type
|
2015-09-04 23:35:37 +02:00
|
|
|
in a name to display on the visualization.
|
2016-06-30 23:32:21 +02:00
|
|
|
*Significant Terms*:: Displays the results of the experimental
|
2017-06-27 19:13:42 +02:00
|
|
|
{ref}/search-aggregations-bucket-significantterms-aggregation.html[_significant terms_] aggregation. The value of the
|
2015-03-09 06:30:42 +01:00
|
|
|
*Size* parameter defines the number of entries this aggregation returns.
|
|
|
|
|
2016-06-30 23:32:21 +02:00
|
|
|
After defining an initial bucket aggregation, you can define sub-buckets to refine the visualization. Click *+ Add
|
|
|
|
sub-buckets* to define a sub-aggregation, then choose *Split Slices* to select a sub-bucket from the list of
|
2015-03-09 06:30:42 +01:00
|
|
|
types.
|
|
|
|
|
2016-06-30 23:32:21 +02:00
|
|
|
When multiple aggregations are defined on a chart's axis, you can use the up or down arrows to the right of the
|
2015-03-09 06:30:42 +01:00
|
|
|
aggregation's type to change the aggregation's priority.
|
|
|
|
|
2016-01-16 03:15:29 +01:00
|
|
|
include::color-picker.asciidoc[]
|
|
|
|
|
2016-03-17 01:22:19 +01:00
|
|
|
Enter a string in the *Custom Label* field to change the display label.
|
|
|
|
|
2015-03-09 06:30:42 +01:00
|
|
|
You can click the *Advanced* link to display more customization options for your metrics or bucket aggregation:
|
|
|
|
|
|
|
|
*Exclude Pattern*:: Specify a pattern in this field to exclude from the results.
|
|
|
|
*Include Pattern*:: Specify a pattern in this field to include in the results.
|
2016-06-30 23:32:21 +02:00
|
|
|
*JSON Input*:: A text field where you can add specific JSON-formatted properties to merge with the aggregation
|
2015-03-09 06:30:42 +01:00
|
|
|
definition, as in the following example:
|
|
|
|
|
|
|
|
[source,shell]
|
|
|
|
{ "script" : "doc['grade'].value * 1.2" }
|
|
|
|
|
2016-06-30 23:32:21 +02:00
|
|
|
NOTE: In Elasticsearch releases 1.4.3 and later, this functionality requires you to enable
|
2017-06-27 19:13:42 +02:00
|
|
|
{ref}/modules-scripting.html[dynamic Groovy scripting].
|
2015-03-09 06:30:42 +01:00
|
|
|
|
|
|
|
The availability of these options varies depending on the aggregation you choose.
|
|
|
|
|
2015-05-12 06:03:19 +02:00
|
|
|
Select the *Options* tab to change the following aspects of the table:
|
2015-03-09 06:30:42 +01:00
|
|
|
|
|
|
|
*Donut*:: Display the chart as a sliced ring instead of a sliced pie.
|
|
|
|
*Show Tooltip*:: Check this box to enable the display of tooltips.
|
2015-05-12 06:03:19 +02:00
|
|
|
|
2016-06-30 23:32:21 +02:00
|
|
|
After changing options, click the *Apply changes* button to update your visualization, or the grey *Discard
|
2015-05-18 04:31:43 +02:00
|
|
|
changes* button to keep your visualization in its current state.
|