User Guide
Also available as:
PDF

Adding a Tile Map Panel

A tile map displays a geographic area overlaid with circles keyed to the data determined by the buckets you specify.

[Note]Note

By default, Kibana uses the Elastic Tile Service to display map tiles. To use other tile service providers, refer to the Kibana 4 documentation.

You can select any of the following aggregations as the metrics aggregation:

Count

Returns a raw count of the elements in the selected index pattern. The count aggregation is the default metrics aggregation for a tile map.

Average

Returns the average of a numeric field. Select a field from the drop-down list.

Sum

Returns the total sum of a numeric field. Select a field from the drop-down list.

Min

Returns the minimum value of a numeric field. Select a field from the drop-down list.

Max

Returns the maximum value of a numeric field. Select a field from the drop-down list.

Unique Count

Returns the number of unique values in a field. Select a field from the drop-down list.

To create a tile maps panel, complete the following steps:

  1. Enter a string in the Custom Label field to change the display label.

  2. Specify if you are splitting the chart or displaying the buckets as Geo Coordinates on a single chart.

    A multiple chart split must run before any other aggregations.

    Tile maps use the Geohash aggregation as their initial aggregation.

  3. Select a field, typically coordinates, from the drop-down list.

    The Precision slider determines the granularity of the results displayed on the map. See the Kibana documentation for the geohash grid aggregation for details on the area specified by each precision level.

  4. Once you’ve specified a buckets aggregation, define sub-aggregations to refine the visualization.

    Tile maps only support sub-aggregations as split charts. Click + Add Sub Aggregation, then Split Chart to select a sub-aggregation from the list of types:

    Data Histogram

    A data 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 check box to include empty intervals in the histogram.

    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. 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.

    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.

    IPv4 Range

    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.

    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.

    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.

    Significant Terms

    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.

    Geohash

    The geohash aggregation displays points based on the geohash coordinates.

    [Note]Note

    By default, the Change precision on map zoom box is checked. Clear the box to disable this behavior.

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

    Exclude Pattern

    Specifies 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

    Specifies 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:

    { "script" : "doc['grade'].value * 1.2" }

    The availability of these options varies depending on the aggregation you choose.

  6. Select the Options tab to change the following aspects of the chart:

    Map type

    Select one of the following options from the drop-down list.

    Scaled Circle Markers

    Scale the size of the markers based on the metric aggregation’s value.

    Shaded Circle Markers

    Displays the markers with different shades based on the metric aggregation’s value.

    Shaded Geohash Grid

    Displays the rectangular cells of the geohash grid instead of circular markers, with different shades based on the metric aggregation’s value.

    Heatmap

    A heat map applies blurring to the circle markers and applies shading based on the amount of overlap. Heatmaps have the following options:

    • Radius-Sets the size of the individual heatmap dots.

    • Blur-Sets the amount of blurring for the heatmap dots.

    • Maximum zoom-Tilemaps in Kibana support 18 zoom levels. This slider defines the maximum zoom level at which the heatmap dots appear at full intensity.

    • Minimum opacity-Sets the opacity cutoff for the dots.

    • Show Tooltip-Check this box to have a tooltip with the values for a given dot when the cursor is on that dot.

    Desaturate map tiles

    Check this box to have a tooltip with the values for a given dot when the cursor is on that dot.

    WMS compliant map server

    Check this box to enable the use of a third-party mapping service that complies with the Web Map Service (WMS) standard. Specify the following elements:

    WMS url

    The URL for the WMS map service.

    WMS layers

    A comma-separated list of the layers to use in this visualization. Each map server provides its own list of layers.

    WMS version

    The WMS version used by this map service.

    WMS format

    The image format used by this map service. The two most common formats are image/png and image/jpeg.

    WMS attribution

    An optional, user-defined string that identifies the map source. Maps display the attribution string in the lower right corner.

    WMS styles

    A comma-separated list of the styles to use in this visualization. Each map server provides its own styling options.

  7. 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.