Merge branch 'master' of github.com:elastic/kibana into discover_open…

…_in_maps

docs/development/core/server/kibana-plugin-server.savedobjectsservicesetup.md

@@ -16,6 +16,8 @@ export interface SavedObjectsServiceSetup
 
 When plugins access the Saved Objects client, a new client is created using the factory provided to `setClientFactory` and wrapped by all wrappers registered through `addClientWrapper`<!-- -->.
 
+All the setup APIs will throw if called after the service has started, and therefor cannot be used from legacy plugin code. Legacy plugins should use the legacy savedObject service until migrated.
+
 ## Example 1
 
 

docs/redirects.asciidoc

@@ -43,7 +43,7 @@ This page was deleted. See <<xpack-graph>> and <<xpack-ml>>.
 [role="exclude",id="xpack-dashboard-only-mode"]
 == Dashboard-only mode
 
-Using the `kibana_dashboard_only_user` role is deprecated. 
+Using the `kibana_dashboard_only_user` role is deprecated.
 Use <<kibana-feature-privileges,feature privileges>> instead.
 
 [role="exclude",id="pdf-layout-modes"]
@@ -56,4 +56,7 @@ This page has moved. Please see <<reporting-getting-started>>.
 
 This page has moved. Please see <<reporting-getting-started>>.
 
+[role="exclude",id="tilemap"]
+== Coordinate map
 
+This page has moved. Please see <<coordinate-map>>.

docs/setup/settings.asciidoc

@@ -221,14 +221,14 @@ requests. Supported on Elastic Cloud Enterprise.
 Set to false to disable connections to Elastic Maps Service.
 When `includeElasticMapsService` is turned off, only the vector layers configured by `map.regionmap`
 and the tile layer configured by `map.tilemap.url` will be available in the <<maps, Maps application>>,
-<<tilemap, Coordinate map visualizations>>, and <<regionmap, Region map visualizations>>.
+<<tilemap, Coordinate map visualizations>>, and <<visualize-maps, Region map visualizations>>.
 
 `map.proxyElasticMapsServiceInMaps:`:: *Default: false*
 Set to true to proxy all <<maps, Maps application>> Elastic Maps Service requests through the Kibana server.
-This setting does not impact <<tilemap, Coordinate map visualizations>> and <<regionmap, Region map visualizations>>.
+This setting does not impact <<tilemap, Coordinate map visualizations>> and <<visualize-maps, Region map visualizations>>.
 
 [[regionmap-settings]] `map.regionmap:`:: Specifies additional vector layers for
-use in <<regionmap, Region Map>> visualizations. Supported on {ece}. Each layer
+use in <<visualize-maps, Region Map>> visualizations. Supported on {ece}. Each layer
 object points to an external vector file that contains a geojson
 FeatureCollection. The file must use the
 https://en.wikipedia.org/wiki/World_Geodetic_System[WGS84 coordinate reference system (ESPG:4326)]
@@ -254,7 +254,7 @@ The following example shows a valid regionmap configuration.
 [[regionmap-ES-map]]`map.includeElasticMapsService:`:: Turns on or off
 whether layers from the Elastic Maps Service should be included in the vector
 layer option list. Supported on Elastic Cloud Enterprise. By turning this off,
-only the layers that are configured here will be included. The default is `true`. 
+only the layers that are configured here will be included. The default is `true`.
 This also affects whether tile-service from the Elastic Maps Service will be available.
 
 [[regionmap-attribution]]`map.regionmap.layers[].attribution:`:: Optional.

docs/user/monitoring/elasticsearch-details.asciidoc

@@ -14,7 +14,7 @@ the <<cluster-overview-page, Overview>>, <<nodes-page, Nodes>>,
 [role="screenshot"]
 image::user/monitoring/images/monitoring-elasticsearch.jpg["Monitoring clusters"]
 
-See also {ref}/es-monitoring.html[Monitoring {es}].
+See also {ref}/monitor-elasticsearch-cluster.html[Monitor a cluster].
 
 [float]
 [[cluster-overview-page]]

docs/user/visualize.asciidoc

@@ -45,11 +45,11 @@ data sets.
 [horizontal]
 <<maps,Elastic Maps>>:: The most powerful way of visualizing map data in {kib}.
 
