Commit graph

7984 commits

Author SHA1 Message Date
James Rodewig
6f11752ffe
[DOCS] Fix _doc_count field title (#65704) 2020-12-02 08:13:43 -05:00
István Zoltán Szabó
6f323ad0b1
[DOCS] Changes wording of pivot parameter in PUT transforms API docs. (#65731) 2020-12-02 14:07:17 +01:00
Christoph Büscher
3c3a43249f
Support unmapped fields in search 'fields' option (#65386)
Currently, the 'fields' option only supports fetching mapped fields. Since
'fields' is meant to be the central place to retrieve document content, it
should allow for loading unmapped values. This change adds implementation and
tests for this feature.

Closes #63690
2020-12-01 21:40:27 +01:00
Gil Raphaelli
b4233f0cd4
[DOCS] Fix _doc_count example typo (#65686) 2020-12-01 13:53:33 -05:00
James Rodewig
1c3ddf8ff1
[DOCS] EQL: Flatten EQL syntax headings (#65693) 2020-12-01 12:56:12 -05:00
Christoph Büscher
c327794ae8
Fix range query on date fields for number inputs (#63692)
Currently, if you write a date range query with numeric 'to' or 'from' bounds,
they can be interpreted as years if no format is provided. We use
"strict_date_optional_time||epoch_millis" in this case that can interpret inputs
like 1000 as the year 1000 for example. 
This PR change this to always interpret and parse numbers with the "epoch_millis"
parser if no other formatter was provided.

Closes #63680
2020-12-01 18:49:50 +01:00
James Rodewig
ac1dbb7ffd
[DOCS] EQL: Remove outdated wildcard ref (#65684) 2020-12-01 11:30:17 -05:00
James Rodewig
eac210436b
[DOCS] Label legacy rollup APIs (#65518) 2020-12-01 09:00:45 -05:00
James Rodewig
581e5c82b4
[DOCS] Update rollup glossary item (#65519)
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
2020-12-01 08:57:07 -05:00
bellengao
80df5fe2f3
[DOCS] Correct restore snapshot API request example (#65525) 2020-11-30 13:55:37 -05:00
James Rodewig
d3613ab1b5
[DOCS] Replace "time-series" with "time series" (#65620) 2020-11-30 12:39:24 -05:00
Henning Andersen
8fa1eea6f6
Searchable snapshot terminology (#65549)
We chose to use searchable snapshot index over snapshot-backed index, so
changed terminology towards this in a couple places.
2020-11-30 17:14:47 +01:00
David Turner
60442b8ec4
Clarify snapshot incrementality (#65587)
Today we describe snapshots as "incremental" but their incrementality is
rather different beast from e.g. incremental filesystem backups. With
traditional backups you take a large and relatively infrequent "full"
backup and then a sequence of smaller "incremental" ones, and this whole
sequence of backups is required for a restore so it must be kept around
until at least the next full backup. In contrast, Elasticsearch
snapshots are logically independent and each can be deleted without
affecting the integrity of the others.

This distinction frequently causes confusion amongst newer users, so
this commit clarifies what we mean by "incremental" in the docs.
2020-11-30 14:49:41 +00:00
James Rodewig
f727f8eb21
[DOCS] Clarify metrics is array of strings (#65611) 2020-11-30 09:46:51 -05:00
James Rodewig
630cb18b79
[DOCS] Add require_alias query param to reindex API (#65608) 2020-11-30 09:30:40 -05:00
Henning Andersen
9d55cbd110
Cold tier time-range should not be specified (#65546)
Whether the cold tier can handle years depends a lot on the use case and
for instance our BWC guarantees. This would need to be part of a
specific sizing exercise, so in the spirit of not over-promising, the
description of the cold tier has been changed to not mention years.
2020-11-30 15:04:41 +01:00
Dimitris Athanasiou
d1485eb3b1
[DOCS] Add missing "with" in remote reindex doc (#65532) 2020-11-30 08:32:18 -05:00
David Kyle
be86dd5625
Mute rollup docs test (#65585)
For #65544
2020-11-30 10:43:13 +00:00
Yang Wang
bdd99b250f
Deprecate cert gen without a CA and add self-signed option (#64037)
Generating a CA on the fly is an attempt at workflow optimisation that was
inherited from certgen. There are potential pitfalls with this approach. Overall
it is recommended to separate the step of CA creation and mandate a CA to be
specified when generating certificate.

This PR add a deprecation message if the cert command is used without specifying
a CA. A follow up PR will throw error for this usage in 8.0.

For use case where we explicitly trust a certificate without needing a CA, e.g.
SAML message signing, the PR adds a --self-signed option to the cert sub-command
to generate self-signed certificate.
2020-11-30 08:46:02 +11:00
Henning Andersen
302e5761fc
Clarify searchable snapshot cost trade-offs (#65384)
Clarify that searchable snapshots only result in cost savings for less
frequently accessed data and that the savings do not apply to the entire
cluster.
2020-11-26 13:40:08 +01:00
Lyudmila Fokina
c758dc7f4a
Introduce an additional hasher (PBKDF2_STRETCH) (#65328)
* Introduce an additional hasher that is PBKDF2 but pads the input to > 14 chars before hashing to comply with FIPS Approve Only mode

* Introduce an additional hasher that is PBKDF2 but pads the input to > 14 chars before hashing to comply with FIPS Approve Only mode

* Addressing the PR feedback
adding doc changes

* Renaming the hash function + rephrasing the doc descriptions

* Removing leftover from the doc

* Return HexCharArray instead of Base64 encoding and avoid intermediate
String

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2020-11-26 13:29:19 +01:00
James Rodewig
167600c824 [DOCS] Remove rollup index ref 2020-11-25 17:29:13 -05:00
James Rodewig
427930d30a
[DOCS] Add rollup V2 security privileges (#65512) 2020-11-25 15:48:51 -05:00
James Rodewig
b8c6ba2afd
[DOCS] Add ILM action redirects (#65479) (#65506) 2020-11-25 11:25:09 -05:00
James Rodewig
a941c7147f
[DOCS] Add rollup V2 API docs (#65398)
Changes:

* Documents new `<index>/_rollup` API
* Updates rollup APIs overview page
* Enables rollups V2 in docs integ tests
2020-11-25 11:16:06 -05:00
Julie Tibshirani
abe5e1707e
Remove note on marking copy_to fields as stored. (#65459)
During highlighting, we now load all values that were copied into the field
through copy_to. So there's no longer a reason to set 'store: true' to account
for fields not available in _source.
2020-11-25 08:01:36 -08:00
James Rodewig
a18b87ddc1
[DOCS] Flatten EQL syntax headings (#65497) 2020-11-25 10:30:24 -05:00
Igor Motov
a065b6d8da
Return an error when a rate aggregation cannot calculate bucket sizes (#65429)
In some cases when the rate aggregation is not a child of a date histogram
aggregation, it is not possible to determine the actual size of the date
histogram bucket. In this case the rate aggregation now throws an exception.

Closes #63703
2020-11-25 10:05:51 -05:00
James Rodewig
0805ff17a5
[DOCS] Fix redirects and anchors (#65472) (#65474) 2020-11-24 19:59:52 -05:00
James Rodewig
8e1081662c [DOCS] Fix xref 2020-11-24 19:32:39 -05:00
James Rodewig
a6a2e417b5 [DOCS] Fix typo 2020-11-24 19:29:28 -05:00
Tal Levy
a6755c3be8
Add mention of geo_shape support in geotile and geohash grid agg docs (#61129)
Previously, geo_shape support was only mentioned in a dedicated x-pack
section. This may be misleading, as the introductory paragraph only
mentions geo_point.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2020-11-24 13:57:42 -08:00
Andras Palinkas
e242eb6a43
SQL: Add method args to PERCENTILE/PERCENTILE_RANK (#65026)
* Adds the capability to have functions with two optional arguments
* Adds two new optional arguments to `PERCENTILE()` and
  `PERCENTILE_RANK()` functions, namely the method and
  method_parameter which can be: 1) `tdigest` and a double `compression`
  parameter or 2) `hdr` and an integer representing the
  `number_of_digits` parameter.
* Integration tests
* Documentation updates

Closes #63567
2020-11-24 14:17:56 -05:00
James Rodewig
b9ee0b3b48
[DOCS] EQL: Add lookup support to : operator (#65262) 2020-11-24 10:48:41 -05:00
bellengao
273b7bfe04
[DOCS] Correct the url in delete-component-template doc (#65349) 2020-11-24 09:48:17 -05:00
David Roberts
fc72b39a17
[ML] Adjusting soft_limit description (#65383)
This PR adds detail to the explanation of the soft_limit
memory_status in ML job stats. A consequence that was not
mentioned before is that examples are not added to category
definitions.

Relates elastic/ml-cpp#1590
2020-11-24 09:35:07 +00:00
Tal Levy
b514d9bf2e
Add geo_line aggregation (#41612)
A metric aggregation that aggregates a set of points as 
a GeoJSON LineString ordered by some sort parameter.

#### specifics

A `geo_line` aggregation request would specify a `geo_point` field, as well
as a `sort` field. `geo_point` represents the values used in the LineString, 
while the `sort` values will be used as the total ordering of the points.

the `sort` field would support any numeric field, including date.

#### sample usage

```
{
	"query": {
		"bool": {
			"must": [
				{ "term": { "person": "004" } },
				{ "term": { "trajectory": "20090131002206.plt" } }
			]
		}
	},
	"aggs": {
		"make_line": {
			"geo_line": {
				"point": {"field": "location"},
				"sort": { "field": "timestamp" },
                                "include_sort": true,
                                "sort_order": "desc",
                                "size": 15
			}
		}
	}
}
```

#### sample response

```
{
    "took": 21,
    "timed_out": false,
    "_shards": {...},
    "hits": {...},
    "aggregations": {
        "make_line": {
            "type": "LineString",
            "coordinates": [
                [
                    121.52926194481552,
                    38.92878997139633
                ],
                [
                    121.52922699227929,
                    38.92876998055726
                ],
             ]
        }
    }
}
```

#### visual response

<img width="540" alt="Screen Shot 2019-04-26 at 9 40 07 AM" src="https://user-images.githubusercontent.com/388837/56834977-cf278e00-6827-11e9-9c93-005ed48433cc.png">

#### limitations

Due to the cardinality of points, an initial max of 10k points 
will be used. This should support many use-cases.

One solution to overcome this limitation is to keep a PriorityQueue of
points, and simplifying the line once it hits this max. If simplifying
makes sense, it may be a nice option, in general. The ability to use a parameter
to specify how aggressive one wants to simplify. This parameter could be 
the number of points. Example algorithm one could use with a PriorityQueue:
https://bost.ocks.org/mike/simplify/. This would still require O(m) space, where m
is the number of points returned. And would also require heapifying triangles
sorted by their areas, which would be O(log(m)) operations. Since sorting is done, 
anyways, simplifying would still be a O(n log(m)) operation, where n is the total number 
of points to filter........... something to explore


closes #41649
2020-11-23 10:26:27 -08:00
David Turner
41e9ae51b0
Add snapshots to important config list (#65338)
The _Important Elasticsearch configuration_ docs lists a number of items
that you should consider before moving to production. Today this list
does not include configuring snapshots, even though they're very
important to have in production. This commit addresses that omission,
removes some repetition from the introductory paragraphs, and notes that
this config is handled for you on Cloud.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2020-11-23 14:26:07 +00:00
István Zoltán Szabó
a85fb5534a
[DOCS] Fixes typo in Aggregating data for faster performance. (#65354) 2020-11-23 12:44:59 +01:00
Wylie Conlon
10ee0f2878
Clarify field data cache behavior in docs (#64375)
* Clarify that field data cache includes global ordinals
* Describe that the cache should be cleared once the limit is reached
* Clarify that the `_id` field does not supported aggregations anymore
* Fold the `fielddata` mapping parameter page into the `text field docs
* Improve cross-linking
2020-11-20 13:53:23 -08:00
István Zoltán Szabó
f1e54a63a1
[DOCS] Adds UI related limitation to configuring aggs docs (#65184)
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
2020-11-20 19:03:18 +01:00
bellengao
2d9b83e32c
[DOCS] Fix formatting issue in search explain docs (#65303) 2020-11-20 09:01:01 -05:00
István Zoltán Szabó
1e045da339
[DOCS] Makes the screenshot larger on the custom URLs page. (#65269) 2020-11-20 09:29:39 +01:00
James Rodewig
f83ed81cb3
[DOCS] Document xpack.http.proxy.scheme setting (#65264) 2020-11-19 15:31:24 -05:00
James Rodewig
a8ddf76526
[DOCS] ILM: Add alloc ex with multiple node attributes (#65266) 2020-11-19 12:17:10 -05:00
James Rodewig
a51107a845
[DOCS] Document get data stream API's _meta prop (#65221) 2020-11-19 09:51:03 -05:00
James Rodewig
ce644909dc
[DOCS] EQL: Add wildcard support to : operator (#65237) 2020-11-19 08:26:13 -05:00
DeDe Morton
fb53dc3167
Fix links to Fleet overview (#65174) 2020-11-18 10:26:04 -08:00
James Rodewig
cc75bda411
[DOCS] Remote reindex is not fwd compatible (#65207) 2020-11-18 12:29:05 -05:00
Armin Braun
cb657c2629
Fix Allocation include Filter Docs (#65202)
Fix documentation to match actual behavior of `include` type filters.

Closes #65113
2020-11-18 17:59:59 +01:00