Kibana discover 功能

Discover 标签页用于交互式探索你的数据。你能够访问到匹配得上你选择的索引模式的每一个索引的每条记录。你能够提交搜索请求，过滤搜索结果，而后查看文档数据。你还能够看到匹配搜索请求的文档总数，获取字段值的统计状况。若是索引模式配置了时间字段，文档的时序分布状况会在页面顶部以柱状图的形式展现出来。

 

设置时间过滤器

时间过滤器(Time Filter)限制搜索结果在一个特定的时间周期内。若是你的索引包含的是时序诗句，并且你为所选的索引模式配置了时间字段，那么就就能够设置时间过滤器。

默认的时间过滤器设置为最近 15 分钟。你能够用页面顶部的时间选择器(Time Picker)来修改时间过滤器，或者选择一个特定的时间间隔，或者直方图的时间范围。

要用时间选择器来修改时间过滤器：

1. 点击菜单栏右上角显示的 Time Filter 打开时间选择器。
2. 快速过滤，直接选择一个短连接便可。VR集结号
3. 要指定相对时间过滤，点击 Relative 而后输入一个相对的开始时间。能够是任意数字的秒、分、小时、天、月甚至年以前。
4. 要指定绝对时间过滤，点击 Absolute 而后在 From 框内输入开始日期，To 框内输入结束日期。
5. 点击时间选择器底部的箭头隐藏选择器。

要从住房图上设置时间过滤器，有如下几种方式：

• 想要放大那个时间间隔，点击对应的柱体。
• 单击并拖拽一个时间区域。注意须要等到光标变成加号，才意味着这是一个有效的起始点。

你能够用浏览器的后退键来回退你的操做。

搜索数据

在 Discover 页提交一个搜索，你就能够搜索匹配当前索引模式的索引数据了。你能够直接输入简单的请求字符串，也就是用 Lucene query syntax，也能够用完整的基于 JSON 的 Elasticsearch Query DSL。

当你提交搜索的时候，直方图，文档表格，字段列表，都会自动反映成搜索的结果。hits(匹配的文档)总数会在直方图的右上角显示。文档表格显示前 500 个匹配文档。默认的，文档倒序排列，最新的文档最早显示。你能够经过点击时间列的头部来反转排序。事实上，全部建了索引的字段，均可以用来排序，稍后会详细说明。

要搜索你的数据：

1. 在搜索框内输入请求字符串：
   • 简单的文本搜索，直接输入文本字符串。好比，若是你在搜索网站服务器日志，你能够输入safari 来搜索各字段中的 safari 单词。
   • 要搜索特定字段中的值，则在值前加上字段名。好比，你能够输入 status:200 来限制搜索结果都是在 status 字段里有 200 内容。
   • 要搜索一个值的范围，你能够用范围查询语法，[START_VALUE TO END_VALUE]。好比，要查找 4xx 的状态码，你能够输入 status:[400 TO 499]。
   • 要指定更复杂的搜索标准，你能够用布尔操做符 AND, OR, 和 NOT。好比，要查找 4xx 的状态码，仍是 php 或 html 结尾的数据，你能够输入 status:[400 TO 499] AND (extension:php OR extension:html)。

这些例子都用了 Lucene query syntax。你也能够提交 Elasticsearch Query DSL 式的请求。更多示例，参见以前 Elasticsearch 章节。

1. 点击回车键，或者点击 Search 按钮提交你的搜索请求。

开始一个新的搜索

要清除当前搜索或开始一个新搜索，点击 Discover 工具栏的 New Search 按钮。

保存搜索

你能够在 Discover 页加载已保存的搜索，也能够用做 visualizations 的基础。保存一个搜索，意味着同时保存下了搜索请求字符串和当前选择的索引模式。

要保存当前搜索：

1. 点击 Discover 工具栏的 Save Search 按钮
2. 输入一个名称，点击 Save。

加载一个已存搜索

要加载一个已保存的搜索：

1. 点击 Discover 工具栏的 Load Search 按钮 。
2. 选择你要加载的搜索。

若是已保存的搜索关联到跟你当前选择的索引模式不同的其余索引上，加载这个搜索也会切换当前的已选索引模式。

改变你搜索的索引

当你提交一个搜索请求，匹配当前的已选索引模式的索引都会被搜索。当前模式模式会显示在搜索栏下方。要改变搜索的索引，须要选择另外的模式模式。

要选择另外的索引模式：

1. 点击 Discover 工具栏的 Settings 按钮 。
2. 从索引模式列表中选取你打算采用的模式。

关于索引模式的更多细节，请阅读稍后 Setting 功能小节。

自动刷新页面

亦能够配置一个刷新间隔来自动刷新 Discover 页面的最新索引数据。这回按期从新提交一次搜索请求。

设置刷新间隔后，会显示在菜单栏时间过滤器的左边。

要设置刷新间隔：

1. 点击菜单栏右上角的 Time Filter 。
2. 点击 Refresh Interval 标签。
3. 从列表中选择一个刷新间隔。

要想自动刷新数据，点击  Auto-refresh 按钮而后选择一个自动刷新间隔：

开启自动刷新后，Kibana 的顶部栏会出现一个暂停按钮和自动刷新的间隔：。点击 Pause 按钮能够暂停自动刷新。

按字段过滤

你能够过滤搜索结果，只显示在某字段中包含了特定值的文档。也能够建立反向过滤器，排除掉包含特定字段值的文档。

你能够从字段列表或者文档表格里添加过滤器。当你添加好一个过滤器后，它会显示在搜索请求下方的过滤栏里。从过滤栏里你能够编辑或者关闭一个过滤器，转换过滤器(从正向改为反向，反之亦然)，切换过滤器开关，或者彻底移除掉它。

