Kibana User Guide [4.2] » Visualize » Pie Charts

 Pie Charts

饼图

The slice size of a pie chart is determined by the metrics aggregation. The following aggregations are available for this axis:

饼图的分片大小通过metrics聚合定义。这个维度可以支持一下聚合：

Count 计数

The  count aggregation returns a raw count of the elements in the selected index pattern.

索引模式中，元素的原始计数。

Sum 综合

The  sum aggregation returns the total sum of a numeric field. Select a field from the drop-down.

一个数值字段的总和。

Unique Count 单一计数

The  cardinality aggregation returns the number of unique values in a field. Select a field from the drop-down.

去重数据值。

The buckets aggregations determine what information is being retrieved from your data set.

buckets聚合指明从你的数据集中将检索什么信息。

Before you choose a buckets aggregation, specify if you are splitting slices within a single chart or splitting into multiple charts. A multiple chart split must run before any other aggregations. When you split a chart, you can change if the splits are displayed in a row or a column by clicking the Rows | Columns selector.

在你选定一个 buckets 聚合之前，先指定你是要切割单个图的分片，还是切割成多个图形。多图切分必须在其他任何聚合之前要运行。如果你切分图形，你可以选择切分结果是展示成行还是列的形式，点击 Rows | Columns 选择器即可。

You can specify any of the following bucket aggregations for your pie chart:

你可以为你的饼图指定以下任意 bucket 聚合：

Date Histogram 日期柱状图

A  date histogram is built from a 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, down to one second.

基于数值字段创建，由时间组织起来。你可以指定时间片的间隔，单位包括秒、分、小时、天、星期、月、年。

Histogram 柱状图

A standard  histogram is built from a numeric field. Specify an integer interval for this field. Select the Show empty buckets checkbox to include empty intervals in the histogram.

基于数值字段创建，为这个字段指定一个整数间隔。勾选 Show empty buckets让直方图中包含空的间隔。

Range 类别

With a  range aggregation, you can specify ranges of values for a numeric field. Click  Add Range to add a set of range endpoints. Click the red  (x) symbol to remove a range.

可以为一个数值字段指定一系列区间，点击添加一对区间端点。点击红色 的 (x)  符合移除一个区间。

Date Range 日期类别

A  date range aggregation reports values that are within a range of dates that you specify. You can specify the ranges for the dates using  date math expressions. Click  Add Range to add a set of range endpoints. Click the red  (/) symbol to remove a range.

计算你指定的时间区间的值。可以使用data math表达式指定区间，点击Add Range添加新的区间端点，点击红色的   (/)  符号移除区间。

IPv4 Range IPv4类别

The  IPv4 range aggregation enables you to specify ranges of IPv4 addresses. Click  Add Range to add a set of range endpoints. Click the red  (/) symbol to remove a range.

指定IPv4地址的区间，点击 Add Range添加新的区间端点，点击红色的   (/)   符号移除区间。

Terms 条件

A  terms aggregation enables you to specify the top or bottom  n elements of a given field to display, ordered by count or a custom metric.

允许你指定展示一个字段的首尾几个元素，排序方式可以使计数，或者是其他自定义的metric。

Filters 过滤器

You can specify a set of  filters for the data. 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    label button to open the label field, where you can type in a name to display on the visualization.

你可以为数据指定一组filters，每个filters中可以用query string，也可以用JSON格式，就像在Discover页的搜索栏里一样。点击 Add Filter添加下一个过滤器。

Significant Terms 有意义的条件

Displays the results of the experimental  significant terms aggregation. The value of the  Size parameter defines the number of entries this aggregation returns.

展示有意义条件的结果。 Size参数的值定义了聚集的返回量。

After defining an initial bucket aggregation, you can define sub-aggregations to refine the visualization. Click + Add Sub Aggregation to define a sub-aggregation, then choose Split Slices to select a sub-aggregation from the list of types.

一旦你定义好了一个 X 轴聚合。你可以继续定义子聚合来完善可视化效果。点击 + Add Sub Aggregation 添加子聚合，然后选择 Split Area 或者 Split Chart，然后从类型菜单中选择一个子聚合。

