forked from elastic/kibana
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into new-search-layout
* master: (33 commits) [easy] Exclude __examples__ from coverage (elastic#45556) [DOCS] Update CCR links (elastic#44012) Use unique junit report filenames again (elastic#45897) [ftr/savedObjects] add simple saved object api client to ftr s… (elastic#45856) New visualization editor Lens (elastic#36437) Sort using unix timestamp value (elastic#43162) [APM] Use POST instead of implicit GET (elastic#45903) [Canvas] Converting workpad header components to typescript and adding i18n (elastic#45274) skip flaky test (elastic#45884) set IS_PIPELINE_JOB in intake jobs (elastic#45850) [Uptime] Fix/issue 48 integration popup closes after refresh (elastic#45759) [Logs UI] Support zoom by brushing in the log rate chart (elastic#45879) [DOCS] Changes name to host (elastic#45798) [ML] Add population job wizard test (elastic#45765) [skip-ci][Maps][File upload] Geojson indexing and styling docs (elastic#41394) remove setTimeoue for state change (elastic#45853) [Graph] Restructure folders and add readme (elastic#45782) [ML] Enhance job id error message (elastic#45349) [SIEM] Do not update state component when they did unmount (elastic#45847) [i18n] sync from 7.4 latest translations (elastic#45823) ...
- Loading branch information
Showing
673 changed files
with
42,319 additions
and
11,719 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -18,4 +18,4 @@ JOB: | |
# - x-pack-visualRegression | ||
|
||
# `~` is yaml for `null` | ||
exclude: ~ | ||
exclude: ~ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Validating CODEOWNERS rules …
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,43 @@ | ||
[role="xpack"] | ||
[[geojson-upload]] | ||
== Upload GeoJSON data | ||
*Elastic Maps* makes it easy to import geospatial data into the Elastic Stack. | ||
Using the *GeoJSON Upload* feature, you can drag and drop your point and shape | ||
data files directly into {es}, and then use them as layers | ||
in the map. You can also use the GeoJSON data in the broader Kibana ecosystem, | ||
for example, in visualizations and Canvas workpads. | ||
[float] | ||
=== Why GeoJSON? | ||
GeoJSON is an open-standard file format for storing geospatial vector data. | ||
Although many vector data formats are available in the GIS community, | ||
GeoJSON is the most commonly used and flexible option. | ||
[float] | ||
|
||
=== Upload a GeoJSON file | ||
Follow the instructions below to upload a GeoJSON data file, or try the | ||
<<indexing-geojson-data-tutorial, end-to-end integrated example>>. | ||
|
||
. Open *Elastic Maps*, and then click *Add layer*. | ||
. Click *Upload GeoJSON vector file*. | ||
+ | ||
[role="screenshot"] | ||
image::maps/images/fu_gs_select_source_file_upload.png[] | ||
|
||
. Use the file chooser to select a valid GeoJSON file. The file will load | ||
a preview of the data on the map. | ||
. Use the default *Index type* of {ref}/geo-point.html[geo_point] for point data, | ||
or override it and select {ref}/geo-shape.html[geo_shape]. | ||
All other shapes will default to a type of `geo_shape`. | ||
. Leave the default *Index name* and *Index pattern* names (the name of the uploaded | ||
file minus its extension). You might need to change the index name if it is invalid. | ||
. Click *Import file*. | ||
+ | ||
Upon completing the indexing process and creating the associated index pattern, | ||
the Elasticsearch responses are shown on the *Layer add panel* and the indexed data | ||
appears on the map. The geospatial data on the map | ||
should be identical to the locally-previewed data, but now it's indexed data from Elasticsearch. | ||
|
||
. To continue adding data to the map, click *Add layer* in the lower | ||
right-hand corner. | ||
. In *Layer settings*, adjust any settings or <<maps-vector-style-properties, properties>> as needed. | ||
. Click *Save & close*. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,142 @@ | ||
[role="xpack"] | ||
[[indexing-geojson-data-tutorial]] | ||
== Indexing GeoJSON data tutorial | ||
|
||
In this tutorial, you'll build a customized map that shows the flight path between | ||
two airports, and the lightning hot spots on that route. You'll learn to: | ||
|
||
* Import GeoJSON files into Kibana | ||
* Index the files in {es} | ||
* Display the data in a multi-layer map | ||
|
||
[float] | ||
=== Before you begin | ||
|
||
This tutorial requires you to download the following GeoJSON sample data files. | ||
These files are good examples of the types | ||
of vector data that you can upload to Kibana and index in | ||
Elasticsearch for display in *Elastic Maps*. | ||
|
||
* https://raw.githubusercontent.com/elastic/examples/master/Maps/Getting%20Started%20Examples/geojson_upload_and_styling/logan_international_airport.geojson[Logan International Airport] | ||
* https://raw.githubusercontent.com/elastic/examples/master/Maps/Getting%20Started%20Examples/geojson_upload_and_styling/bangor_international_airport.geojson[Bangor International Airport] | ||
* https://raw.githubusercontent.com/elastic/examples/master/Maps/Getting%20Started%20Examples/geojson_upload_and_styling/lightning_detected.geojson[Lightning detected] | ||
* https://raw.githubusercontent.com/elastic/examples/master/Maps/Getting%20Started%20Examples/geojson_upload_and_styling/original_flight_path.geojson[Original flight path] | ||
* https://raw.githubusercontent.com/elastic/examples/master/Maps/Getting%20Started%20Examples/geojson_upload_and_styling/modified_flight_path.geojson[Modified flight path] | ||
|
||
The data represents two real airports, two fictitious flight routes, and | ||
fictitious lightning reports. You don't need to use all of | ||
these files. Feel free to work with as many files as you'd like, or use valid GeoJSON | ||
files of your own. | ||
|
||
[float] | ||
[role="xpack"] | ||
=== Create and set up a map | ||
|
||
. <<maps-create, Create a new map>>. | ||
. Zoom in on the New England area in the northeast United States. | ||
+ | ||
You're adding flight paths to this area, and this | ||
sets up the map for a good view of the data. | ||
+ | ||
[role="screenshot"] | ||
image::maps/images/fu_gs_new_england_map.png[] | ||
|
||
[float] | ||
[[upload-and-index-geojson-file]] | ||
=== Upload and index GeoJSON files | ||
For each GeoJSON file you downloaded, complete the following steps: | ||
|
||
. Below the map legend, click *Add layer*. | ||
. From the list of layer types, click *Upload GeoJSON vector file*. | ||
. Using the File Picker, upload the GeoJSON file. | ||
+ | ||
Depending on the geometry type of your features, this will | ||
auto-populate *Index type* with either {ref}/geo-point.html[geo_point] or | ||
{ref}/geo-shape.html[geo_shape] and *Index name* with | ||
`<file name>`. | ||
|
||
. Click *Import file* in the lower right. | ||
+ | ||
You'll see activity as the GeoJSON Upload utility creates a new index | ||
and index pattern for the data set. When the process is complete, you should | ||
receive messages that the creation of the new index and index pattern | ||
were successful. | ||
|
||
. Click *Add layer* in the bottom right. | ||
|
||
. In *Layer settings*, adjust settings and <<maps-vector-style-properties, properties>> as needed. | ||
. Click *Save & close*. | ||
. Once you've added all of the sample files, | ||
<<maps-save, save your map>>. | ||
+ | ||
At this point, you could consider the map complete, | ||
but there are a few additions and tweaks that you can make to tell a | ||
better story with your data. | ||
+ | ||
[role="screenshot"] | ||
image::maps/images/fu_gs_flight_paths.png[] | ||
|
||
[float] | ||
=== Add a heatmap aggregation layer | ||
|
||
Looking at the `Lightning detected` layer, it's clear where lightning has | ||
struck. What's less clear, is if there have been more lightning | ||
strikes in some areas than others, in other words, where the lightning | ||
hot spots are. An advantage of having indexed | ||
{ref}/geo-point.html[geo_point] data for the | ||
lightning strikes is that you can perform aggregations on the data. | ||
|
||
. Below the map legend, click *Add layer*. | ||
. From the list of layer types, click *Grid aggregation*. | ||
+ | ||
Because you indexed `lightning_detected.geojson` using the index name and | ||
pattern `lightning_detected`, that data is available as a {ref}/geo-point.html[geo_point] | ||
aggregation. | ||
|
||
. Select `lightning_detected`. | ||
. Click *Show as* and select `heat map`. | ||
. Click *Add layer* to add the heat map layer | ||
"Lightning intensity". | ||
+ | ||
The remaining default settings are good, but there are a couple of | ||
settings that you might want to change. | ||
|
||
. Under *Source settings* > *Grid resolution*, select from the different heat map resolutions. | ||
+ | ||
The default "Coarse" looks | ||
good, but feel free to select a different resolution. | ||
|
||
. Play around with the *Layer Style* > | ||
*Color range* setting. | ||
+ | ||
Again the default looks good, but feel free to choose a | ||
different color range. | ||
|
||
. When you're finished modifying settings, click *Save & close*. | ||
+ | ||
With your new lightning heat map layer, your map should look | ||
like this: | ||
+ | ||
[role="screenshot"] | ||
image::maps/images/fu_gs_lightning_intensity.png[] | ||
|
||
|
||
[float] | ||
=== Organize the layers | ||
|
||
Consider ways you might improve the appearance of the final map. | ||
Small changes in how and when layers are shown can help tell a | ||
better story with your data. Here are a few final tweaks | ||
you might make: | ||
|
||
* Update layer names | ||
* Adjust styles for each layer | ||
* Adjust the layer order | ||
* Decide which layers to show at different zoom levels | ||
|
||
When you've finished, again be sure to <<maps-save, save your work >>. | ||
|
||
Your final map might look like this: | ||
|
||
[role="screenshot"] | ||
image::maps/images/fu_gs_final_map.png[] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.