kibana中文指南

Kibana是一个使用Apache开源协议，基于浏览器的Elasticsearch分析和搜索仪表板。Kibana非常容易安装和使用。整个项目都是用HTML和Javascript写的，所以Kibana不需要任何服务器端组件，一个纯文本发布服务器就够了。Kibana和Elasticsearch一样，力争成为极易上手，但同样灵活而强大的软件。简介本书原始内容来源Elasticsearch官方指南Kibana部分，并对panel部分加以截图注释。在有时间的前提下，将会添加更多关于kibana源码解析和第三方panel的介绍。欢迎捐赠，作者支付宝账号：[e-mail]注释Kibana对实时数据分析来说是特别适合的工具。本节内容首先让你快速入门，了解Kibana所能做的大部分事情。如果你还没下载Kibana，点击右侧链接：下载Kibana。我们建议你在开始本教程之前，先部署好一个干净的elasticsearch进程。到本节结束，你就会：导入一些数据尝试简单的仪表板搜索你的数据配置Kibana只显示你的新索引而不是全部索引我们假设你已经：在自己电脑上安装好了Elasticsearch在自己电脑上搭建好了网站服务器，并把Kibana发行包解压到了发布目录里对UNIX命令行有一点了解，使用过curl10分钟入门我们将使用莎士比亚全集作为我们的示例数据。要更好的使用Kibana，你需要为自己的新索引应用一个映射集(mapping)。我们用下面这个映射集创建莎士比亚全集索引。实际数据的字段比这要多，但是我们只需要指定下面这些字段的映射就可以了。注意到我们设置了对speaker和play_name不分析。原因会在稍后讲明。在终端运行下面命令：curl-XPUT{mappings:{_default_:{properties:{speaker:{type:string,index:not_analyzed},play_name:{type:string,index:not_analyzed},line_id:{type:integer},speech_number:{type:integer}}}}}';很棒，我们这就创建好了索引。现在需要做的时导入数据。莎士比亚全集的内容我们已经整理成了elasticsearch批量导入所需要的格式，你可以通过shakeseare.json下载。用如下命令导入数据到你本地的elasticsearch进程中。这可能需要一点时间，莎士比亚可是著作等身的大文豪！curl-XPUTlocalhost:9200/[e-mail]导入数据现在你数据在手，可以干点什么了。打开浏览器，访问已经发布了Kibana的本地服务器。如果你解压路径无误(译者注：使用github源码的读者记住发布目录应该是kibana/src/里面)，你已经就可以看到上面这个可爱的欢迎页面。点击SampleDashboard链接好了，现在显示的就是你的sampledashboard！如果你是用新的elasticsearch进程开始本教程的，你会看到一个百分比占比很重的饼图。这里显示的是你的索引中，文档类型的情况。如你所见，99%都是lines，只有少量的acts和scenes。再下面，你会看到一长段JSON格式的莎士比亚诗文。访问Kibana界面Kibana允许使用者采用LuceneQueryString语法搜索Elasticsearch中的数据。请求可以在页面顶部的请求输入框中书写。在请求框中输入如下内容。然后查看表格中的前几行内容。friends,romans,countrymen关于搜索请求的语法，请阅读QueriesandFilters。第一次搜索目前Kibana指向的是Elasticsearch一个特殊的索引叫_all。_all可以理解为全部索引的大集合。目前你只有一个索引，shakespeare，但未来你会有更多其他方面的索引，你肯定不希望Kibana在你只想搜《麦克白》里心爱的句子的时候还要搜索全部内容。配置索引，点击右上角的配置按钮：在这里，你可以设置你的索引为shakespeare，这样Kibana就只会搜索shakespeare索引的内容了。配置另一个索引恭喜你，你已经学会了安装和配置Kibana，算是正式下水了！下一步，打开我们的视频和其他教程学习更高级的技能吧。现在，你可以尝试在一个空白仪表板上添加自己的面板。这方面的内容，请阅读RowsandPanels。下一步图啊，表啊，地图啊，Kibana有好多种图表，我们怎么控制显示在这些图表上的数据呢？这就是请求和过滤起作用的地方。Kibana是基于Elasticsearch的，所以支持强大的LuceneQueryString语法，同样还能用上Elasticsearch的过滤器能力。我们假设你已经：在自己电脑上安装好了Elasticsearch在自己电脑上搭建好了网站服务器，并把Kibana发行包解压到了发布目录里读过UsingKibanaforthefirsttime并且按照文章内容准备好了存有莎士比亚文集的索引请求和过滤我们的仪表板像下面这样，可以搜索莎士比亚文集的内容。如果你喜欢本章截图的这种仪表板样式，你可以下载导出的仪表板纲要(dashboardschema)我们的仪表板在搜索栏输入下面这个非常简单的请求tobeornottobe你会注意到，表格里第一条就是你期望的《哈姆雷特》。不过下一行却是《第十二夜》的安德鲁爵士，这里可没有tobe，也没有nottobe。事实上，这里匹配上的是toORbeORorORnotORtoORbe。我们需要这么搜索(译者注：即加双引号)来匹配整个短语：tobeornottobe或者指明在某个特定的字段里搜索：line_id:86169我们可以用AND/OR来组合复杂的搜索，注意这两个单词必须大写：foodANDlove还有括号：(playeduponOReveryman)ANDstage数值类型的数据可以直接搜索范围：line_id:[30000TO80000]ANDhavoc最后，当然是搜索所有：*请求有些场景，你可能想要比对两个不同请求的结果。Kibana可以通过OR的方式把多个请求连接起来，然后分别进行可视化处理。添加请求点击请求输入框右侧的+号，即可添加一个新的请求框。点击完成后你应该看到的是这样子在左边，绿色输入框，输入tobe然后右边，黄色输入框，输入nottobe。这就会搜索每个包含有tobe或者nottobe内容的文档，然后显示在我们的hits饼图上。我们可以看到原先一个大大的绿色圆形变成下面这样：移除请求要移除一个请求，移动鼠标到这个请求输入框上，然后会出现一个x小图标，点击小图标即可：多个请求Kibana会自动给你的请求分配一个可用的颜色，不过你也可以手动设置颜色。点击请求框左侧的彩色圆点，就可以弹出请求设置下拉框。这里面可以修改请求的颜色，或者设置为这个请求设置一个新的图例文字：颜色和图例很多Kibana图表都是交互式的，可以用来过滤你的数据视图。比如，点击你图表上的第一个条带，你会看到一些变动。整个图变成了一个大大的绿色条带。这是因为点击的时候，就添加了一个过滤规则，要求匹配play_name字段里的单词。你要问了“在哪里过滤了”？答案就藏在过滤(FILTERING)标签上出现的白色小星星里。点击这个标签，你会发现在filtering面板里已经添加了一个过滤规则。在filtering面板里，可以添加，编辑，固定，删除任意过滤规则。很多面板都支持添加过滤规则，包括表格(table)，直方图(histogram)，地图(map)等等。过滤规则也可以自己点击+号手动添加。过滤你现在已经可以处理过滤和请求了，你可能很好奇在Kibanaschema里，他们是怎么存在的。如果你还想知道如何通过URL参数来添加请求和过滤，欢迎阅读TemplatedandScriptedDashboards更多阅读Kibana的仪表板是由行和面板组成的。这些都可以随意的添加，删除和重组。这节我们会介绍：加载一个空白仪表板添加，隐藏行，以及修改行高添加面板和修改面板宽度删除面板和行我们假设你已经：在自己电脑上安装好了Elasticsearch在自己电脑上搭建好了网站服务器，并把Kibana发行包解压到了发布目录里读过UsingKibanaforthefirsttime并且按照文章内容准备好了存有莎士比亚文集的索引行和面板从主屏里选择第三项，就会加载一个空白仪表板(BlankDashboard)。默认情况下，空白仪表板会搜索Elasticsearch的_all索引，也就是你的全部索引。要指定搜索某个索引的，阅读UsingKibanaforthefirsttime。加载一个空白仪表板你的新空白仪表板上只有展开的请求和过滤区域，页面顶栏上有个时间过滤选择器，除此以外什么都没有。在右下方，点击添加行(ADDAROW)按钮，添加你的第一行。给你的行取个名字，然后点击创建(CreateRow)按钮。你会看到你的新行出现在左侧的行列表里。点击保存(Save)添加一行现在你有了一行，你会注意到仪表板上多了点新元素。主要是左侧多出来的三个小小的不同颜色的长方形。移动鼠标到它们上面哈哈！看到了吧，这三个按钮是让你做这三件事情的：折叠行(蓝色)配置行(橘色)添加面板(绿色)行的控制现在我们专注在行控制力的绿色按钮上，试试点击它。你也可以点击空白行内的灰色按钮(Addpaneltoemptyrow)，不过它是灰色的啊，有啥意思……让我们来添加一个terms面板。terms面板可以让我们用上Elasticsearch的termsfacet功能，查找一个字段内最经常出现的几个值。你可以看到，terms面板有一系列可配置选选，不过我们现在先只管第一段里德通用配置好了：1.Title:面板的名称2.Span:面板的宽度。Kibana仪表板等分成12个spans面板最大就是到12个spans宽。但是行可以容纳超过12个spans的总宽度，因为它会自动把新的面板放到下面显示。现在我们先设置为4。3.Editable:面板是否在之后可以继续被编辑。现在先略过。4.Inspectable:面板是否允许用户查看所用的请求内容。现在先略过。5.点击Save添加你的新terms面板到你的仪表板添加面板太棒了！你现在有一个面板了！你可能意识到这个数据跟UsingKibanaforthefirsttime中的饼图数据一样。shakespeare数据集集中在lines，还有少量的acts和scenes。蓝色按钮可以折叠你的行。被折叠行里的面板不会刷新数据，也就不要求Elasticsearch资源。所以折叠行可以用于那些你不需要经常看的数据。有需要的时候点击蓝色按钮展开就可以了。顶部的请求和过滤区域也可以被折叠。点击彩色标签就可以折叠和展开。折叠和展开行通过行编辑器，可以给行重命名，改行高等其他配置。点击橙色按钮打开行编辑器。这个对话框还允许你修改面板的排序和大小，以及删除面板。编辑行面板可以在本行，甚至其他行之间任意拖拽。按住面板右上角的十字架形状小图标然后拖动即可。点击面板右上角的remove小图标就可以从仪表板上移除它。前面说到从行编辑器上也可以做到统一效果。移动和删除面板行可以在仪表板配置页中重新排序和删。点击屏幕右上角的配置按钮，选择行(Rows)标签切换到行配置层。看到这里你一定会记起来我们在添加第一个行时候的屏幕。左侧的箭头用来修改仪表板上行的次序。X用来删除行。移动和删除行在你关闭浏览器之前，你可能打算保存这个新仪表板。请阅读SavingandLoadingdashboards。下一步你已经构建了一个漂亮的仪表板！现在你打算分享给团队，或者开启自动刷新后挂在一个大屏幕上？Kibana可以把仪表板设计持久化到Elasticsearch里