When multiple aggregations are defined on a chart’s axis, you can use the up or down arrows to the right of the aggregation’s type to change the aggregation’s priority.

当一个图形中定义了多个聚合，你可以使用聚合类型右侧的上下箭头来改变聚合的优先级。

You can click the Advanced link to display more customization options for your metrics or bucket aggregation:

你可以点击 Advanced 链接显示更多有关聚合的自定义参数：

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.

排除模式的Java flags 标准集

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.

包含模式的Java flags标准集

JSON Input JSON输入

A text field where you can add specific JSON-formatted properties to merge with the aggregation definition, as in the following example:

一个用来添加JSON格式属性的文本框，内容会合并进聚合的定义中，格式如下例：

<span class="pun" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(102, 102, 0);">{</span><span class="pln" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(0, 0, 0);"> </span><span class="str" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(0, 136, 0);">"script"</span><span class="pln" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(0, 0, 0);"> </span><span class="pun" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(102, 102, 0);">:</span><span class="pln" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(0, 0, 0);"> </span><span class="str" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(0, 136, 0);">"doc['grade'].value * 1.2"</span><span class="pln" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(0, 0, 0);"> </span><span class="pun" style="margin: 0px; padding: 0px; border: 0px; font-family: inherit; font-style: inherit; font-variant: inherit; font-weight: inherit; line-height: inherit; vertical-align: baseline; color: rgb(102, 102, 0);">}</span>

In Elasticsearch releases 1.4.3 and later, this functionality requires you to enable dynamic Groovy scripting.

在Elasticsearch 1.4.3及以后版本，这个函数需要你开启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 table:

选择Options 更改表格中如下方面：

Donut 圆圈图

Display the chart as a sliced ring instead of a sliced pie.

用甜圈圈代替饼图样式。

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.

勾选该项在图形右侧显示图例。

After changing options, click the green Apply changes button to update your visualization, or the grey Discard changes button to keep your visualization in its current state.

在更改选项后，点击绿色的按钮 Apply changes 更新你的可视化结果。或者，点击灰色的按钮 Discard changes 把你的可视化结果保持在当前状态。

Viewing Detailed Information 查看详细信息

To display the raw data behind the visualization, click the bar at the bottom of the container. Tabs with detailed information about the raw data replace the visualization:

想要展现可视化背后的原始数据，可以点击容器底部的条。关于原始数据的详细信息标签将取代可视化。

Table. A representation of the underlying data, presented as a paginated data grid. You can sort the items in the table by clicking on the table headers at the top of each column.

表：对下划线数据的代表，以标页数据格的形式展现。你可以对表中数据线排序，通过点击每个柱顶的表头。

Request. The raw request used to query the server, presented in JSON format.

请求：原始请求被用于请求服务器，以JSON形式展现。

Response. The raw response from the server, presented in JSON format.

响应：来自服务器的原始应答，以JSON形式展现。

Statistics. A summary of the statistics related to the request and the response, presented as a data grid. The data grid includes the query duration, the request duration, the total number of records found on the server, and the index pattern used to make the query.

统计：关于请求和响应统计的摘要，以数据格的形式展现。数据格包括请求持续时间，响应持续时间，服务器创建的总数据记录，被用于请求的索引模式。

To export the raw data behind the visualization as a comma-separated-values (CSV) file, click on either theRaw or Formatted links at the bottom of any of the detailed information tabs. A raw export contains the data as it is stored in Elasticsearch. A formatted export contains the results of any applicable Kibana field formatters.

为了展现以CSV文件存在的可视化背后的原始数据，点击详细信息底部的Raw 或 Formatted 链接。一个原始输出包括保存在ES中的数据。一个格式化的输出包括Kibana格式化应用的结果。

备注：
材料来自elastic官网。
参考整理：
http://kibana.logstash.es/content/kibana/v4/visualize/pie.html
原文地址：
https://www.elastic.co/guide/en/kibana/current/pie-chart.html