项目作者: prelert

项目描述 :
Kibana泳道可视化
高级语言: JavaScript
项目地址: git://github.com/prelert/kibana-swimlane-vis.git
创建时间: 2016-05-18T09:06:10Z
项目社区:https://github.com/prelert/kibana-swimlane-vis

开源协议:Apache License 2.0

下载


Swimlane visualization for Kibana

A swimlane visualization for Kibana, with builds available for Kibana 7.x, 6.x, 5.x and 4.x.

The visualization displays the behavior of a metric value over time across a field from the results.
Each lane displays a different value of the selected field, with the relative size of the metric
for that field over each time indicated by the color of the symbol at that time.

image

An example use case is shown below, where the swimlane is displaying data from a flight comparison website.
The average response time for each airline is plotted in a separate lane, with response times shown depending
on magnitude, with blue used for the shortest response times, then yellow, orange, and red for the longest
response times:

image

Compatibility

Kibana enforces that installed plugins match the version of Kibana itself, so different releases of the
swimlane plugin are available for each new Kibana release.

The distribution for Kibana 7 has been built for versions:

  • 7.6.2
  • 7.6.1
  • 7.6.0
  • 7.5.2
  • 7.5.1
  • 7.5.0
  • 7.4.2
  • 7.4.1
  • 7.4.0
  • 7.3.2
  • 7.3.1
  • 7.3.0
  • 7.2.1
  • 7.2.0
  • 7.1.1
  • 7.1.0
  • 7.0.1
  • 7.0.0

The distribution for Kibana 6 has been built for versions:

  • 6.8.1
  • 6.8.0
  • 6.7.2
  • 6.7.1
  • 6.7.0
  • 6.6.2
  • 6.6.1
  • 6.6.0
  • 6.5.4
  • 6.5.3
  • 6.5.2
  • 6.5.1
  • 6.5.0
  • 6.4.3
  • 6.4.2
  • 6.4.1
  • 6.4.0
  • 6.3.2
  • 6.3.1
  • 6.3.0
  • 6.2.4
  • 6.2.3
  • 6.2.2
  • 6.2.1
  • 6.2.0
  • 6.1.3
  • 6.1.2
  • 6.1.1
  • 6.1.0
  • 6.0.1
  • 6.0.0

The distribution for Kibana 5 has been built for versions:

  • 5.6.6
  • 5.6.5
  • 5.6.4
  • 5.6.3
  • 5.6.2
  • 5.6.1
  • 5.6.0
  • 5.5.3
  • 5.5.2
  • 5.5.1
  • 5.5.0
  • 5.4.3
  • 5.4.2
  • 5.4.1
  • 5.4.0
  • 5.3.2
  • 5.3.1
  • 5.3.0
  • 5.2.2
  • 5.1.2
  • 5.1.1
  • 5.0.2
  • 5.0.1
  • 5.0.0

For Kibana 4 a single release was available and tested with versions 4.3, 4.4, 4.5 and 4.6

Installation

Kibana 7.6.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.6.2/prelert_swimlane_vis-7.6.2.zip

Kibana 7.6.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.6.1/prelert_swimlane_vis-7.6.1.zip

Kibana 7.6.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.6.0/prelert_swimlane_vis-7.6.0.zip

Kibana 7.5.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.5.2/prelert_swimlane_vis-7.5.2.zip

Kibana 7.5.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.5.1/prelert_swimlane_vis-7.5.1.zip

Kibana 7.5.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.5.0/prelert_swimlane_vis-7.5.0.zip

Kibana 7.4.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.4.2/prelert_swimlane_vis-7.4.2.zip

Kibana 7.4.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.4.1/prelert_swimlane_vis-7.4.1.zip

Kibana 7.4.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.4.0/prelert_swimlane_vis-7.4.0.zip

Kibana 7.3.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.3.2/prelert_swimlane_vis-7.3.2.zip

Kibana 7.3.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.3.1/prelert_swimlane_vis-7.3.1.zip

Kibana 7.3.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.3.0/prelert_swimlane_vis-7.3.0.zip

Kibana 7.2.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.2.1/prelert_swimlane_vis-7.2.1.zip

Kibana 7.2.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.2.0/prelert_swimlane_vis-7.2.0.zip

Kibana 7.1.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.1.1/prelert_swimlane_vis-7.1.1.zip

Kibana 7.1.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.1.0/prelert_swimlane_vis-7.1.0.zip

Kibana 7.0.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.0.1/prelert_swimlane_vis-7.0.1.zip

Kibana 7.0.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v7.0.0/prelert_swimlane_vis-7.0.0.zip

Kibana 6.8.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.8.1/prelert_swimlane_vis-6.8.1.zip

