Configuration

edit

Data

edit

Metrics

edit

The default metrics aggregation for a coordinate map is the Count aggregation. You can select any of the following aggregations as the metrics aggregation:

Count
The count aggregation returns a raw count of the elements in the selected index pattern.
Average
This aggregation returns the average of a numeric field. Select a field from the drop-down.
Sum
The sum aggregation returns the total sum of a numeric field. Select a field from the drop-down.
Min
The min aggregation returns the minimum value of a numeric field. Select a field from the drop-down.
Max
The max aggregation returns the maximum value 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.

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

Buckets

edit

Coordinate maps use the {es-ref}search-aggregations-bucket-geohashgrid-aggregation.html[geohash] aggregation. Select a field, typically coordinates, from the drop-down.

  • The_Change precision on map zoom_ box is checked by default. Uncheck the box to disable this behavior. The Precision slider determines the granularity of the results displayed on the map. See the documentation for the geohash grid aggregation for details on the area specified by each precision level.

Higher precisions increase memory usage for the browser displaying Kibana as well as for the underlying Elasticsearch cluster.

  • The place markers off grid (use geocentroid) box is checked by default. When this box is checked, the markers are placed in the center of all the documents in that bucket. When unchecked, the markers are placed in the center of the geohash grid cell. Leaving this checked generally results in a more accurate visualization.

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

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

Exclude Pattern
Specify a pattern in this field to exclude from the results.
Include Pattern
Specify a pattern in this field to include in the results.
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" }

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

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

Options

edit
Map type
Select one of the following options from the drop-down.
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
Desaturate the map’s color in order to make the markers stand out more clearly.
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.

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

Navigating the Map

edit

Once your tilemap visualization is ready, you can explore the map in several ways:

  • Click and hold anywhere on the map and move the cursor to move the map center. Hold Shift and drag a bounding box across the map to zoom in on the selection.
  • Click the Zoom In/Out viz zoom buttons to change the zoom level manually.
  • Click the Fit Data Bounds viz fit bounds button to automatically crop the map boundaries to the geohash buckets that have at least one result.
  • Click the Latitude/Longitude Filter viz lat long filter button, then drag a bounding box across the map, to create a filter for the box coordinates.

Viewing Detailed Information

edit

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:

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

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

ResponseThe raw response from the server, presented in JSON format.

StatisticsA 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 the Raw 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.