-<<tilemap,Coordinate map>>:: Displays points on a map using a geohash aggregation.
+<<visualize-maps,Coordinate map>>:: Displays points on a map using a geohash aggregation.
 
-<<regionmap,Region map>>:: Merge any structured map data onto a shape.
+<<visualize-maps,Region map>>:: Merge any structured map data onto a shape.
 
-<<heatmap,Heat map>>:: Display shaded cells within a matrix.
+<<visualize-maps,Heat map>>:: Display shaded cells within a matrix.
 
 * *<<for-dashboard,Dashboard tools>>*
 [horizontal]
@@ -136,8 +136,6 @@ include::{kib-repo-dir}/visualize/tsvb.asciidoc[]
 include::{kib-repo-dir}/visualize/timelion.asciidoc[]
 
 include::{kib-repo-dir}/visualize/tilemap.asciidoc[]
-include::{kib-repo-dir}/visualize/regionmap.asciidoc[]
-include::{kib-repo-dir}/visualize/heatmap.asciidoc[]
 
 include::{kib-repo-dir}/visualize/for-dashboard.asciidoc[]
 

docs/visualize/tilemap.asciidoc

@@ -1,47 +1,142 @@
-[[tilemap]]
-== Coordinate map
+[[visualize-maps]]
+== Maps
 
-Coordinate maps display geographic areas overlaid with circles keyed to the data determined by the buckets you specify. To use coordinate maps, you plot latitude and longitude coordinates.
+To tell a story and answer questions about your geographical data, you can create several types of interactive maps with Visualize.
 
-NOTE: Coordinate maps have been replaced with <<maps>>, which offers more functionality and is easier to use.
+Visualize supports the following maps:
 
-To create coordinate maps in Visualize:
+* *Coordinate* &mdash; Display latitude and longitude coordinates that are associated to the specified bucket aggregation.
 
-* Set `xpack.maps.showMapVisualizationTypes` to `true`.
+* *Region* &mdash; Display colored boundary vector shapes using a gradient. Darker colors indicate larger values, and lighter colors indicate smaller values.
+
+* *Heat* &mdash; Display graphical representations of data where the individual values are represented by colors.
 
-* To display map tiles, {kib} uses the https://www.elastic.co/elastic-maps-service[Elastic Maps Service].
-To use other tile service providers, configure the <<tilemap-settings,tilemap settings>>
-in `kibana.yml`.
+NOTE: The maps in Visualize have been replaced with <<maps>>, which offers more functionality.
 
 [float]
-[[coordinate-map-aggregation]]
-=== Supported aggregations
+[[coordinate-map]]
+=== Coordinate map
+
+Use a coordinate map when your data set includes latitude and longitude values. For example, use a coordinate map to see the varying popularity of destination airports using the sample flight data.
+
+[role="screenshot"]
+image::images/visualize_coordinate_map_example.png[]
+
+[float]
+[[build-coordinate-map]]
+==== Build a coordinate map
+
+Configure the `kibana.yml` settings and add the aggregations.
 
-Coordinate maps support the following aggregations:
+. Configure the following `kibana.yml` settings:
+
+* Set `xpack.maps.showMapVisualizationTypes` to `true`.
+
+* To use a tile service provider for coordinate maps other than https://www.elastic.co/elastic-maps-service[Elastic Maps Service], configure the <<tilemap-settings,tilemap settings>>.
+
+. To display your data on the coordinate map, use the following aggregations:
 
 * <<visualize-metric-aggregations,Metric>>
 
-* <<visualize-bucket-aggregations,Geohash Bucket aggregation>>
+* <<visualize-bucket-aggregations,Geohash bucket aggregation>>
 
-When you deselect *Change precision on map zoom*, the *Precision* slider appears. The *Precision* slider determines the granularity of the results displayed on the map. For details on the area specified by each precision level, refer to {ref}/search-aggregations-bucket-geohashgrid-aggregation.html#_cell_dimensions_at_the_equator[geohash grid].
+. Specify the geohash bucket aggregation options:
 