Kibana 6.8.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.8.0/prelert_swimlane_vis-6.8.0.zip

Kibana 6.7.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.7.2/prelert_swimlane_vis-6.7.2.zip

Kibana 6.7.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.7.1/prelert_swimlane_vis-6.7.1.zip

Kibana 6.7.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.7.0/prelert_swimlane_vis-6.7.0.zip

Kibana 6.6.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.6.2/prelert_swimlane_vis-6.6.2.zip

Kibana 6.6.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.6.1/prelert_swimlane_vis-6.6.1.zip

Kibana 6.6.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.6.0/prelert_swimlane_vis-6.6.0.zip

Kibana 6.5.4:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.5.4/prelert_swimlane_vis-6.5.4.zip

Kibana 6.5.3:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.5.3/prelert_swimlane_vis-6.5.3.zip

Kibana 6.5.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.5.2/prelert_swimlane_vis-6.5.2.zip

Kibana 6.5.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.5.1/prelert_swimlane_vis-6.5.1.zip

Kibana 6.5.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.5.0/prelert_swimlane_vis-6.5.0.zip

Kibana 6.4.3:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.4.3/prelert_swimlane_vis-6.4.3.zip

Kibana 6.4.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.4.2/prelert_swimlane_vis-6.4.2.zip

Kibana 6.4.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.4.1/prelert_swimlane_vis-6.4.1.zip

Kibana 6.4.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.4.0/prelert_swimlane_vis-6.4.0.zip

Kibana 6.3.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.3.2/prelert_swimlane_vis-6.3.2.zip

Kibana 6.3.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.3.1/prelert_swimlane_vis-6.3.1.zip

Kibana 6.3.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.3.0/prelert_swimlane_vis-6.3.0.zip

Kibana 6.2.4:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.2.4/prelert_swimlane_vis-6.2.4.zip

Kibana 6.2.3:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.2.3/prelert_swimlane_vis-6.2.3.zip

Kibana 6.2.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.2.2/prelert_swimlane_vis-6.2.2.zip

Kibana 6.2.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.2.1/prelert_swimlane_vis-6.2.1.zip

Kibana 6.2.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.2.0/prelert_swimlane_vis-6.2.0.zip

Kibana 6.1.3:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.1.3/prelert_swimlane_vis-6.1.3.zip

Kibana 6.1.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.1.2/prelert_swimlane_vis-6.1.2.zip

Kibana 6.1.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.1.1/prelert_swimlane_vis-6.1.1.zip

Kibana 6.1.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.1.0/prelert_swimlane_vis-6.1.0.zip

Kibana 6.0.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.0.1/prelert_swimlane_vis-6.0.1.zip

Kibana 6.0.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v6.0.0/prelert_swimlane_vis-6.0.0.zip

Kibana 5.6.6:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.6.6/prelert_swimlane_vis-5.6.6.zip

Kibana 5.6.5:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.6.5/prelert_swimlane_vis-5.6.5.zip

Kibana 5.6.4:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.6.4/prelert_swimlane_vis-5.6.4.zip

Kibana 5.6.3:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.6.3/prelert_swimlane_vis-5.6.3.zip

Kibana 5.6.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.6.2/prelert_swimlane_vis-5.6.2.zip

Kibana 5.6.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.6.1/prelert_swimlane_vis-5.6.1.zip

Kibana 5.6.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.6.0/prelert_swimlane_vis-5.6.0.zip

Kibana 5.5.3:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.5.3/prelert_swimlane_vis-5.5.3.zip

Kibana 5.5.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.5.2/prelert_swimlane_vis-5.5.2.zip

Kibana 5.5.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.5.1/prelert_swimlane_vis-5.5.1.zip

Kibana 5.5.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.5.0/prelert_swimlane_vis-5.5.0.zip

Kibana 5.4.3:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.4.3/prelert_swimlane_vis-5.4.3.zip

Kibana 5.4.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.4.2/prelert_swimlane_vis-5.4.2.zip

Kibana 5.4.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.4.1/prelert_swimlane_vis-5.4.1.zip

Kibana 5.4.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.4.0/prelert_swimlane_vis-5.4.0.zip

Kibana 5.3.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.3.2/prelert_swimlane_vis-5.3.2.zip

Kibana 5.3.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.3.1/prelert_swimlane_vis-5.3.1.zip

Kibana 5.3.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.3.0/prelert_swimlane_vis-5.3.0.zip

Kibana 5.2.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.2.2/prelert_swimlane_vis-5.2.2.zip

Kibana 5.1.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.1.2/prelert_swimlane_vis-5.1.2.zip

Kibana 5.1.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.1.1/prelert_swimlane_vis-5.1.1.zip

