[skip-ci] Replace coordinate map in Kibana getting started docs with Maps (#50167) (#50225)

* [Maps] replace coordinate map with Elastic Maps in Kibana getting started docs

* update dashboard getting started page

* update screen shot

* Update docs/getting-started/tutorial-visualizing.asciidoc

Co-Authored-By: gchaps <33642766+gchaps@users.noreply.github.com>

* review feedback

* update dashboard instructions to include step to set time fitler

* clean up more instances for vector style

* review feedback
This commit is contained in:
Nathan Reese 2019-11-11 18:20:21 -07:00 committed by GitHub
parent e2ff5186ae
commit 96e256a2c7
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
4 changed files with 50 additions and 45 deletions

View file

@ -2,11 +2,12 @@
=== Add visualizations to a dashboard
A dashboard is a collection of visualizations that you can arrange and share.
You'll build a dashboard that contains the visualizations you saved during
You'll build a dashboard that contains the visualizations and map that you saved during
this tutorial.
. Open *Dashboard*.
. On the Dashboard overview page, click *Create new dashboard*.
. Set the time filter to May 18, 2015 to May 20, 2015.
. Click *Add* in the menu bar.
. Add *Bar Example*, *Map Example*, *Markdown Example*, and *Pie Example*.
+
@ -26,12 +27,12 @@ is on the lower right.
==== Inspect the data
Seeing visualizations of your data is great,
Seeing visualizations of your data is great,
but sometimes you need to look at the actual data to
understand what's really going on. You can inspect the data behind any visualization
and view the {es} query used to retrieve it.
. In the dashboard, hover the pointer over the pie chart, and then click the icon in the upper right.
. In the dashboard, hover the pointer over the pie chart, and then click the icon in the upper right.
. From the *Options* menu, select *Inspect*.
+
[role="screenshot"]

View file

@ -3,11 +3,11 @@
In the Visualize application, you can shape your data using a variety
of charts, tables, and maps, and more. In this tutorial, you'll create four
visualizations:
visualizations:
* <<tutorial-visualize-pie, Pie chart>>
* <<tutorial-visualize-bar, Bar chart>>
* <<tutorial-visualize-map, Coordinate map>>
* <<tutorial-visualize-map, Map>>
* <<tutorial-visualize-markdown, Markdown widget>>
[float]
@ -25,7 +25,7 @@ types in Kibana.
image::images/tutorial-visualize-wizard-step-1.png[]
. Click *Pie*.
. In *Choose a source*, select the `ba*` index pattern.
. In *Choose a source*, select the `ba*` index pattern.
+
Initially, the pie contains a single "slice."
That's because the default search matched all documents.
@ -76,7 +76,7 @@ in a ring around the balance ranges.
[role="screenshot"]
image::images/tutorial-visualize-pie-3.png[]
. To save this chart so you can use it later, click *Save* in
. To save this chart so you can use it later, click *Save* in
the top menu bar and enter `Pie Example`.
[float]
@ -122,45 +122,11 @@ broken into individual words. This is the result of the mapping
you did at the beginning of the tutorial, when you marked the `play_name` field
as `not analyzed`.
[float]
[[tutorial-visualize-map]]
=== Coordinate map
Using a coordinate map, you can visualize geographic information in the log file sample data.
. Create a *Coordinate map* and set the search source to `logstash*`.
+
You haven't defined any buckets yet, so the visualization is a map of the world.
. Set the time.
.. In the time filter, click *Show dates*.
.. Click the start date, then *Absolute*.
.. Set the *Start date* to May 18, 2015.
.. In the time filter, click *now*, then *Absolute*.
.. Set the *End date* to May 20, 2015.
. Map the geo coordinates from the log files.
.. In the *Buckets* pane, click *Add > Geo coordinates*.
.. Set *Aggregation* to *Geohash*.
.. Set *Field* to *geo.coordinates*.
. Click *Apply changes* image:images/apply-changes-button.png[].
+
The map now looks like this:
+
[role="screenshot"]
image::images/tutorial-visualize-map-2.png[]
. Navigate the map by clicking and dragging. Use the controls
on the left to zoom the map and set filters.
. *Save* this map with the name `Map Example`.
[float]
[[tutorial-visualize-markdown]]
=== Markdown
The final visualization is a Markdown widget that renders formatted text.
Create a Markdown widget to add formatted text to your dashboard.
. Create a *Markdown* visualization.
. Copy the following text into the text box.
@ -178,3 +144,41 @@ The Markdown renders in the preview pane.
image::images/tutorial-visualize-md-2.png[]
. *Save* this visualization with the name `Markdown Example`.
[float]
[[tutorial-visualize-map]]
=== Map
Using <<maps>>, you can visualize geographic information in the log file sample data.
. Click *Maps* in the New Visualization
menu to create a Map.
. Set the time.
.. In the time filter, click *Show dates*.
.. Click the start date, then *Absolute*.
.. Set the *Start date* to May 18, 2015.
.. In the time filter, click *now*, then *Absolute*.
.. Set the *End date* to May 20, 2015.
.. Click *Update*
. Map the geo coordinates from the log files.
.. Click *Add layer*.
.. Click the *Grid aggregation* data source.
.. Set *Index pattern* to *logstash*.
.. Click the *Add layer* button.
. Set the layer style.
.. For *Fill color*, select the yellow to red color ramp.
.. For *Border color*, select white.
.. Click *Save & close*.
+
The map now looks like this:
+
[role="screenshot"]
image::images/tutorial-visualize-map-2.png[]
. Navigate the map by clicking and dragging. Use the controls
on the left to zoom the map and set filters.
. *Save* this map with the name `Map Example`.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 318 KiB

After

Width:  |  Height:  |  Size: 626 KiB

View file

@ -84,7 +84,7 @@ the {es} index `kibana_sample_data_logs` on the shared key iso2 = geo.src.
. Set *Right source* to *kibana_sample_data_logs*.
. Set *Right field* to *geo.src*.
===== Set the vector style
===== Set the layer style
All of the world countries are still a single color because the layer is using <<maps-vector-style-static, static styling>>.
To shade the world countries based on which country is sending the most requests, you'll need to use <<maps-vector-style-data-driven, data driven styling>>.
@ -161,9 +161,9 @@ image::maps/images/grid_metrics_both.png[]
. Select *Sum* in the aggregation select.
. Select *bytes* in the field select.
===== Set the vector style
===== Set the layer style
. In *Vector style*, change *Symbol size*:
. In *Layer style*, change *Symbol size*:
.. Set *Min size* to 1.
.. Set *Max size* to 25.
.. In the field select, select *sum of bytes*.