Skip to content

Commit 5b96863

Browse files
Runtime fields in Elastic Security page cleanup (#439)
- Adds content to the Solutions and use cases > Security > Get started > Create runtime fields in Elastic Security page. - Removes raw migrated files for Create runtime fields in Elastic Security since they're not used elsewhere. Preview: [Create runtime fields in Elastic Security](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/439/solutions/security/get-started/create-runtime-fields-in-elastic-security)
1 parent 7159e56 commit 5b96863

File tree

4 files changed

+51
-123
lines changed

4 files changed

+51
-123
lines changed

raw-migrated-files/docs-content/serverless/security-runtime-fields.md

Lines changed: 0 additions & 62 deletions
This file was deleted.

raw-migrated-files/security-docs/security/runtime-fields.md

Lines changed: 0 additions & 54 deletions
This file was deleted.

raw-migrated-files/toc.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -480,7 +480,6 @@ toc:
480480
- file: docs-content/serverless/security-rules-coverage.md
481481
- file: docs-content/serverless/security-rules-create.md
482482
- file: docs-content/serverless/security-rules-ui-management.md
483-
- file: docs-content/serverless/security-runtime-fields.md
484483
- file: docs-content/serverless/security-self-healing-rollback.md
485484
- file: docs-content/serverless/security-session-view.md
486485
- file: docs-content/serverless/security-signals-to-cases.md
@@ -844,7 +843,6 @@ toc:
844843
- file: security-docs/security/rules-coverage.md
845844
- file: security-docs/security/rules-ui-create.md
846845
- file: security-docs/security/rules-ui-management.md
847-
- file: security-docs/security/runtime-fields.md
848846
- file: security-docs/security/sec-requirements.md
849847
- file: security-docs/security/security-assistant.md
850848
- file: security-docs/security/security-posture-faq.md

solutions/security/get-started/create-runtime-fields-in-elastic-security.md

Lines changed: 51 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,57 @@ mapped_urls:
44
- https://www.elastic.co/guide/en/serverless/current/security-runtime-fields.html
55
---
66

7-
# Create runtime fields in Elastic Security
7+
# Create runtime fields in {{elastic-sec}} [runtime-fields]
88

9-
% What needs to be done: Lift-and-shift
9+
Runtime fields are fields that you can add to documents after you’ve ingested your data. For example, you could combine two fields and treat them as one, or perform calculations on existing data and use the result as a separate field. Runtime fields are evaluated when a query is run.
1010

11-
% Use migrated content from existing pages that map to this page:
11+
You can create a runtime field and add it to your detection alerts or events from any page that lists alerts or events in a data grid table, such as **Alerts**, **Timelines**, **Hosts**, and **Users**. Once created, the new field is added to the current [data view](data-views-elastic-security.md) and becomes available to all {{elastic-sec}} alerts and events in the data view.
1212

13-
% - [ ] ./raw-migrated-files/security-docs/security/runtime-fields.md
14-
% - [ ] ./raw-migrated-files/docs-content/serverless/security-runtime-fields.md
13+
::::{note}
14+
Runtime fields can impact performance because they’re evaluated each time a query runs. Refer to [Runtime fields](../../../manage-data/data-store/mapping/runtime-fields.md) for more information.
15+
::::
16+
17+
18+
To create a runtime field:
19+
20+
1. Go to a page that lists alerts or events (for example, **Alerts** or **Timelines****Name of Timeline**).
21+
2. Do one of the following:
22+
23+
* In the Alerts table, click the **Fields** toolbar button in the table’s upper-left. From the **Fields** browser, click **Create field**. The **Create field** flyout opens.
24+
25+
:::{image} ../../../images/security-fields-browser.png
26+
:alt: Fields browser
27+
:class: screenshot
28+
:::
29+
30+
* In Timeline, go to the bottom of the sidebar, then click **Add a field**. The **Create field** flyout opens.
31+
32+
:::{image} ../../../images/security-create-runtime-fields-timeline.png
33+
:alt: Create runtime fields button in Timeline
34+
:class: screenshot
35+
:::
36+
37+
3. Enter a **Name** for the new field.
38+
4. Select a **Type** for the field’s data type.
39+
5. Turn on the **Set value** toggle and enter a [Painless script](../../../explore-analyze/scripting/modules-scripting-painless.md) to define the field’s value. The script must match the selected **Type**. For more on adding fields and Painless scripting examples, refer to [Explore your data with runtime fields](../../../explore-analyze/find-and-organize/data-views.md#runtime-fields).
40+
6. Use the **Preview** to help you build the script so it returns the expected field value.
41+
7. Configure other field settings as needed.
42+
43+
::::{note}
44+
Some runtime field settings, such as custom labels and display formats, might display differently in some areas of the {{elastic-sec}} UI.
45+
::::
46+
47+
8. Click **Save**. The new field appears as a new column in the data grid.
48+
49+
50+
## Manage runtime fields [manage-runtime-fields]
51+
52+
You can edit or delete existing runtime fields from the **Alerts**, **Timelines**, **Hosts**, and **Users** pages.
53+
54+
1. Click the **Fields** button to open the **Fields** browser, then search for the runtime field you want.
55+
56+
::::{tip}
57+
Click the **Runtime** column header twice to reorder the fields table with all runtime fields at the top.
58+
::::
59+
60+
2. In the **Actions** column, select an option to edit or delete the runtime field.

0 commit comments

Comments
 (0)