Commit graph

10171 commits

Author SHA1 Message Date
David Turner
dfab580976
Limit length of lag detector hot threads log lines (#92851)
If debug logging is enabled then the lag detector will capture and
report the hot threads of a lagging node. In some cases the resulting
log message can be very large, exceeding 10kiB, which means it is
truncated in most logging setups. The relevant thread(s) may be waiting
on I/O, which is not considered "hot" and therefore may not appear in
the first 10kiB.

This commit adjusts this logging mechanism to split the message into
chunks of size at most 2kiB (after compression and base64-encoding) to
ensure that the entire hot threads output can be faithfully
reconstructed from these logs.

Closes #88126
2023-01-13 13:11:26 +00:00
Mary Gouseti
a7fdd3c036
GA the Health API under the url /_health_report (#92879) 2023-01-13 10:42:38 +01:00
Stef Nestor
d9cbefc19c
[DOC] Troubleshooting Expensive Searches (#92725)
* [DOC] Troubleshooting Expensive Searches

👋 re: https://github.com/elastic/elasticsearch/issues/73222 adds in content so we can link to users on how to find source of expensive searches.

* Several edits

* Apply suggestions from code review

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@elastic.co>

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@elastic.co>
2023-01-13 09:55:13 +01:00
Benjamin Trent
a46e532cda
Allow more than one KNN search clause (#92118)
It makes sense to allow more than one KNN search clause per individual search request. It may be that different documents have separate vector spaces or that a single doc is index with more than one vector space. In both of these scenarios, users may want to retrieve a resulting set that takes into account all their indexed vector spaces. 

A prime example here would be searching a semantic text embedding along with searching an image embedding. 


closes https://github.com/elastic/elasticsearch/issues/91187
2023-01-12 11:35:50 -05:00
Tanguy Leroux
dfa32a71a5
Adjust doc about dangling indices after node is detached from cluster (#92824)
Dangling indices are not imported automatically  since 8.0 but the
`elasticsearch-node detach-cluster` documentation still suggests it is.
It tried to make it more explicit by listing the Dangling API to use and
by using the work "manually".
2023-01-12 11:21:50 -05:00
Abdon Pijpelink
1bb660c810
[DOCS] Remove 'Watching event data' example (#92872) 2023-01-12 16:02:53 +01:00
Abdon Pijpelink
85e965a35c
[DOCS] Remove experimental flag from index vectors for kNN search docs (#92867) 2023-01-12 15:57:28 +01:00
David Kilfoyle
37f7b7b325
[Docs] Update remove processor with 'keep' option (#92836) 2023-01-11 12:52:35 -05:00
Abdon Pijpelink
f7226a7c42
[DOCS] Remove coming tag from 8.6 migration guide (#92827) 2023-01-11 17:58:14 +01:00
Abdon Pijpelink
0a3c7eb5fd
[DOCS] Remove coming tag from the 8.5 migration guide (#92828) 2023-01-11 17:57:44 +01:00
David Kyle
6acfbbcd8b
[ML] Utilise parallel allocations where the inference request contains multiple documents (#92359)
Divide work from the _infer API among all allocations
2023-01-11 12:38:35 +00:00
David Turner
9eba369356
Add known-issue docs for #92812 (#92813) 2023-01-11 11:18:27 +00:00
Iraklis Psaroudakis
92f9d34b69
[Docs] Forward port 8.6.0 release docs (#92792) 2023-01-10 19:10:51 +02:00
Abdon Pijpelink
227181d72b
[DOCS] Remove coming tag from 8.6.0 release notes (#92760) 2023-01-10 12:42:58 +00:00
István Zoltán Szabó
e4721f1dfe
[DOCS] Fine-tunes documentation on exclude/include in frequent items (#92758) 2023-01-10 12:23:27 +01:00
Daniel Mitterdorfer
8fc2d6af4c
Add log level for JVM logs (#92382)
With this commit we specify `level` in JVM logs. `level` helps to filter
more severe messages from mere debugging messages in logs and with this
change we are able to use it also for JVM logs.

Here are a few example lines:

Before:

```
[2022-12-15T06:19:16.936+0000][15181][gc,start    ] GC(0) Pause Young (Normal) (G1 Evacuation Pause)
```

After:

```
[2022-12-15T06:22:27.932+0000][16320][info][gc,start    ] GC(0) Pause Young (Normal) (G1 Evacuation Pause)
[2022-12-15T06:22:27.932+0000][16320][debug][gc,age      ] GC(0) Desired survivor size 14680064 bytes, new threshold 15 (max threshold 15)
[2022-12-15T06:22:27.935+0000][16320][info ][gc,phases   ] GC(0)   Pre Evacuate Collection Set: 0.1ms
[2022-12-15T06:22:27.935+0000][16320][trace][gc,age      ] GC(0) Age table with threshold 15 (max threshold 15)
```

Notice, that the log level might have trailing spaces.

See also
https://docs.oracle.com/en/java/javase/19/docs/specs/man/java.html#xlog-tags-and-levels
for the available log levels.
2023-01-10 07:58:18 +01:00
David Turner
6203560983
Fix docs for fault detection troubleshooting (#92749)
In #92742 we changed the logging around cluster membership changes but the docs
don't quite match the final version. This commit addresses that.
2023-01-09 10:17:06 +00:00
Ievgen Degtiarenko
22a1ba7b43
Expose tier balancing stats via internal endpoint (#92199) 2023-01-09 10:57:10 +01:00
David Turner
5182748318
Improve node-{join,left} logging for troubleshooting (#92742)
Today to troubleshoot an unstable cluster we ask the users to parse the
rather complex `node-join` and `node-left` messages emitted by the
`MasterService`. These messages may refer to many nodes, may be
truncated, and are generally pretty hard to work with.

With this commit we start to emit a simplified log message about each
node added and removed. It also renames the respective executor classes:

- `JoinTaskExecutor` -> `NodeJoinExecutor`
- `NodeRemovalClusterStateTaskExecutor` -> `NodeLeftExecutor`

This brings their names in line with each other, and the messages that
they emit, whilst preserving the older `node-join` and `node-left`
terminology as reported by the `MasterService`.

Finally, it updates the troubleshooting logs to reflect these new and
simplified logs.

Relates #92741
2023-01-09 04:34:41 -05:00
Ievgen Degtiarenko
42464200fe
Add forecasted_write_load and forecasted_shard_size_in_bytes to the endpoint (#92303) 2023-01-05 12:08:52 +01:00
Craig Taverner
e1d2d358f9
Improve docs for geo completion precision param (#92688)
Improve documentation around precision of geohash when used in
suggester completion matches of type `geo`.
2023-01-05 11:58:04 +01:00
Mary Gouseti
2192a982ac
Expose Health Api telemetry via xpack (#91708)
Every node (post `8.7`) collects stats from every health-api request it receives. We extend the `_xpack/usage` endpoint to expose these stats. When a node receives the request it will fan out to collect data from all other nodes, merge them and expose them. If the cluster is not fully upgraded, it will signal it with the `available` flag set to`false`.
2023-01-04 14:34:29 +01:00
Bogdan Pintea
ee8d83e765
ODBC: update required .NET Framework version (#88852)
Update required ODBC .NET Framework version to reflect the compatibility
with the 4.x versions, replacing pinning it to the (EOL'd) 4.0 one.

Replace the link to the 4.8 framework with the generic .net page link.
2023-01-04 14:16:14 +01:00
iamthinh
a94036faf0
Update profile.asciidoc (#92655)
Fix small typo
2023-01-04 12:22:01 +01:00
Abdon Pijpelink
273711b347
[DOCS] Add docs for EQL max_samples_per_key parameter (#92634)
* [DOCS] Add docs for EQL max_samples_per_key parameter

* Add 'in total' clarification
2023-01-04 11:11:24 +01:00
Nicolas Ruflin
71739416cf
[Docs] Add more details to the index option docs (#92606)
Docs around the `index` option were not very precise. The term "typical" was used without describing for which fields querying is still available when `index: false` is set. But more precise docs existed in the `doc_values` documentation found here for the index option: https://www.elastic.co/guide/en/elasticsearch/reference/current/doc-values.html This docs were mostly copied over.

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@elastic.co>
Co-authored-by: Abdon Pijpelink <abdon.pijpelink@elastic.co>
2023-01-04 09:09:21 +01:00
Abdon Pijpelink
ca955b9470
[DOCS] Documentation for EQL samples (#92504)
* Add samples section to EQL page

* Add EQL samples syntax

* Improve wording and structure

* Reword Required field section

* Improve wording

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2023-01-03 09:52:31 +01:00
Christoph Büscher
8067f01d48
Runtime fields to optionally ignore script errors (#92380)
Currently Elasticsearch always returns a shard failure once a runtime error arises from using a runtime field, the exception being script-less runtime fields. This also means that execution of the query for that shard stops, which is okay for development and exploration. In a production scenario, however, it is often desirable to ignore runtime errors and continue with the query execution.

This change adds a new a new on_script_error parameter to runtime field definitions similar to the already existing
parameter for index-time scripted fields. When `on_script_error` is set to `continue`, errors from script execution are effectively ignored. This means affected documents don't show up in query results, but also don't prevent other matches from the same shard. Runtime fields accessed through the fields API don't return values on errors, aggregations will ignore documents that throw errors.

Note that this change affects scripted runtime fields only, while leaving default behaviour untouched. Also, ignored errors are not reported back to users for now.

Relates to #72143
2022-12-23 09:29:12 +01:00
Ryan Ernst
3506d5e738
Document jvm options for cli tools (#92510)
This commit adds documentation for the CLI_JAVA_OPTS environment
variable.

closes #92503
2022-12-22 15:32:07 -08:00
Luiz Guilherme Pais dos Santos
9eec322424
Fix format for cluster.discovery_configuration_check.interval (#90452) 2022-12-22 16:11:33 +01:00
Frederic Dartayre
27878a78b5
Update get-settings.asciidoc (#91538)
If `include_defaults` is `true` the API returns the default settings from the node handling the API request.
2022-12-22 15:54:26 +01:00
Ryan Ernst
0421a21a6e
Use default text for preview warning with tcp readiness port (#92508)
The docs for the TCP readiness port have a preview warning, with custom
text. However, this doesn't render correctly in the docs. Rather than
figure out why the custom text doesn't render, this commit simply
removes the custom text in favor of the default preview text.
2022-12-21 13:49:15 -08:00
Madhusudhan Konda
af65e71114
The exception is inserted in a code block (#90325)
* The exception is inserted in a code block

* Update docs/reference/mapping/types/text.asciidoc

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@elastic.co>
2022-12-21 17:22:35 +01:00
Hendrik Muhs
b9c0315d24
[ML] add the ability to include and exclude values in Frequent items (#92414)
This PR adds include and excludes to frequent items. This will allow to filter values from the analysis.
2022-12-21 12:24:10 +01:00
James Rodewig
c0c105c210
[DOCS] Fix typo (#92481) 2022-12-21 10:17:49 +01:00
Andrei Dan
9170113036
[HealthAPI] Add support for the FEATURE_STATE affected resource (#92296)
The `shards_availability` indicator diagnoses the condition where
indices need to be restored from snapshot.
Starting with 8.0 using feature_states when restoring from snapshot is
mandatory.

This adds support for the `FEATURE_STATE` affected resource to aid with
building up the snapshot restore API call (which will need to include
all the indices and feature states reported by the restore-from-snapshot
diagnosis).

Note that the health API will not report any indices that are part of a
feature state.
2022-12-20 13:39:41 +00:00
QY
7b17e1b5dc
[DOCS] Remove outdated note in Date field type (#92408)
Negative epoch timestamps are supported in 8.2.0 by pr #80208
2022-12-20 14:01:11 +01:00
Andrei Dan
0993c31eb7
GA the health API (#92420)
This marks the Health API as generally available.
2022-12-20 10:26:53 +00:00
Yang Wang
56036676cb
JWT Realm - documentation update (#92409)
* wip

* Initial update for the JWT realm doc

* Apply suggestions from code review

Co-authored-by: amyjtechwriter <61687663+amyjtechwriter@users.noreply.github.com>

Co-authored-by: amyjtechwriter <61687663+amyjtechwriter@users.noreply.github.com>
2022-12-19 12:22:24 +00:00
David Turner
82ed1fbcc9
Clarify use of S3 lifecycle policies (#92427)
Clarifies that it doesn't work to transition to Glacier tiers, nor does
it work to use object expiry, and that the consequences can be severe.
2022-12-19 09:04:29 +00:00
Andrei Dan
3723af3ccd
[HealthAPI] Add size parameter that controls the number of affected resources returned (#92399)
This adds a `size` parameter that controls the maximum number of
returned affected resources. The parameter defaults to `1000`, must be
positive, and less than `10_000`
2022-12-16 16:15:01 +00:00
apurvsibal
ff6f1bc227
Wrapper query docs refer to transport client and HLRC #89263 (#91149) 2022-12-15 13:44:58 +00:00
Abdon Pijpelink
0ceb062491
Move 'Explore by use case' block down (#92231) 2022-12-14 18:44:20 +01:00
David Kyle
fbb6abd2f4
[ML] Increase the default timeout for start trained model deployment (#92328)
A 30 second timeout is inline with the default value used in most ML APIs.
2022-12-14 13:32:23 +00:00
Lee Hinman
f04c751997
Mark simulate index API non-experimental in documentation (#92331)
This has been stable for a long time, we just missed removing the experimental[] tag in the docs.
2022-12-13 11:34:32 -07:00
David Roberts
9fe9020dfc
[ML] Adding a known issue for the ML datafeed auth header problem (#92274)
Due to #41185 datafeeds created prior to 7.0 and not updated since
then have unparseable authorization headers in 8.x. In 8.0-8.3 this
could easily be a non-issue, as such datafeeds were likely forgotten
leftovers and never run. Even if it was a problem, only the datafeed
of interest would need updating with any urgency.

Due to #87884 datafeeds with authorization headers older than 7.0
prevent _all_ datafeeds being listed in 8.4 and 8.5. This in turn
breaks the anomaly detection job management section of the ML UI.

The problem is alleviated by #92168 and fixed by #92221, but we
should warn users that the problem exists in 8.4.0-8.5.3 inclusive.
2022-12-13 09:22:49 +00:00
Abdon Pijpelink
d4a778e0e3
[DOCS] Move known issues section to top of 8.5.0 release notes (#92304) 2022-12-12 17:35:51 +01:00
David Roberts
6fa3d73fd5
[ML] Make native inference generally available (#92213)
Previously this functionality was beta. This PR changes it to GA.
2022-12-12 15:43:30 +00:00
Abdon Pijpelink
0f9ccbd30e
[DOCS] Add missing privilege to bulk prerequisites (#92237) 2022-12-12 16:06:16 +01:00
István Zoltán Szabó
6561c47317
[DOCS] Adds example of better index resolve to transforms at scale (#92234)
Co-authored-by: Przemysław Witek <przemyslaw.witek@elastic.co>
2022-12-12 15:18:49 +01:00