Kibana 5.0.2:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.0.2/prelert_swimlane_vis-5.0.2.zip

Kibana 5.0.1:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.0.1/prelert_swimlane_vis-5.0.1.zip

Kibana 5.0.0:

  1. bin/kibana-plugin install https://github.com/prelert/kibana-swimlane-vis/releases/download/v5.0.0/prelert_swimlane_vis-5.0.0.zip

Kibana 4.x:

Linux or OS X:

  1. bin/kibana plugin -i prelert_swimlane_vis -u https://github.com/prelert/kibana-swimlane-vis/archive/v0.1.0.tar.gz

Windows:

  1. bin/kibana plugin -i prelert_swimlane_vis -u https://github.com/prelert/kibana-swimlane-vis/archive/v0.1.0.zip

Uninstall

Kibana 7.x, 6.x and 5.x:

  1. bin/kibana-plugin remove prelert_swimlane_vis

Usage

The first step in creating the visualization is to configure the metric that will be displayed.
Select the Elasticsearch aggregation to be used - count, average, sum, min, max and unique count are currently available.
If using average, sum, min, max or unique count, select the numeric field that will be aggregated. A
custom label can also be entered if desired, which will be displayed against the value in tooltips. In our
example we are plotting average response time, with the numeric value stored in the responsetime field of the index:

image

The next step is to configure the field by which you want the results to be split to form the swimlanes using
an Elasticsearch terms aggregation. Select the field for the View by bucket aggregation, which will typically be
one of the string type fields in your results. Use the Size dropdown to select the maximum number of swimlanes
that will be displayed. In our example, we will be viewing results by airline, showing the top 15 airlines by
average response time:

image

Note if no View by buckets are configured, a single swimlane will be displayed showing the behavior of the
selected metric over all results.

The final step is to select the time field in your results. The time frame for the intervals in the swimlane
visualization can be specified in terms of seconds, minutes, hours, days, weeks, months, or years, or just
leave it to the Auto setting of Kibana which will aim to pick the optimum interval depending on the time
span of the query. An interval dropdown control is also available at the top of the swimlane for use when
the visualization has been saved and added to a dashboard (this control was not available for 6.0 and 6.1 releases
due to an issue with the Kibana Angular
visualization type).

image

Options

The Options tab allows you to configure the color band thresholds, the format of the value shown in the tooltip
when hovering over a band in the swimlane, whether to display the legend showing the lower threshold values
for each of the color bands, and whether to sort the lanes alphabetically.

image

Color band thresholds

The swimlane uses different colors to indicate the value of the metric over a time interval. By default,
five threshold bands are set for a 0 to 100 range of values, with light blue used for the smallest value,
through to red for the largest value, and the ranges set to:

Range Color
0 <= value < 3 light blue
3 <= value < 25 blue
25 <= value < 50 yellow
50 <= value < 75 orange
75 <= value red

To alter the numeric ranges for any of the bands, use the Band thresholds section of the Options tab to
enter the desired value, noting that the values entered define the lower threshold for each band. For example,
in the screenshot above, the thresholds have been adjusted to suit the range of response times from the flight
comparison website data, with values of 3000 or more displayed in red.

Alternative colors for the swimlane cells can be chosen here by using the provided colorpickers or by
entering hexidecimal color values.

The number of color bands can also be altered, using the Add or Delete buttons.

By default a legend will be displayed above the swimlane showing the configured lower band threshold values
for each of the colors. This legend can be hidden by deselecting the Show threshold legend checkbox in the
Options tab.

Tooltip formatting

By default, the value shown in the tooltip when hovering over a band in the swimlane is shown to one decimal
place. To alter the format of the tooltip to suit values in your data set, enter the desired format in the
Tooltip formatting section of the Options tab. Refer to the Numeral.js documentation
for the range of accepted formats, with that being the library used to format the value in the tooltip.

The date and time shown in the tooltip is displayed in the format that Kibana uses for displaying pretty-formatted
dates. This dateFormat option can be configured in the Advanced Settings page under the Kibana Management
application.

Lane sorting

By default the lanes will be displayed in the order returned by the configured View by bucket aggregation. To
perform a secondary alphabetical sort to the lane order, select Ascending or Descending as desired from the
Order lanes alphabetically dropdown control.

Issues

Please file issues here.

About Prelert

Prelert was the company behind behavioral analytics for IT security, IT operations, and business operations teams.
They joined forces with Elastic in September 2016 and now
form the Machine Learning team at Elastic.

The machine learning features in the Elastic stack automatically model the behavior of your Elasticsearch data — trends,
periodicity, and more — in real time to identify issues faster, streamline root cause analysis, and reduce false positives.
More information about Machine Learning in the Elastic stack can be found here.