Skip to content

Commit

Permalink
Merge branch '8.x' into fix-upgrade-test
Browse files Browse the repository at this point in the history
  • Loading branch information
elasticmachine authored Nov 12, 2024
2 parents e85da97 + 803de16 commit b538029
Show file tree
Hide file tree
Showing 50 changed files with 1,303 additions and 235 deletions.
5 changes: 5 additions & 0 deletions docs/changelog/114193.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
pr: 114193
summary: Add postal_code support to the City and Enterprise databases
area: Ingest Node
type: enhancement
issues: []
5 changes: 5 additions & 0 deletions docs/changelog/114268.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
pr: 114268
summary: Support more maxmind fields in the geoip processor
area: Ingest Node
type: enhancement
issues: []
5 changes: 5 additions & 0 deletions docs/changelog/114521.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
pr: 114521
summary: Add support for registered country fields for maxmind geoip databases
area: Ingest Node
type: enhancement
issues: []
5 changes: 5 additions & 0 deletions docs/changelog/114548.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
pr: 114548
summary: Support IPinfo database configurations
area: Ingest Node
type: enhancement
issues: []
6 changes: 6 additions & 0 deletions docs/changelog/114934.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
pr: 114934
summary: "[ES|QL] To_DatePeriod and To_TimeDuration return better error messages on\
\ `union_type` fields"
area: ES|QL
type: bug
issues: []
5 changes: 5 additions & 0 deletions docs/changelog/116447.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
pr: 116447
summary: Adding a deprecation info API warning for data streams with old indices
area: Data streams
type: enhancement
issues: []
7 changes: 7 additions & 0 deletions docs/changelog/116583.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
pr: 116583
summary: Fix NPE in `EnrichLookupService` on mixed clusters with <8.14 versions
area: ES|QL
type: bug
issues:
- 116529
- 116544
13 changes: 10 additions & 3 deletions docs/reference/how-to/knn-search.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -95,13 +95,20 @@ and https://elasticsearch-benchmarks.elastic.co/#tracks/dense_vector[here] some
of datasets and configurations that we use for our nightly benchmarks.

[discrete]
[[dense-vector-preloading]]
include::search-speed.asciidoc[tag=warm-fs-cache]

The following file extensions are used for the approximate kNN search:
Each extension is broken down by the quantization types.

* `vec` and `veq` for vector values
* `vex` for HNSW graph
* `vem`, `vemf`, and `vemq` for metadata
* `vex` for the HNSW graph
* `vec` for all non-quantized vector values. This includes all element types: `float`, `byte`, and `bit`.
* `veq` for quantized vectors indexed with <<dense-vector-quantization,`quantization`>>: `int4` or `int8`
* `veb` for binary vectors indexed with <<dense-vector-quantization,`quantization`>>: `bbq`
* `vem`, `vemf`, `vemq`, and `vemb` for metadata, usually small and not a concern for preloading

Generally, if you are using a quantized index, you should only preload the relevant quantized values and the HNSW graph.
Preloading the raw vectors is not necessary and might be counterproductive.

[discrete]
=== Reduce the number of index segments
Expand Down
4 changes: 2 additions & 2 deletions docs/reference/index-modules/store.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -143,8 +143,8 @@ terms dictionaries, postings lists and points, which are the most important
parts of the index for search and aggregations.

For vector search, you use <<approximate-knn, approximate k-nearest neighbor search>>,
you might want to set the setting to vector search files: `["vec", "vex", "vem"]`
("vec" is used for vector values, "vex" – for HNSW graph, "vem" – for metadata).
you might want to set the setting to vector search files. See <<dense-vector-preloading, vector preloading>> for a detailed
list of the files.

Note that this setting can be dangerous on indices that are larger than the size
of the main memory of the host, as it would cause the filesystem cache to be
Expand Down
Original file line number Diff line number Diff line change
@@ -1,30 +1,30 @@
[[delete-geoip-database-api]]
=== Delete geoip database configuration API
[[delete-ip-location-database-api]]
=== Delete IP geolocation database configuration API
++++
<titleabbrev>Delete geoip database configuration</titleabbrev>
<titleabbrev>Delete IP geolocation database configuration</titleabbrev>
++++

Deletes a geoip database configuration.
Deletes a IP geolocation database configuration.

[source,console]
----
DELETE /_ingest/geoip/database/my-database-id
DELETE /_ingest/ip_location/database/my-database-id
----
// TEST[skip:we don't want to leak the enterprise-geoip-downloader task, which touching these APIs would cause. Therefore, skip this test.]


[[delete-geoip-database-api-request]]
[[delete-ip-location-database-api-request]]
==== {api-request-title}

`DELETE /_ingest/geoip/database/<database>`
`DELETE /_ingest/ip_location/database/<database>`

[[delete-geoip-database-api-prereqs]]
[[delete-ip-location-database-api-prereqs]]
==== {api-prereq-title}

* If the {es} {security-features} are enabled, you must have the
`manage` <<privileges-list-cluster,cluster privilege>> to use this API.

