- Chunking for Settings pages - Updates several screenshots - Autorefresh added - See PR conversation for way more deets
71 lines
4.4 KiB
Plaintext
71 lines
4.4 KiB
Plaintext
[[area-chart]]
|
|
=== Area Charts
|
|
|
|
This chart's Y axis is the _metrics_ axis. The following aggregations are available for this axis:
|
|
|
|
*Count*:: The {ref}/search-aggregations-metrics-valuecount-aggregation.html[_count_] aggregation returns a raw count of
|
|
the elements in the selected index pattern.
|
|
*Average*:: This aggregation returns the {ref}/search-aggregations-metrics-avg-aggregation.html[_average_] of a numeric
|
|
field. Select a field from the drop-down.
|
|
*Sum*:: The {ref}/search-aggregations-metrics-sum-aggregation.html[_sum_] aggregation returns the total sum of a numeric
|
|
field. Select a field from the drop-down.
|
|
*Min*:: The {ref}/search-aggregations-metrics-min-aggregation.html[_min_] aggregation returns the minimum value of a
|
|
numeric field. Select a field from the drop-down.
|
|
*Max*:: The {ref}/search-aggregations-metrics-max-aggregation.html[_max_] aggregation returns the maximum value of a
|
|
numeric field. Select a field from the drop-down.
|
|
*Unique Count*:: The {ref}/search-aggregations-metrics-cardinality-aggregation.html[_cardinality_] aggregation returns
|
|
the number of unique values in a field. Select a field from the drop-down.
|
|
*Percentiles*:: The {ref}/search-aggregations-metrics-percentile-aggregation.html[_percentile_] aggregation divides the
|
|
values in a numeric field into percentile bands that you specify. Select a field from the drop-down, then specify one
|
|
or more ranges in the *Percentiles* fields. Click the *X* to remove a percentile field. Click *+ Add* to add a
|
|
percentile field.
|
|
*Percentile Rank*:: The {ref}/search-aggregations-metrics-percentile-rank-aggregation.html[_percentile ranks_]
|
|
aggregation returns the percentile rankings for the values in the numeric field you specify. Select a numeric field
|
|
from the drop-down, then specify one or more percentile rank values in the *Values* fields. Click the *X* to remove a
|
|
values field. Click *+Add* to add a values field.
|
|
|
|
You can add an aggregation by clicking the *+ Add Aggregation* button.
|
|
|
|
include::x-axis-aggs.asciidoc[]
|
|
For example, a chart of dates with incident counts can display dates in chronological order, or you can raise the
|
|
priority of the incident-reporting aggregation to show the most active dates first. The chronological order might show
|
|
a time-dependent pattern in incident count, and sorting by active dates can reveal particular outliers in your data.
|
|
|
|
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.
|
|
*Exclude Pattern Flags*:: A standard set of Java flags for the exclusion pattern.
|
|
*Include Pattern*:: Specify a pattern in this field to include in the results.
|
|
*Include Pattern Flags*:: A standard set of Java flags for the inclusion pattern.
|
|
*JSON Input*:: A text field where you can add specific JSON-formatted properties to merge with the aggregation
|
|
definition, as in the following example:
|
|
|
|
[source,shell]
|
|
{ "script" : "doc['grade'].value * 1.2" }
|
|
|
|
NOTE: In Elasticsearch releases 1.4.3 and later, this functionality requires you to enable
|
|
{ref}/modules-scripting.html[dynamic Groovy scripting].
|
|
|
|
The availability of these options varies depending on the aggregation you choose.
|
|
|
|
Select the *Options* tab to change the following aspects of the chart:
|
|
|
|
*Chart Mode*:: When you have multiple Y-axis aggregations defined for your chart, you can use this drop-down to affect
|
|
how the aggregations display on the chart:
|
|
|
|
_stacked_:: Stacks the aggregations on top of each other.
|
|
_overlap_:: The aggregations overlap, with translucency indicating areas of overlap.
|
|
_wiggle_:: Displays the aggregations as a https://en.wikipedia.org/wiki/Streamgraph[streamgraph].
|
|
_percentage_:: Displays each aggregation as a proportion of the total.
|
|
_silhouette_:: Displays each aggregation as variance from a central line.
|
|
|
|
Checkboxes are available to enable and disable the following behaviors:
|
|
|
|
*Smooth Lines*:: Check this box to curve the top boundary of the area from point to point.
|
|
*Set Y-Axis Extents*:: Check this box and enter values in the *y-max* and *y-min* fields to set the Y axis to specific
|
|
values.
|
|
*Scale Y-Axis to Data Bounds*:: The default Y axis bounds are zero and the maximum value returned in the data. Check
|
|
this box to change both upper and lower bounds to match the values returned in the data.
|
|
*Show Tooltip*:: Check this box to enable the display of tooltips.
|
|
*Show Legend*:: Check this box to enable the display of a legend next to the chart.
|