Skip to content

Commit 7e3b51e

Browse files
authored
[skip-ci] Replace coordinate map in Kibana getting started docs with Maps (#50167) (#50227)
* [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 <[email protected]> * review feedback * update dashboard instructions to include step to set time fitler * clean up more instances for vector style * review feedback
1 parent 74b845d commit 7e3b51e

File tree

4 files changed

+47
-42
lines changed

4 files changed

+47
-42
lines changed

docs/getting-started/tutorial-dashboard.asciidoc

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,12 @@
22
=== Add visualizations to a dashboard
33

44
A dashboard is a collection of visualizations that you can arrange and share.
5-
You'll build a dashboard that contains the visualizations you saved during
5+
You'll build a dashboard that contains the visualizations and map that you saved during
66
this tutorial.
77

88
. Open *Dashboard*.
99
. On the Dashboard overview page, click *Create new dashboard*.
10+
. Set the time filter to May 18, 2015 to May 20, 2015.
1011
. Click *Add* in the menu bar.
1112
. Add *Bar Example*, *Map Example*, *Markdown Example*, and *Pie Example*.
1213
+
@@ -26,12 +27,12 @@ is on the lower right.
2627

2728
==== Inspect the data
2829

29-
Seeing visualizations of your data is great,
30+
Seeing visualizations of your data is great,
3031
but sometimes you need to look at the actual data to
3132
understand what's really going on. You can inspect the data behind any visualization
3233
and view the {es} query used to retrieve it.
3334

34-
. In the dashboard, hover the pointer over the pie chart, and then click the icon in the upper right.
35+
. In the dashboard, hover the pointer over the pie chart, and then click the icon in the upper right.
3536
. From the *Options* menu, select *Inspect*.
3637
+
3738
[role="screenshot"]

docs/getting-started/tutorial-visualizing.asciidoc

Lines changed: 40 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@
33

44
In the Visualize application, you can shape your data using a variety
55
of charts, tables, and maps, and more. In this tutorial, you'll create four
6-
visualizations:
6+
visualizations:
77

88
* <<tutorial-visualize-pie, Pie chart>>
99
* <<tutorial-visualize-bar, Bar chart>>
10-
* <<tutorial-visualize-map, Coordinate map>>
10+
* <<tutorial-visualize-map, Map>>
1111
* <<tutorial-visualize-markdown, Markdown widget>>
1212

1313
[float]
@@ -25,7 +25,7 @@ types in Kibana.
2525
image::images/tutorial-visualize-wizard-step-1.png[]
2626
. Click *Pie*.
2727

28-
. In *Choose a source*, select the `ba*` index pattern.
28+
. In *Choose a source*, select the `ba*` index pattern.
2929
+
3030
Initially, the pie contains a single "slice."
3131
That's because the default search matched all documents.
@@ -76,7 +76,7 @@ in a ring around the balance ranges.
7676
[role="screenshot"]
7777
image::images/tutorial-visualize-pie-3.png[]
7878

79-
. To save this chart so you can use it later, click *Save* in
79+
. To save this chart so you can use it later, click *Save* in
8080
the top menu bar and enter `Pie Example`.
8181

8282
[float]
@@ -123,29 +123,56 @@ you did at the beginning of the tutorial, when you marked the `play_name` field
123123
as `not analyzed`.
124124

125125
[float]
126-
[[tutorial-visualize-map]]
127-
=== Coordinate map
126+
[[tutorial-visualize-markdown]]
127+
=== Markdown
128128

129-
Using a coordinate map, you can visualize geographic information in the log file sample data.
129+
Create a Markdown widget to add formatted text to your dashboard.
130+
131+
. Create a *Markdown* visualization.
132+
. Copy the following text into the text box.
133+
+
134+
[source,markdown]
135+
# This is a tutorial dashboard!
136+
The Markdown widget uses **markdown** syntax.
137+
> Blockquotes in Markdown use the > character.
130138

131-
. Create a *Coordinate map* and set the search source to `logstash*`.
139+
. Click *Apply changes* image:images/apply-changes-button.png[].
132140
+
133-
You haven't defined any buckets yet, so the visualization is a map of the world.
141+
The Markdown renders in the preview pane.
142+
+
143+
[role="screenshot"]
144+
image::images/tutorial-visualize-md-2.png[]
145+
146+
. *Save* this visualization with the name `Markdown Example`.
147+
148+
[float]
149+
[[tutorial-visualize-map]]
150+
=== Map
151+
152+
Using <<maps>>, you can visualize geographic information in the log file sample data.
153+
154+
. Click *Maps* in the New Visualization
155+
menu to create a Map.
134156

135157
. Set the time.
136158
.. In the time filter, click *Show dates*.
137159
.. Click the start date, then *Absolute*.
138160
.. Set the *Start date* to May 18, 2015.
139161
.. In the time filter, click *now*, then *Absolute*.
140162
.. Set the *End date* to May 20, 2015.
163+
.. Click *Update*
141164

142165
. Map the geo coordinates from the log files.
143166

144-
.. In the *Buckets* pane, click *Add > Geo coordinates*.
145-
.. Set *Aggregation* to *Geohash*.
146-
.. Set *Field* to *geo.coordinates*.
167+
.. Click *Add layer*.
168+
.. Click the *Grid aggregation* data source.
169+
.. Set *Index pattern* to *logstash*.
170+
.. Click the *Add layer* button.
147171

148-
. Click *Apply changes* image:images/apply-changes-button.png[].
172+
. Set the layer style.
173+
.. For *Fill color*, select the yellow to red color ramp.
174+
.. For *Border color*, select white.
175+
.. Click *Save & close*.
149176
+
150177
The map now looks like this:
151178
+
@@ -155,26 +182,3 @@ image::images/tutorial-visualize-map-2.png[]
155182
. Navigate the map by clicking and dragging. Use the controls
156183
on the left to zoom the map and set filters.
157184
. *Save* this map with the name `Map Example`.
158-
159-
[float]
160-
[[tutorial-visualize-markdown]]
161-
=== Markdown
162-
163-
The final visualization is a Markdown widget that renders formatted text.
164-
165-
. Create a *Markdown* visualization.
166-
. Copy the following text into the text box.
167-
+
168-
[source,markdown]
169-
# This is a tutorial dashboard!
170-
The Markdown widget uses **markdown** syntax.
171-
> Blockquotes in Markdown use the > character.
172-
173-
. Click *Apply changes* image:images/apply-changes-button.png[].
174-
+
175-
The Markdown renders in the preview pane.
176-
+
177-
[role="screenshot"]
178-
image::images/tutorial-visualize-md-2.png[]
179-
180-
. *Save* this visualization with the name `Markdown Example`.
309 KB
Loading

docs/maps/maps-getting-started.asciidoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ the {es} index `kibana_sample_data_logs` on the shared key iso2 = geo.src.
8484
. Set *Right source* to *kibana_sample_data_logs*.
8585
. Set *Right field* to *geo.src*.
8686

87-
===== Set the vector style
87+
===== Set the layer style
8888

8989
All of the world countries are still a single color because the layer is using <<maps-vector-style-static, static styling>>.
9090
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[]
161161
. Select *Sum* in the aggregation select.
162162
. Select *bytes* in the field select.
163163

164-
===== Set the vector style
164+
===== Set the layer style
165165

166-
. In *Vector style*, change *Symbol size*:
166+
. In *Layer style*, change *Symbol size*:
167167
.. Set *Min size* to 1.
168168
.. Set *Max size* to 25.
169169
.. In the field select, select *sum of bytes*.

0 commit comments

Comments
 (0)