honeymoose
/
OpenSearch
mirror of https://github.com/honeymoose/OpenSearch.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
OpenSearch/docs/reference/eql/requirements.asciidoc

44 lines
1.2 KiB
Plaintext
Raw Normal View History

[DOCS] Add top-level EQL docs page. Adds EQL requirements page. (#51334) * Creates a top-level page for EQL in the ES reference. This page contains a high-level introduction and will include a nav for other EQL docs pages as they're built. * Creates a requirements page. This page outlines the fields needed to use EQL in ES.
2020-01-27 16:03:23 -05:00
[role="xpack"]
[testenv="basic"]
[[eql-requirements]]
== EQL requirements
++++
<titleabbrev>Requirements</titleabbrev>
++++
[DOCS] EQL: Prepare docs for release (#59259) (#59407) Changes: * Swaps the `dev` admonitions for `experimental` admonitions * Removes `ifdef` statements preventing the docs from appearing in released branches
2020-07-13 09:04:15 -04:00
experimental::[]
[DOCS] Add basic EQL search tutorial docs (#51574) I plan to add additional sections to this page with future PRs: * Specify timestamp and event type fields * Specify a join key field * Filter using query DSL * Paginate a large response See #51057.
2020-02-12 08:40:10 -05:00
[DOCS] Reorganize EQL requirements page
2020-03-03 06:59:17 -05:00
EQL is schema-less and works well with most common log formats.
[TIP]
====
While no schema is required to use EQL in {es}, we recommend the
[DOCS] Fix syntax and wording in EQL docs (#59623) (#59650)
2020-07-15 14:45:56 -04:00
{ecs-ref}[Elastic Common Schema (ECS)]. The <<eql-search-api,EQL search API>> is
designed to work with core ECS fields by default.
[DOCS] Reorganize EQL requirements page
2020-03-03 06:59:17 -05:00
====
[DOCS] Add top-level EQL docs page. Adds EQL requirements page. (#51334) * Creates a top-level page for EQL in the ES reference. This page contains a high-level introduction and will include a nav for other EQL docs pages as they're built. * Creates a requirements page. This page outlines the fields needed to use EQL in ES.
2020-01-27 16:03:23 -05:00
[discrete]
[[eql-required-fields]]
=== Required fields
[DOCS] Add data streams to EQL search docs (#58611) (#59404)
2020-07-13 09:03:55 -04:00
In {es}, EQL assumes each document in a data stream or index corresponds to an
event.
[DOCS] Add top-level EQL docs page. Adds EQL requirements page. (#51334) * Creates a top-level page for EQL in the ES reference. This page contains a high-level introduction and will include a nav for other EQL docs pages as they're built. * Creates a requirements page. This page outlines the fields needed to use EQL in ES.
2020-01-27 16:03:23 -05:00
[DOCS] Add data streams to EQL search docs (#58611) (#59404)
2020-07-13 09:03:55 -04:00
To search a data stream or index using EQL, each document in the data stream or
index must contain the following field archetypes:
[DOCS] Add top-level EQL docs page. Adds EQL requirements page. (#51334) * Creates a top-level page for EQL in the ES reference. This page contains a high-level introduction and will include a nav for other EQL docs pages as they're built. * Creates a requirements page. This page outlines the fields needed to use EQL in ES.
2020-01-27 16:03:23 -05:00
[DOCS] Update EQL default event category and timestamp values (#53102) Updates the documented default `event_category_field` and `timestamp_field` values for the EQL search API. Also updates related guidance in the EQL requirement docs. Relates to #53073.
2020-03-04 09:16:27 -05:00
Event category::
[DOCS] Add top-level EQL docs page. Adds EQL requirements page. (#51334) * Creates a top-level page for EQL in the ES reference. This page contains a high-level introduction and will include a nav for other EQL docs pages as they're built. * Creates a requirements page. This page outlines the fields needed to use EQL in ES.
2020-01-27 16:03:23 -05:00
A field containing the event classification, such as `process`, `file`, or
`network`. This is typically mapped as a <<keyword,`keyword`>> field.
Timestamp::
A field containing the date and/or time the event occurred. This is typically
[DOCS] Note that EQL timestamp field can also be date_nanos
2020-07-15 09:53:19 -04:00
mapped as a <<date,`date`>> or <<date_nanos,`date_nanos`>> field.
[DOCS] EQL: Document nested field support (#56138) Notes that you cannot use EQL in ES to search the values of `nested` fields or their sub-fields. However, indices containing `nested` field mappings are otherwise supported.
2020-05-05 11:46:06 -04:00
[NOTE]
====
[DOCS] Replace `datatype` with `data type` (#58972) (#59184)
2020-07-07 14:59:35 -04:00
You cannot use a <<nested,`nested`>> field data type or the sub-fields of a
[DOCS] Fix syntax and wording in EQL docs (#59623) (#59650)
2020-07-15 14:45:56 -04:00
`nested` field as the timestamp or event category field. See
[DOCS] EQL: Document nested field support (#56138) Notes that you cannot use EQL in ES to search the values of `nested` fields or their sub-fields. However, indices containing `nested` field mappings are otherwise supported.
2020-05-05 11:46:06 -04:00
<<eql-nested-fields>>.
====