From ced66b52b35b6b4bccdde6fe7c394b14a81b626a Mon Sep 17 00:00:00 2001 From: Nathan Reese Date: Tue, 3 Sep 2019 15:54:02 -0600 Subject: [PATCH 1/5] [skip-ci][Maps] Improve Maps intro page --- docs/maps/index.asciidoc | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/maps/index.asciidoc b/docs/maps/index.asciidoc index cb7ddd62d6c47..48ba1b9e88519 100644 --- a/docs/maps/index.asciidoc +++ b/docs/maps/index.asciidoc @@ -1,11 +1,23 @@ [role="xpack"] [[maps]] -= Maps += Elastic Maps [partintro] -- -The **Maps** application enables you to parse through your geographical data at scale, with speed, and in real time. With features like multiple layers and indices in a map, plotting of raw documents, dynamic client-side styling, and global search across multiple layers, you can understand and monitor your data with ease. +Elastic Maps enables you to parse through your geographical data at scale, with speed, and in real time. With features like multiple layers and indices in a map, plotting of raw documents, dynamic client-side styling, and global search across multiple layers, you can understand and monitor your data with ease. + +With Elastic Maps, you can: + +* Upload GeoJSON files into Elasticsearch. +* Create Maps with multiple layers and indices. +* <> your Map in Dashboards. +* Plot <>. +* Use <> to plot any data set, no matter how large. +* Create <>. +* <> your data by property, such as size, color, symbol, and rotation. +* Use <> to symbolize features from property values. +* Focus the data you want to display with <>. [role="screenshot"] image::maps/images/sample_data_ecommerce.png[] From 52e63c5a9c35c71cf2cfa79c881fa34f340e4972 Mon Sep 17 00:00:00 2001 From: Nathan Reese Date: Wed, 4 Sep 2019 18:18:41 -0600 Subject: [PATCH 2/5] review feedback --- docs/maps/index.asciidoc | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/maps/index.asciidoc b/docs/maps/index.asciidoc index 48ba1b9e88519..f395c5791321c 100644 --- a/docs/maps/index.asciidoc +++ b/docs/maps/index.asciidoc @@ -9,15 +9,15 @@ Elastic Maps enables you to parse through your geographical data at scale, with With Elastic Maps, you can: -* Upload GeoJSON files into Elasticsearch. * Create Maps with multiple layers and indices. -* <> your Map in Dashboards. -* Plot <>. -* Use <> to plot any data set, no matter how large. -* Create <>. -* <> your data by property, such as size, color, symbol, and rotation. -* Use <> to symbolize features from property values. -* Focus the data you want to display with <>. +* Upload GeoJSON files into Elasticsearch. +* Embed your Map in Dashboards. +* Plot individual documents. +* Use aggregations to plot any data set, no matter how large. +* Create choropleth maps. +* Customize your data by property, such as size, color, symbol, and rotation. +* Use data driven styling to symbolize features from property values. +* Focus the data you want to display with searches. [role="screenshot"] image::maps/images/sample_data_ecommerce.png[] From 5a2375c9b931c35c22ad0676b1bc3436702ef845 Mon Sep 17 00:00:00 2001 From: Nathan Reese Date: Thu, 5 Sep 2019 12:36:44 -0600 Subject: [PATCH 3/5] trim list to 7 items, add link to getting started guide, change all references to app to Elastic Maps --- docs/maps/connect-to-ems.asciidoc | 6 +++--- docs/maps/index.asciidoc | 6 +++--- docs/maps/maps-getting-started.asciidoc | 10 +++++----- docs/maps/search.asciidoc | 2 +- docs/maps/trouble-shooting.asciidoc | 4 ++-- 5 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/maps/connect-to-ems.asciidoc b/docs/maps/connect-to-ems.asciidoc index 75018e6dd4d97..ce609f9fba5cc 100644 --- a/docs/maps/connect-to-ems.asciidoc +++ b/docs/maps/connect-to-ems.asciidoc @@ -4,9 +4,9 @@ https://www.elastic.co/elastic-maps-service[Elastic Maps Service (EMS)] is a service that hosts tile layers and vector shapes of administrative boundaries. -If you are using Kibana's out-of-the-box settings, the **Maps** application is already configured to use EMS. +If you are using Kibana's out-of-the-box settings, **Elastic Maps** is already configured to use EMS. -The **Maps** application makes requests directly from the browser to EMS. +The **Elastic Maps** makes requests directly from the browser to EMS. To proxy EMS requests through the Kibana server, set `map.proxyElasticMapsServiceInMaps` to `true` in your <> file. @@ -19,5 +19,5 @@ behind a firewall. If this happens, you can disable the EMS connection to avoid To disable EMS, change your <> file. . Set `map.includeElasticMapsService` to `false` to turn off the EMS connection. -. Set `map.tilemap.url` to the URL of your tile server. This configures the **Maps** default tile layer. +. Set `map.tilemap.url` to the URL of your tile server. This configures **Elastic Maps** default tile layer. . (Optional) Set `map.regionmap` to the vector shapes of the administrative boundaries that you want to use. diff --git a/docs/maps/index.asciidoc b/docs/maps/index.asciidoc index f395c5791321c..1ed482605b881 100644 --- a/docs/maps/index.asciidoc +++ b/docs/maps/index.asciidoc @@ -12,13 +12,13 @@ With Elastic Maps, you can: * Create Maps with multiple layers and indices. * Upload GeoJSON files into Elasticsearch. * Embed your Map in Dashboards. -* Plot individual documents. -* Use aggregations to plot any data set, no matter how large. +* Plot individual documents or use aggregations to plot any data set, no matter how large. * Create choropleth maps. -* Customize your data by property, such as size, color, symbol, and rotation. * Use data driven styling to symbolize features from property values. * Focus the data you want to display with searches. +Start your tour of Elastic Maps with the <>. + [role="screenshot"] image::maps/images/sample_data_ecommerce.png[] diff --git a/docs/maps/maps-getting-started.asciidoc b/docs/maps/maps-getting-started.asciidoc index 68163f5e88a0e..f6db2f0fff219 100644 --- a/docs/maps/maps-getting-started.asciidoc +++ b/docs/maps/maps-getting-started.asciidoc @@ -1,8 +1,8 @@ [role="xpack"] [[maps-getting-started]] -== Getting started with Maps +== Getting started with Elastic Maps -You work with *Maps* by adding layers. The data for a layer can come from +You work with *Elastic Maps* by adding layers. The data for a layer can come from sources such as {es} documents, vector sources, tile map services, web map services, and more. You can symbolize the data in different ways. For example, you might show which airports have the longest flight @@ -14,7 +14,7 @@ light to dark. image::maps/images/sample_data_web_logs.png[] [[maps-read-only-access]] -NOTE: If you have insufficient privileges to create or save maps, a read-only icon +NOTE: If you have insufficient privileges to create or save maps, a read-only icon appears in the application header. The buttons to create new maps or edit existing maps won't be visible. For more information on granting access to Kibana see <>. @@ -25,7 +25,7 @@ image::maps/images/read-only-badge.png[Example of Maps' read only access indicat [float] === Prerequisites Before you start this tutorial, <>. Each -sample data set includes a map to go along with the data. Once you've added the data, open *Maps* and +sample data set includes a map to go along with the data. Once you've added the data, open *Elastic Maps* and explore the different layers of the *[Logs] Total Requests and Bytes* map. You'll re-create this map in this tutorial. @@ -44,7 +44,7 @@ In this tutorial, you'll learn to: The first thing to do is to create a new map. -. If you haven't already, open *Maps*. +. If you haven't already, open *Elastic Maps*. . On the maps list page, click *Create map*. . Set the time range to *Last 7 days*. + diff --git a/docs/maps/search.asciidoc b/docs/maps/search.asciidoc index 33a8ba15113d8..3830ecdcbc1f0 100644 --- a/docs/maps/search.asciidoc +++ b/docs/maps/search.asciidoc @@ -2,7 +2,7 @@ [[maps-search]] == Searching your data -The **Maps** application embeds the query bar for real-time ad hoc search. +**Elastic Maps** embeds the query bar for real-time ad hoc search. Only layers requesting data from {es} are filtered when you submit a search request. You can create a layer that requests data from {es} from the following: diff --git a/docs/maps/trouble-shooting.asciidoc b/docs/maps/trouble-shooting.asciidoc index d23bed546a6dc..56fcd25a9a3d6 100644 --- a/docs/maps/trouble-shooting.asciidoc +++ b/docs/maps/trouble-shooting.asciidoc @@ -1,13 +1,13 @@ [role="xpack"] [[maps-troubleshooting]] -== Maps troubleshooting +== Elastic Maps troubleshooting Use the information in this section to inspect Elasticsearch requests and find solutions to common problems. [float] === Inspect Elasticsearch requests -The Maps application uses the {ref}/search-search.html[{es} search API] to get documents and aggregation results from {es}. To troubleshoot these requests, open the Inspector, which shows the most recent requests for each layer. You can switch between different requests using the *Request* dropdown. +Elastic Maps uses the {ref}/search-search.html[{es} search API] to get documents and aggregation results from {es}. To troubleshoot these requests, open the Inspector, which shows the most recent requests for each layer. You can switch between different requests using the *Request* dropdown. [role="screenshot"] image::maps/images/inspector.png[] From 3f4f98e937a173f2fa049a477f55800a219878fe Mon Sep 17 00:00:00 2001 From: Nathan Reese Date: Thu, 5 Sep 2019 13:41:03 -0600 Subject: [PATCH 4/5] review feedback --- docs/maps/connect-to-ems.asciidoc | 4 ++-- docs/maps/index.asciidoc | 6 +++--- docs/maps/trouble-shooting.asciidoc | 2 +- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/maps/connect-to-ems.asciidoc b/docs/maps/connect-to-ems.asciidoc index ce609f9fba5cc..6b4eb9928cea0 100644 --- a/docs/maps/connect-to-ems.asciidoc +++ b/docs/maps/connect-to-ems.asciidoc @@ -6,7 +6,7 @@ https://www.elastic.co/elastic-maps-service[Elastic Maps Service (EMS)] is a ser tile layers and vector shapes of administrative boundaries. If you are using Kibana's out-of-the-box settings, **Elastic Maps** is already configured to use EMS. -The **Elastic Maps** makes requests directly from the browser to EMS. +**Elastic Maps** makes requests directly from the browser to EMS. To proxy EMS requests through the Kibana server, set `map.proxyElasticMapsServiceInMaps` to `true` in your <> file. @@ -19,5 +19,5 @@ behind a firewall. If this happens, you can disable the EMS connection to avoid To disable EMS, change your <> file. . Set `map.includeElasticMapsService` to `false` to turn off the EMS connection. -. Set `map.tilemap.url` to the URL of your tile server. This configures **Elastic Maps** default tile layer. +. Set `map.tilemap.url` to the URL of your tile server. This configures the default tile layer of **Elastic Maps**. . (Optional) Set `map.regionmap` to the vector shapes of the administrative boundaries that you want to use. diff --git a/docs/maps/index.asciidoc b/docs/maps/index.asciidoc index 1ed482605b881..f1f0a083adfdc 100644 --- a/docs/maps/index.asciidoc +++ b/docs/maps/index.asciidoc @@ -9,15 +9,15 @@ Elastic Maps enables you to parse through your geographical data at scale, with With Elastic Maps, you can: -* Create Maps with multiple layers and indices. +* Create maps with multiple layers and indices. * Upload GeoJSON files into Elasticsearch. -* Embed your Map in Dashboards. +* Embed your map in Dashboards. * Plot individual documents or use aggregations to plot any data set, no matter how large. * Create choropleth maps. * Use data driven styling to symbolize features from property values. * Focus the data you want to display with searches. -Start your tour of Elastic Maps with the <>. +Start your tour of *Elastic Maps* with the <>. [role="screenshot"] image::maps/images/sample_data_ecommerce.png[] diff --git a/docs/maps/trouble-shooting.asciidoc b/docs/maps/trouble-shooting.asciidoc index 56fcd25a9a3d6..542138828530b 100644 --- a/docs/maps/trouble-shooting.asciidoc +++ b/docs/maps/trouble-shooting.asciidoc @@ -7,7 +7,7 @@ Use the information in this section to inspect Elasticsearch requests and find s [float] === Inspect Elasticsearch requests -Elastic Maps uses the {ref}/search-search.html[{es} search API] to get documents and aggregation results from {es}. To troubleshoot these requests, open the Inspector, which shows the most recent requests for each layer. You can switch between different requests using the *Request* dropdown. +*Elastic Maps* uses the {ref}/search-search.html[{es} search API] to get documents and aggregation results from {es}. To troubleshoot these requests, open the Inspector, which shows the most recent requests for each layer. You can switch between different requests using the *Request* dropdown. [role="screenshot"] image::maps/images/inspector.png[] From 40fc2dc277f63996deac678edf85d804a51daecf Mon Sep 17 00:00:00 2001 From: Nathan Reese Date: Thu, 5 Sep 2019 20:35:41 -0600 Subject: [PATCH 5/5] bold Elastic Maps in intro page --- docs/maps/index.asciidoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/maps/index.asciidoc b/docs/maps/index.asciidoc index f1f0a083adfdc..bb569a11ed874 100644 --- a/docs/maps/index.asciidoc +++ b/docs/maps/index.asciidoc @@ -5,9 +5,9 @@ [partintro] -- -Elastic Maps enables you to parse through your geographical data at scale, with speed, and in real time. With features like multiple layers and indices in a map, plotting of raw documents, dynamic client-side styling, and global search across multiple layers, you can understand and monitor your data with ease. +*Elastic Maps* enables you to parse through your geographical data at scale, with speed, and in real time. With features like multiple layers and indices in a map, plotting of raw documents, dynamic client-side styling, and global search across multiple layers, you can understand and monitor your data with ease. -With Elastic Maps, you can: +With *Elastic Maps*, you can: * Create maps with multiple layers and indices. * Upload GeoJSON files into Elasticsearch.