+* *Precision* slider &mdash; Determines the granularity of the results displayed on the map. To show the *Precision* slider, deselect *Change precision on map zoom*. For information on the area specified by each precision level, refer to {ref}/search-aggregations-bucket-geohashgrid-aggregation.html#_cell_dimensions_at_the_equator[geohash grid].
++
 NOTE: Higher precisions increase memory usage for the browser that displays {kib} and the underlying
 {es} cluster.
 
-When you select *Place markers off grid (use {ref}/search-aggregations-metrics-geocentroid-aggregation.html[geocentroid])*, the markers are
-placed in the center of all documents in the bucket, and a more accurate visualization is created.
-NOTE: When you have multiple values in the geo_point, the coordinate map is unable to accurately calculate the geo_centroid.
-
-When you deselect *Place markers off grid (use {ref}/search-aggregations-metrics-geocentroid-aggregation.html[geocentroid])*, the markers are placed in the center
+* *Place markers off grid (use {ref}/search-aggregations-metrics-geocentroid-aggregation.html[geocentroid])* &mdash; When you selected, the markers are
+placed in the center of all documents in the bucket, and a more accurate visualization is created. When deselected, the markers are placed in the center
 of the geohash grid cell.
++
+NOTE: When you have multiple values in the geo_point, the coordinate map is unable to accurately calculate the geo_centroid.
 
 [float]
-[[navigate-map]]
-=== Navigate the coordinate map
+[[navigate-coordinate-map]]
+==== Navigate the coordinate map
 
-Use the following navigation options:
+To navigate the coordinate map, use the navigation options.
 
 * To move the map center, click and hold anywhere on the map and move the cursor.
+
 * To change the zoom level, click *Zoom In* or *Zoom out* image:images/viz-zoom.png[].
+
 * To automatically crop the map boundaries to the
 geohash buckets that have at least one result, click *Fit Data Bounds* image:images/viz-fit-bounds.png[].
+
+[float]
+[[region-map]]
+=== Region map
+
+Use region maps when you want to show statistical data on a geographic area, such as a county, country, province, or state. For example, use a region map if you want to see the average sales for each country with the sample eCommerce order data.
+
+[role="screenshot"]
+image::images/visualize_region_map_example.png[]
+
+[float]
+[[build-region-maps]]
+==== Build a region map
+
+Configure the `kibana.yml` settings and add the aggregations.
+
+. In `kibana.yml`, set `xpack.maps.showMapVisualizationTypes` to `true`.
+
+. To display your data on the region map, use the following aggregations:
+
+* <<visualize-metric-aggregations,Metric>>
+* <<visualize-sibling-pipeline-aggregations,Sibling pipeline>>
+* <<visualize-bucket-aggregations,Terms bucket aggregation>>
+
+[float]
+[[navigate-region-map]]
+==== Navigate the region map
+
+To navigate the region map, use the navigation options.
+
+* To change the zoom level, click *Zoom In* or *Zoom out* image:images/viz-zoom.png[].
+
+* To automatically crop the map boundaries, click *Fit Data Bounds* image:images/viz-fit-bounds.png[].
+
+[float]
+[[heat-map]]
+=== Heat map
+
+Use heat maps when your data set includes categorical data. For example, use a heat map to see the flights of origin countries compared to destination countries using the sample flight data.
+
+[role="screenshot"]
+image::images/visualize_heat_map_example.png[]
+
+[float]
+[[build-heat-map]]
+==== Build a heat map
+
+To display your data on the heat map, use the supported aggregations.
+
+Heat maps support the following aggregations:
+
+* <<visualize-metric-aggregations,Metric>>
+* <<visualize-parent-pipeline-aggregations,Parent pipeline>>
+* <<visualize-sibling-pipeline-aggregations,Sibling pipeline>>
+* <<visualize-bucket-aggregations,Bucket>>
+
+[float]
+[[navigate-heatmap]]
+==== Change the color ranges
+
+When only one color displays on the heat map, you might need to change the color ranges.
+
+To specify the number of color ranges:
+
+. Click *Options*.
+
+. Enter the *Number of colors* to display.
+
+To specify custom ranges:
+
+. Click *Options*.
+
+. Select *Use custom ranges*.
+
+. Enter the ranges to display.