Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[skip-ci][Maps] Improve Maps intro page #44721

Merged
merged 5 commits into from
Sep 6, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/maps/connect-to-ems.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
**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 <<settings, kibana.yml>> file.


Expand All @@ -19,5 +19,5 @@ behind a firewall. If this happens, you can disable the EMS connection to avoid
To disable EMS, change your <<settings, kibana.yml>> 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 the default tile layer of **Elastic Maps**.
. (Optional) Set `map.regionmap` to the vector shapes of the administrative boundaries that you want to use.
16 changes: 14 additions & 2 deletions docs/maps/index.asciidoc
Original file line number Diff line number Diff line change
@@ -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:

* Create maps with multiple layers and indices.
* Upload GeoJSON files into Elasticsearch.
* 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 <<maps-getting-started, getting started tutorial>>.

nreese marked this conversation as resolved.
Show resolved Hide resolved
[role="screenshot"]
image::maps/images/sample_data_ecommerce.png[]
Expand Down
10 changes: 5 additions & 5 deletions docs/maps/maps-getting-started.asciidoc
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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 <<xpack-security-authorization>>.
Expand All @@ -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, <<add-sample-data, add the web logs sample data set>>. 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.

Expand All @@ -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*.
+
Expand Down
2 changes: 1 addition & 1 deletion docs/maps/search.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
4 changes: 2 additions & 2 deletions docs/maps/trouble-shooting.asciidoc
Original file line number Diff line number Diff line change
@@ -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[]
Expand Down