Skip to content

Commit 8151092

Browse files
Documentation for time-series geo_line (#97373)
* Documentation for time-series geo_line * Fix incorrect ids in geoline docs * Some updates from review Added image of kibana map, improved first example, linked to TSDS and added section on line simplification with link to wikipedia. * Diagrams of truncation versus simplification
1 parent cda4b86 commit 8151092

File tree

6 files changed

+419
-56
lines changed

6 files changed

+419
-56
lines changed

docs/changelog/94954.yaml

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,25 @@
11
pr: 94954
2-
summary: Asset tracking - geo_line for TSDB
2+
summary: Asset tracking - geo_line in time-series aggregations
33
area: Geo
44
type: enhancement
5-
issues: []
5+
issues: [ ]
6+
highlight:
7+
title: Asset tracking - geo_line in time-series aggregations
8+
body: |-
9+
The <<search-aggregations-metrics-geo-line,`geo_line` aggregation>> builds tracks from `geo_points`.
10+
It has previously needed to use large arrays in memory for collecting points into multiple buckets
11+
and sorting those buckets.
12+
13+
With the advances made in TSDB features and the `time_series` aggregation in particular,
14+
it is now possible to rely on data aggregating in both TSID and timestamp order,
15+
enabling the removal of all sorting, as well as the use of only a single bucket's
16+
worth of memory, a dramatic improvement in memory footprint. In addition, we can use the streaming line
17+
simplifier algorithm introduced in https://github.com/elastic/elasticsearch/pull/94859 to replace the previous
18+
behaviour of truncating very large tracks with the far more preferable approach of simplifying those tracks.
19+
20+
[role="screenshot"]
21+
image:images/spatial/kodiak_geo_line_simplified.png[North short of Kodiak Island simplified to 100 points]
22+
23+
In this diagram, the grey line is the original geometry, the blue line is the truncated geometry as would be
24+
produced by the original `geo_line` aggregation, and the magenta line is the new simplified geometry.
25+
notable: false

0 commit comments

Comments
 (0)