要从字段列表添加过滤器：

1. 点击你想要过滤的字段名。会显示这个字段的前 5 名数据。每一个数据的右侧，有两个小按钮 —— 一个用来添加常规(正向)过滤器，一个用来添加反向过滤器。
2. 要添加正向过滤器，点击 Positive Filter 按钮 。这个会过滤掉在本字段不包含这个数据的文档。
3. 要添加反向过滤器，点击 Negative Filter 按钮 。这个会过滤掉在本字段包含这个数据的文档。

要从文档表格添加过滤器：

1. 点击表格第一列(一般都是时间)文档内容左侧的 Expand 按钮  展开文档表格中的文档。每一个字段名的右侧，有两个小按钮 —— 一个用来添加常规(正向)过滤器，一个用来添加反向过滤器。
2. 要添加正向过滤器，点击 Positive Filter 按钮 。这个会过滤掉在本字段不包含这个数据的文档。
3. 要添加反向过滤器，点击 Negative Filter 按钮 。这个会过滤掉在本字段包含这个数据的文档。

过滤器(Filter)的协同工做方式

在 Kibana 的任意页面建立过滤器后，就会在搜索输入框的下方，出现一个绿色椭圆形的过滤条件：

鼠标移动到过滤条件上，会显示下面几个图标：

 

• 过滤器开关  点击这个图标，能够在不移除过滤器的状况下关闭过滤条件。再次点击则从新打开。被禁用的过滤器是条纹状的灰色，要求包含(至关于 Kibana3 里的 must)的过滤条件显示为绿色，要求排除(至关于 Kibana3 里的 mustNot)的过滤条件显示为红色。
• 过滤器图钉  点击这个图标钉住过滤器。被钉住的过滤器，能够横贯 Kibana 各个标签生效。好比在Visualize 标签页钉住一个过滤器，而后切换到 Discover 或者 Dashboard 标签页，过滤器依然还在。注意：若是你钉住了过滤器，而后发现检索结果为空，注意查看当前标签页的索引模式是否是跟过滤器匹配。
• 过滤器反转  点击这个图标反转过滤器。默认状况下，过滤器都是包含型，显示为绿色，只有匹配过滤条件的结果才会显示。反转成排除型过滤器后，显示的是不匹配过滤器的检索项，显示为红色。
• 移除过滤器  点击这个图标删除过滤器。
• 自定义过滤器  点击这个图标会打开一个文本编辑框。编辑框内能够修改 JSON 形式的过滤器内容，并起一个 alias 别名： 
• JSON 中能够灵活应用 bool query 组合各类 should、must、must_not 条件。一个用 should 表达的 OR 关系过滤以下:

• {
    "bool": {
        "should": [
            {
                "term": {
                    "geoip.country_name.raw": "Canada"
                }
            },
            {
                "term": {
                    "geoip.country_name.raw": "China"
                }
            }
        ]
    }
  }

   

   

想要对当前页全部过滤器统一执行上面的某个操做，点击  Global Filter Actions 按钮，而后再执行操做便可。

查看文档数据

当你提交一个搜索请求，最近的 500 个搜索结果会显示在文档表格里。你能够在 Advanced Settings 里经过 discover:sampleSize 属性配置表格里具体的文档数量。默认的，表格会显示当前选择的索引模式中定义的时间字段内容(转换成本地时区)以及 _source 文档。你能够从字段列表添加字段到文档表格。还能够用表格里包含的任意已建索引的字段来排序列出的文档。

要查看一个文档的字段数据，点击表格第一列(一般都是时间)文档内容左侧的 Expand 按钮 。Kibana 从 Elasticsearch 读取数据而后在表格中显示文档字段。这个表格每行是一个字段的名字、过滤器按钮和字段的值。

1. 要查看原始 JSON 文档(格式美化过的)，点击 JSON 标签。
2. 要在单独的页面上查看文档内容，点击连接。你能够添加书签或者分享这个连接，以直接访问这条特定文档。
3. 收回文档细节，点击 Collapse 按钮 。
4. To toggle a particular field’s column in the Documents table, click the  Toggle column in tablebutton.

文档列表排序

你能够用任意已建索引的字段排序文档表格中的数据。若是当前索引模式配置了时间字段，默认会使用该字段倒序排列文档。

要改变排序方式：

• 点击想要用来排序的字段名。能用来排序的字段在字段名右侧都有一个排序按钮。再次点击字段名，就会反向调整排序方式。

给文档表格添加字段列

By default, the Documents table shows the localized version of the time field specified in the selected index pattern and the document _source. You can add fields to the table from the Fields list. 默认的，文档表格会显示当前选择的索引模式中定义的时间字段内容(转换成本地时区)以及 _source 文档。你能够从字段列表添加字段到文档表格。

要添加字段列到文档表格：

1. 移动鼠标到字段列表的字段上，点击它的 add 按钮 。
2. 重复操做直到你添加完全部你想移除的字段。

添加的字段会替换掉文档表格里的 _source 列。同时还会显示在字段列表顶部的 Selected Fields 区域里。

要重排表格中的字段列，移动鼠标到你要移动的列顶部，点击移动过按钮。

从文档表格删除字段列

要从文档表格删除字段列：

1. 移动鼠标到字段列表的 Selected Fields 区域里你想要移除的字段上，而后点击它的 remove 按钮 。
2. 重复操做直到你移除完全部你想移除的字段。

查看字段数据统计

从字段列表，你能够看到文档表格里有多少数据包含了这个字段，排名前 5 的值是什么，以及包含各个值的文档的占比。

要查看字段数据统计：

• 点击字段列表里一个字段的名字。这个字段能够在字段列表的任意位置 —— 已选字段(Selected Fields)，经常使用字段(Popular Fields)，或其余字段。