Commit Graph

158 Commits

Author SHA1 Message Date
David Kilfoyle 3295662697
[DOCS] Add time range info to TSDS docs (#91291)
* [DOCS] Add time range info to TSDS docs

* Fixup
2022-11-04 09:18:35 -04:00
David Kilfoyle 56397f5d4c
[Docs] Remove feature flag from downsampling page (#91228) 2022-11-01 09:51:22 -04:00
David Kilfoyle cad87c4d5a
[DOCS] Add Downsampling docs (#88571)
This adds documentation for downsampling of time series indices.
2022-10-12 12:10:16 -04:00
Christos Soulios 1a709caa65 [TSDB] Removed `summary` and `histogram` metric types (#89937)
It seems that for now we don't have a good use for the histogram and summary metric types. 
They had been left as place holders for a while, but at this point there is no concrete plan forward for them.

This PR removes the histogram and summary metric types. We may add them back in the future.

Also, this PR completely removes the time_series_metric mapping parameter from the histogram field type and only allows the gauge metric type for aggregate_metric_double fields.
2022-09-09 15:04:30 +03:00
David Kilfoyle 2a44a8982f
[DOCS] Remove feature flag from TSDS docs (#89673)
* Docs: Remove feature flag and add preview label to TSDS docs

* Fix technical preview tag
2022-08-29 10:33:55 -04:00
Martijn van Groningen 6ca2e796a9
Added additional index.look_ahead_time validation (#87847)
Added a requirement that index.look_ahead_time index setting
can't be lower than time_series.poll_interval setting.

Additional changes:
* Fixed a mistake in the docs that referenced indices.lifecycle.poll_interval
  instead of time_series.poll_interval.
* Moved index.look_ahead_time setting to data stream module.
2022-06-21 10:50:33 +02:00
David Kilfoyle 40e9f3097c
[DOCS] Add TSDS docs, take two (#87703)
* Revert "Revert "[DOCS] Add TSDS docs (#86905)" (#87702)"

This reverts commit 0c86d7b9b2.

* First fix to tests

* Add data_stream object to index template

* small rewording

* Add enable data stream object in gradle example setup

* Add bullet about data stream must be enabled in template
2022-06-16 12:44:10 -04:00
David Kilfoyle 0c86d7b9b2
Revert "[DOCS] Add TSDS docs (#86905)" (#87702)
Reverts elastic/elasticsearch#86905
2022-06-15 13:32:12 -04:00
David Kilfoyle d57f4ac2c6
[DOCS] Add TSDS docs (#86905)
* [DOCS] Add TSDB docs

* Update docs/build.gradle

Co-authored-by: Adam Locke <adam.locke@elastic.co>

* Address Nik's comments, part 1

* Address Nik's comments, part deux

* Reword write index

* Add feature flags

* Wrap one more section in feature flag

* Small fixes

* set index.routing_path to optional

* Update storage reduction value

* Update create index template code example

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-06-15 12:22:07 -04:00
James Rodewig 6c8f0b170b
[DOCS] Fix ordered list formatting in data stream docs (#81667) 2021-12-13 12:53:48 -05:00
Martijn van Groningen e20fe6d639
Add replicated field to get data stream api response. (#80988)
Internally we already kept track of whether a data stream is replicated by CCR.
It is part of the `DataStream` class. This just adds it to the xcontent serialization
of the get data stream api response class.

Relates to elastic/kibana#118899
2021-11-30 09:30:05 +01:00
Dan Hermann 1a0ae11f0d
[DOCS] Data stream modification API (#80094) 2021-11-10 08:37:12 -06:00
Dan Hermann 4a36d5cd79
Remove endpoint for freezing indices (#78918) 2021-10-26 06:37:56 -05:00
James Rodewig 58abbe941f
[DOCS] Fix cluster update settings refs (#79580)
The API is named 'cluster update settings,' not 'update cluster settings.'
2021-10-20 13:16:35 -04:00
Nikola Grcevski 055c770083
Deprecation of transient cluster settings (#78794)
This PR changes uses of transient cluster settings to
persistent cluster settings. 

The PR also deprecates the transient settings usage.

Relates to #49540
2021-10-15 13:00:52 -04:00
xiaoping 7e08c6b98a
Data stream support read and write with custom routing and partition size (#74394) 2021-10-11 07:14:15 -05:00
Joe Gallo 4a14f2f6f9
Validate that snapshot repository exists for ILM policies at creation/update time (#78468) 2021-10-04 15:19:10 -04:00
James Rodewig e246e1ce53
[DOCS] Remove 'step' from headings (#76753) 2021-08-20 08:52:04 -04:00
James Rodewig 0c205b0d68
[DOCS] Document how to switch ILM policies (#73967)
To switch an index's lifecycle policy, you must first remove the existing
policy. Otherwise, phase execution for the index may silently fail.

Closes #70151
2021-06-28 10:32:01 -04:00
James Rodewig 5729bb8d49
[DOCS] Update alias references (#73427)
Updates several `index aliases` references to `aliases`.
2021-05-27 16:00:57 -04:00
James Rodewig 39a0314d30
[DOCS] Update alias xrefs (#73380)
Updates several internal 'alias' xrefs to point to the aliases guide rather than
API docs.
2021-05-25 16:19:00 -04:00
James Rodewig b3a197715e
[DOCS] Update allowed operations on data stream write index (#72994)
With #70908, you can now close a write index in 7.12.1 and later versions.
This removes an outdated reference from the data stream overview docs.
2021-05-12 14:26:22 -04:00
Jay Modi a7dbb31765
Add Fleet action results system data stream (#71667)
This commit adds support for system data streams and also the first use
of a system data stream with the fleet action results data stream. A
system data stream is one that is used to store system data that users
should not interact with directly. Elasticsearch will manage these data
streams. REST API access is available for external system data streams
so that other stack components can store system data within a system
data stream. System data streams will not use the system index read and
write threadpools.
2021-04-20 13:33:12 -06:00
James Rodewig c23f001151
[DOCS] Add how-to guide for time series data (#71195) 2021-04-05 13:00:06 -04:00
James Rodewig 4963118fcc
[DOCS] Update button copy (#71220) 2021-04-02 09:06:50 -04:00
James Rodewig 3c02ab4190
[DOCS] Add ECS and runtime fields tip to data stream tutorial (#71183) 2021-04-01 15:54:53 -04:00
James Rodewig 115d2b2680 [DOCS] Reword data stream indexing section 2021-04-01 10:23:48 -04:00
James Rodewig a4fa22c099 [DOCS] Reword link to Fleet data stream docs 2021-04-01 10:15:56 -04:00
James Rodewig f41320616c
[DOCS] Refactor data stream setup tutorial (#71074) 2021-03-31 17:28:55 -04:00
James Rodewig 693807a6d3
[DOCS] Fix double spaces (#71082) 2021-03-31 09:57:47 -04:00
James Rodewig 20df933e6b
[DOCS] Update data stream rollover references (#70993) 2021-03-29 10:37:14 -04:00
James Rodewig 5c75d004fa
[DOCS] Replace `put` with `create or update` in API names (#70330)
Co-authored-by: debadair <debadair@elastic.co>
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-03-15 14:49:44 -04:00
Joe Gallo f93242a5f9
Switch built-in policies to max_primary_shard_size (#69995) 2021-03-04 17:00:45 -05:00
James Rodewig 14ea0072e9
[DOCS] Update priority recommendation for index templates (#69006) 2021-02-16 10:53:28 -05:00
James Rodewig 36d4c12b92
[DOCS] Update ILM screenshots and tutorial (#68482)
Changes:

- Reworks the ILM tutorial to focus on the Elastic Agent and a built-in ILM policy
- Updates several screenshots in the docs for the new ILM UI

Co-authored-by: debadair <debadair@elastic.co>
2021-02-05 08:57:37 -05:00
James Rodewig 8b5154883e
[DOCS] Add link to Elastic data stream naming scheme blog (#68449) 2021-02-03 09:36:02 -05:00
James Rodewig 3a6c837cff
[DOCS] Add Elastic data stream naming scheme docs (#68310) 2021-02-02 08:36:37 -05:00
James Rodewig ebf08c0c83
[DOCS] Reuse built-in index templates admon (#68314) 2021-02-01 12:34:21 -05:00
James Rodewig 97f1d13bdf
[DOCS] Reuse timestamp reqs (#68299)
Removes some duplication and reuses information about data stream
timestamp requirements using a tagged region.
2021-02-01 09:44:54 -05:00
Martijn van Groningen e42c009884
Adjust manage_follow_index privilege for promote data stream api (#67773)
This fixes the manage_follow_index builtin privilege so that it can be used
for managing data streams in a follower cluster. In order to successfully
unfollow a data stream the promote data stream and rollover APIs need to be
executed. (This is additional to the close and unfollow APIs).
2021-01-21 09:08:27 +01:00
James Rodewig a55fc8fdc8
[DOCS] Add security privileges to data stream API docs (#67612) 2021-01-20 09:23:58 -05:00
James Rodewig fa1047f037
[DOCS] Fix title casing (#67529) 2021-01-14 13:01:40 -05:00
James Rodewig 518d71d1e3
[DOCS] Document hidden data streams and naming restrictions (#65862) 2021-01-13 09:09:15 -05:00
James Rodewig 86814df052
[DOCS] Clean up index template xrefs (#67264) 2021-01-11 12:38:09 -05:00
Yulia Čech 963c3284b3
[DOCS] Update data streams list screenshots and description of "delete data stream" (#67145)
* [DOCS] Updated data streams list screenshots and delete functionality description

* Update docs/reference/data-streams/set-up-a-data-stream.asciidoc

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>

* Update set-up-a-data-stream.asciidoc

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-01-07 16:45:26 +01:00
James Rodewig da0188fb45
[DOCS] Fix Fleet links (#66553) (#66557) 2020-12-17 15:27:15 -05:00
Dan Hermann 83a5256dc2
Include date in data stream backing index names (#65205) 2020-12-14 16:46:54 -06:00
James Rodewig 866599a77b
[DOCS] Add index alias conversion to data stream setup docs (#65979) 2020-12-08 13:28:35 -05:00
Martijn van Groningen 52afaf2060
Protect replicated data streams against local rollovers (#64710)
When a data stream is being auto followed then a rollover in a local cluster can break auto following,
if the local cluster performs a rollover then it creates a new write index and if then later the remote
cluster rolls over as well then that new write index can't be replicated, because it has the same name
as in the write index in the local cluster, which was created earlier.

If a data stream is managed by ccr, then the local cluster should not do a rollover for those data streams.
The data stream should be rolled over in the remote cluster and that change should replicate to the local
cluster. Performing a rollover in the local cluster is an operation that the data stream support in ccr should
perform.

To protect against rolling over a replicated data stream, this PR adds a replicate field to DataStream class.
The rollover api will fail with an error in case a data stream is being rolled over and the targeted data stream is
a replicated data stream. When the put follow api creates a data stream in the local cluster then the replicate flag
is set to true. There should be a way to turn a replicated data stream into a regular data stream when for example
during disaster recovery. The newly added api in this pr (promote data stream api) is doing that. After a replicated
data stream is promoted to a regular data stream then the local data stream can be rolled over, so that the new
write index is no longer a follower index. Also if the put follow api is attempting to update this data stream
(for example to attempt to resume auto following) then that with fail, because the data stream is no longer a
replicated data stream.

Today with time based indices behind an alias, the is_write_index property isn't replicated from remote cluster
to the local cluster, so when attempting to rollover the alias in the local cluster the rollover fails, because the
alias doesn't have a write index. The added replicated field in the DataStream class and added validation
achieve the same kind of protection, but in a more robust way.

A followup from #61993.
2020-12-08 08:34:24 +01:00
James Rodewig 3a2065b4ce
[DOCS] Make data stream names consistent (#65920) 2020-12-07 08:51:07 -05:00
DeDe Morton fb53dc3167
Fix links to Fleet overview (#65174) 2020-11-18 10:26:04 -08:00
Dan Hermann 0a2891e1e2
[DOCS] Data stream migration API (#65017) 2020-11-16 07:50:51 -06:00
Przemko Robakowski 0e81fc641a
Hidden data streams (#63987)
* Hidden data streams

* whitespace reverted

* stricter ds name

* Revert "stricter ds name"

This reverts commit 100dba5f3c.

* String.format removed

* fix test

* fix GetDataStream action

* fix test

* fix test

* rest test

* rest test

* spotless

* tests

* Delete a.json

* added expand_wildcards for GetDataStream and DeleteDataStream

* unused imports

* add hidden setting to data stream template

* fix expand_wildcards

* spotless

* fix compilation

* unused import

* yaml test

* fix test

* fix cleanup

* review

* compilation fix

* fix javadoc

* fix javadoc
2020-10-30 11:41:58 +01:00
James Rodewig 97bdb9ba75 [DOCS] Minor data stream docs fixes 2020-10-24 19:49:30 -04:00
James Rodewig 6a16bfd9b3
[DOCS] Remove unneeded link 2020-10-24 17:08:30 -04:00
James Rodewig ea3107827f
[DOCS] Tighten data streams copy (#64085) 2020-10-24 14:24:01 -04:00
Lee Hinman d21ddb57a3
Add "synthetics-*-*" templates for synthetics fleet data (#62193)
* Add "synthetics-*-*" templates for synthetics fleet data

For the Elastic Agent we currently have `logs` and `metrics`, however, synthetic data doesn't belong
with those and thus we should have a place for it to live. This would be data reported from
heartbeat and under the 'monitoring' category.

This commit adds a composable index template for `synthetics-*-*` indices similar to the work in
 #56709 and #57629.

Resolves #61665
2020-09-14 16:37:21 -06:00
James Rodewig a405002b39
[DOCS] Update admon for built-in templates (#61549) (#61559) 2020-08-26 08:10:49 -04:00
James Rodewig c688cb6bfd
[DOCS] Fix hyphenation for "time series" (#61472) 2020-08-24 10:34:41 -04:00
James Rodewig cd6304ae6b
[DOCS] Add admon for built-in index templates (#61063)
Adds an important admonition for the built-in `metrics-*-*` and `logs-*-*` index
templates.

Updates several put index template snippets to include a priority.
2020-08-17 11:37:08 -04:00
James Rodewig ff14fb9b6f
[DOCS] Change wildcard to index pattern in DS docs (#61058) 2020-08-12 14:55:56 -04:00
James Rodewig ebfeb471cd
[DOCS] Update example data stream names (#60783)
Uses `my-data-stream` in place of `logs` for data stream examples.
This provides a more intuitive experience for users that copy/paste
their own values into snippets.
2020-08-06 08:37:44 -04:00
James Rodewig 44c799f29c [DOCS] Unhide EQL search in data streams docs 2020-08-03 11:58:53 -04:00
James Rodewig 4c69f3dd97
[DOCS] Add Kibana screenshots to data stream docs (#60118) 2020-07-27 10:19:00 -04:00
James Rodewig 4a45c2dafb
[DOCS] Fix data stream docs (#59818) 2020-07-21 15:42:06 -04:00
James Rodewig cb6d1c00f0
[DOCS] Document data stream stats API (#59435) 2020-07-20 09:33:01 -04:00
James Rodewig d27c286e9b
[DOCS] Add `write_index_only` param to ds mapping tutorials (#59618) 2020-07-15 12:20:57 -04:00
James Rodewig e22088d504
[DOCS] Update ds overview for optional `@timestamp` mapping (#59558) 2020-07-15 09:12:34 -04:00
James Rodewig 5f01ffddec
[DOCS] Add example of ds index template with date_nanos mapping (#59535) 2020-07-14 16:39:29 -04:00
James Rodewig 0f145ace6f
[DOCS] Simplify index template snippets for data streams (#59533)
Removes the `@timestamp` field mapping from several data stream index
template snippets.

With #59317, the `@timestamp` field defaults to a `date` field data type
for data streams.
2020-07-14 12:08:54 -04:00
Andrei Dan 04b46bff8b
Fix sentence in data stream docs (#59518) 2020-07-14 14:00:00 +01:00
Andrei Dan 5609353c5d
Default to @timestamp in composable template datastream definition (#59317)
This makes the data_stream timestamp field specification optional when
defining a composable template.
When there isn't one specified it will default to `@timestamp`.
2020-07-14 11:45:48 +01:00
Andrei Dan 4e72f43d62
Composable templates: add a default mapping for @timestamp (#59244)
This adds a low precendece mapping for the `@timestamp` field with
type `date`.
This will aid with the bootstrapping of data streams as a timestamp
mapping can be omitted when nanos precision is not needed.
2020-07-14 09:19:00 +01:00
James Rodewig 82740f65e4
[DOCS] Add ingest pipeline ex to data stream docs (#58343) 2020-07-13 08:32:19 -04:00
James Rodewig b174655457
[DOCS] Add x-pack tag to data stream docs (#59241) 2020-07-09 08:45:13 -04:00
James Rodewig 30be215a82
[DOCS] Document `@timestamp` as only valid DS timestamp field (#59225) 2020-07-08 14:02:36 -04:00
James Rodewig 512649c990
[DOCS] Add data streams to security docs (#59084) 2020-07-08 11:54:55 -04:00
James Rodewig 7bd93de06f
[DOCS] Update get data stream API response (#59197) (#59230)
Updates docs and snippets for changes made to the get data stream API with
PR #59128.
2020-07-08 11:02:30 -04:00
James Rodewig 678f9e3413
Revert "[DOCS] Update get data stream API response (#59197)" (#59227)
This reverts commit db3852898f.
2020-07-08 09:39:16 -04:00
James Rodewig db3852898f
[DOCS] Update get data stream API response (#59197)
Updates docs and snippets for changes made to the get data stream API with
PR #59128.
2020-07-08 08:40:49 -04:00
James Rodewig 2be9db01c8
[DOCS] Replace `datatype` with `data type` (#58972) 2020-07-07 13:52:10 -04:00
James Rodewig 89cdbbeb7d
[DOCS] Update data stream mapping and setting docs (#58874) 2020-07-06 08:36:29 -04:00
James Rodewig 50e9a0e992
[DOCS] Clean up `Use a data stream` test snippets (#58968) 2020-07-02 17:15:27 -04:00
James Rodewig 66bcc556ee [DOCS] Reword admon for index API and data streams 2020-06-30 09:52:03 -04:00
James Rodewig 55e2ec6248
[DOCS] Document delete/update by query for data streams (#58679) 2020-06-29 16:31:37 -04:00
James Rodewig 926e9aff52
[DOCS] Document open requests for data streams (#58615)
Adds an open API example to the data streams docs. Also updates the
existing open API docs to make them aware of data streams.
2020-06-26 16:28:26 -04:00
James Rodewig 9f86ce6c0e
[DOCS] Remove `composable index template` refs (#58567)
Replaces `composable index template` and `composable template` with
`index template` throughout data stream-related docs.

`Composable index template` is only used to contrast with legacy index
templates.
2020-06-26 11:12:36 -04:00
James Rodewig e33a0dfe77
[DOCS] Note that DS timestamp field mapping changes require reindex (#58444)
With #58096, data streams now track the timestamp field mapping outside
of the template associated with the stream. This means you can no longer
update the timestamp field mapping using template changes.

This updates the associated data stream docs.
2020-06-24 17:00:09 -04:00
James Rodewig 433ab42b1d [DOCS] Reword tip in data streams overview 2020-06-23 08:56:41 -04:00
James Rodewig e83b6fd6c0
[DOCS] Prohibit deletion of composable template in use by data stream (#58347)
Notes that you cannot delete a composable template currently in use
by a data stream. Relates to #57957.
2020-06-23 08:45:11 -04:00
James Rodewig 865b7ac920
[DOCS] Reformat data stream API docs (#58322) 2020-06-18 10:46:01 -04:00
James Rodewig f00c8abe20
[DOCS] Add data streams to search docs (#58278)
Changes:

* Adds additional examples to the `Search a data stream` section of
  `Use a data stream`
* Updates existing search docs to make them aware of data streams
2020-06-18 08:43:02 -04:00
James Rodewig e738d38992 [DOCS] Remove redundant links in data stream docs 2020-06-17 17:06:28 -04:00
James Rodewig 20a7d73333
[DOCS] Add 'update/delete docs in a data stream' tutorial (#58194)
Adds a tutorial for updating and deleting documents in the backing
indices of a data stream.
2020-06-17 11:07:52 -04:00
James Rodewig 3bf1b86688
[DOCS] Add resolve index API check to DS setup tutorial (#58167)
Updates the set up a data stream tutorial to include a name check
using the resolve index API.
2020-06-16 16:15:02 -04:00
James Rodewig 0fc2bd8e62
[DOCS] Add 'Change DS mappings and settings' tutorial (#58148)
Adds a tutorial for updating the mappings and
index settings of a data stream's backing indices.
2020-06-16 16:04:38 -04:00
James Rodewig cdfb528c33 [DOCS] Fix typo in data stream docs 2020-06-15 12:59:18 -04:00
James Rodewig dbf101ad74 [DOCS] Fix xref in data stream docs 2020-06-15 09:48:58 -04:00
James Rodewig e9279d6299 [DOCS] Update prohibited ops for ds write index
Adds 'clone' and 'split' to a list of actions that are prohibited on a data
stream's write index
2020-06-15 08:54:11 -04:00
James Rodewig 9aa87fe2d7
[DOCS] Add get and delete steps to data stream setup tutorial (#58068)
Adds corresponding steps for the get and delete data stream APIs to the
data stream setup tutorial. Also provides some guidance on how to
determine the current write index for a data stream.
2020-06-15 08:38:08 -04:00