[[delete-geoip-database-api-path-params]]
[[delete-ip-location-database-api-path-params]]
==== {api-path-parms-title}

`<database>`::
Expand All @@ -35,21 +35,21 @@ DELETE /_ingest/geoip/database/my-database-id
--


[[delete-geoip-database-api-query-params]]
[[delete-ip-location-database-api-query-params]]
==== {api-query-parms-title}

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=timeoutparms]


[[delete-geoip-database-api-example]]
[[delete-ip-location-database-api-example]]
==== {api-examples-title}


[[delete-geoip-database-api-specific-ex]]
===== Delete a specific geoip database configuration
[[delete-ip-location-database-api-specific-ex]]
===== Delete a specific IP geolocation database configuration

[source,console]
----
DELETE /_ingest/geoip/database/example-database-id
DELETE /_ingest/ip_location/database/example-database-id
----
// TEST[skip:we don't want to leak the enterprise-geoip-downloader task, which touching these APIs would cause. Therefore, skip this test.]
Original file line number Diff line number Diff line change
@@ -1,33 +1,33 @@
[[get-geoip-database-api]]
=== Get geoip database configuration API
[[get-ip-location-database-api]]
=== Get IP geolocation database configuration API
++++
<titleabbrev>Get geoip database configuration</titleabbrev>
<titleabbrev>Get IP geolocation database configuration</titleabbrev>
++++

Returns information about one or more geoip database configurations.
Returns information about one or more IP geolocation database configurations.

[source,console]
----
GET /_ingest/geoip/database/my-database-id
GET /_ingest/ip_location/database/my-database-id
----
// TEST[skip:we don't want to leak the enterprise-geoip-downloader task, which touching these APIs would cause. Therefore, skip this test.]



[[get-geoip-database-api-request]]
[[get-ip-location-database-api-request]]
==== {api-request-title}

`GET /_ingest/geoip/database/<database>`
`GET /_ingest/ip_location/database/<database>`

`GET /_ingest/geoip/database`
`GET /_ingest/ip_location/database`

[[get-geoip-database-api-prereqs]]
[[get-ip-location-database-api-prereqs]]
==== {api-prereq-title}

* If the {es} {security-features} are enabled, you must have the
`manage` <<privileges-list-cluster,cluster privilege>> to use this API.

[[get-geoip-database-api-path-params]]
[[get-ip-location-database-api-path-params]]
==== {api-path-parms-title}

`<database>`::
Expand All @@ -38,22 +38,22 @@ supported.
To get all database configurations, omit this parameter or use `*`.


[[get-geoip-database-api-query-params]]
[[get-ip-location-database-api-query-params]]
==== {api-query-parms-title}

include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=master-timeout]


[[get-geoip-database-api-example]]
[[get-ip-location-database-api-example]]
==== {api-examples-title}


[[get-geoip-database-api-specific-ex]]
===== Get information for a specific geoip database configuration
[[get-ip-location-database-api-specific-ex]]
===== Get information for a specific IP geolocation database configuration

[source,console]
----
GET /_ingest/geoip/database/my-database-id
GET /_ingest/ip_location/database/my-database-id
----
// TEST[skip:we don't want to leak the enterprise-geoip-downloader task, which touching these APIs would cause. Therefore, skip this test.]

Expand Down
18 changes: 8 additions & 10 deletions docs/reference/ingest/apis/index.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -25,23 +25,21 @@ Use the following APIs to get statistics about ingest processing:
the <<geoip-processor,`geoip` processor>>.

[discrete]
[[ingest-geoip-database-apis]]
=== Ingest GeoIP Database APIs

preview::["The commercial IP geolocation database download management APIs are in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but this feature is not subject to the support SLA of official GA features."]
[[ingest-ip-location-database-apis]]
=== Ingest IP Location Database APIs

Use the following APIs to configure and manage commercial IP geolocation database downloads:

* <<put-geoip-database-api>> to create or update a database configuration
* <<get-geoip-database-api>> to retrieve a database configuration
* <<delete-geoip-database-api>> to delete a database configuration
* <<put-ip-location-database-api>> to create or update a database configuration
* <<get-ip-location-database-api>> to retrieve a database configuration
* <<delete-ip-location-database-api>> to delete a database configuration

include::put-pipeline.asciidoc[]
include::get-pipeline.asciidoc[]
include::delete-pipeline.asciidoc[]
include::simulate-pipeline.asciidoc[]
include::simulate-ingest.asciidoc[]
include::geoip-stats.asciidoc[]
include::put-geoip-database.asciidoc[]
include::get-geoip-database.asciidoc[]
include::delete-geoip-database.asciidoc[]
include::put-ip-location-database.asciidoc[]
include::get-ip-location-database.asciidoc[]
include::delete-ip-location-database.asciidoc[]
72 changes: 0 additions & 72 deletions docs/reference/ingest/apis/put-geoip-database.asciidoc

This file was deleted.

Loading

0 comments on commit b538029

Please sign in to comment.