Skip to content

Commit

Permalink
(Doc+) Alerts UI cannot be CCS [serverless] + bonus fixes (#5582)
Browse files Browse the repository at this point in the history
* Add admonition to serverless

Serverless follow up to #5513

* Update serverless to match ESS

Serverless follow up to #4695

* Fix URL variable/attribute

Should use `kibana-ref` instead of apm-app-ref since this has nothing to do with APM

* No-op change to trigger build

(i hope)

(cherry picked from commit 9e7d734)

# Conflicts:
#	docs/serverless/explore/data-views-in-sec.mdx
  • Loading branch information
joepeeples authored and mergify[bot] committed Jul 19, 2024
1 parent 2c9418f commit bad8b24
Show file tree
Hide file tree
Showing 2 changed files with 54 additions and 4 deletions.
7 changes: 3 additions & 4 deletions docs/getting-started/data-views-in-sec.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,7 @@ IMPORTANT: Custom indices are not included in the <<default-data-view-security,
[discrete]
== Switch to another {data-source}

You can tell which {data-source} is active by clicking the *{data-source-cap}* menu at the upper right of {elastic-sec} pages that display event or alert data, such as Overview, Alerts, Timelines, or Hosts.
To switch to another {data-source}, click **Choose {data-source}**, select one of the options, and click **Save**.
You can tell which {data-source} is active by clicking the *{data-source-cap}* menu at the upper right of {elastic-sec} pages that display event or alert data, such as Overview, Alerts, Timelines, or Hosts. To switch to another {data-source}, click **Choose {data-source}**, select one of the options, and click **Save**.

image::images/dataview-button-highlighted.png[image highlighting how to open the data view selection menu]

Expand All @@ -20,7 +19,7 @@ image::images/dataview-button-highlighted.png[image highlighting how to open the

To learn how to modify the default **Security Default Data View**, refer to <<update-sec-indices, Update default {elastic-sec} indices>>.

To learn how to modify, create, or delete another {data-source} refer to {apm-app-ref}/data-views.html[{kib} {data-sources-cap}].
To learn how to modify, create, or delete another {data-source} refer to {kibana-ref}/data-views.html[{kib} {data-sources-cap}].

You can also temporarily modify the active {data-source} from the *{data-source-cap}* menu by clicking *Advanced options*, then adding or removing index patterns.

Expand All @@ -36,6 +35,6 @@ NOTE: You cannot update the data view for the Alerts page. This includes referen

The default {data-source} is defined by the `securitySolution:defaultIndex` setting, which you can modify in {kib}'s advanced settings (**Stack Management** > **Advanced Settings** > **Security Solution**). To learn more about this setting, including its default value, refer to {security-guide}/advanced-settings.html#update-sec-indices[Advanced settings].

The first time a user visits {elastic-sec} within a given {kib} {apm-app-ref}/xpack-spaces.html[space], the default {data-source} generates in that space and becomes active.
The first time a user visits {elastic-sec} within a given {kib} {kibana-ref}/xpack-spaces.html[space], the default {data-source} generates in that space and becomes active.

If you delete the active {data-source} when there are no other defined {data-sources}, the default {data-source} will regenerate and become active upon refreshing any {elastic-sec} page in the space.
51 changes: 51 additions & 0 deletions docs/serverless/explore/data-views-in-sec.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
slug: /serverless/security/data-views-in-sec
title: ((data-sources-cap)) in Elastic Security
description: Use data views to control what data displays on ((elastic-sec)) pages with event or alert data.
tags: [ 'serverless', 'security', 'reference', 'manage' ]
status: in review
---

<DocBadge template="technical preview" />
<div id="data-views-in-sec"></div>

((data-sources-cap)) determine what data displays on ((elastic-sec)) pages with event or alert data.
((data-sources-cap)) are defined by the index patterns they include.
Only data from ((es)) [indices](((ref))/documents-indices.html), [data streams](((ref))/data-streams.html), or [index aliases](((ref))/alias.html) specified in the active ((data-source)) will appear.

<DocCallOut title="Important" color="warning">
Custom indices are not included in the <DocLink slug="/serverless/security/data-views-in-sec" section="the-default-((data-source))">default ((data-source))</DocLink>. Modify it or create a custom ((data-source)) to include custom indices.
</DocCallOut>

## Switch to another ((data-source))

You can tell which ((data-source)) is active by clicking the **((data-source-cap))** menu at the upper right of ((elastic-sec)) pages that display event or alert data, such as Overview, Alerts, Timelines, or Hosts.
To switch to another ((data-source)), click **Choose ((data-source))**, select one of the options, and click **Save**.

![image highlighting how to open the data view selection menu](../images/data-views-in-sec/-getting-started-dataview-button-highlighted.png)

## Create or modify a ((data-source))

To learn how to modify the default **Security Default Data View**, refer to <DocLink slug="/serverless/security/advanced-settings" section="update-sec-indices" />.

To learn how to modify, create, or delete another ((data-source)) refer to [((data-sources-cap))](((kibana-ref))/data-views.html).

You can also temporarily modify the active ((data-source)) from the **((data-source-cap))** menu by clicking **Advanced options**, then adding or removing index patterns.

![video showing how to filter the active data view](../images/data-views-in-sec/-getting-started-dataview-filter-example.gif)

This only allows you to add index patterns that match indices that currently contain data (other index patterns are unavailable). Note that any changes made are saved in the current browser window and won't persist if you open a new tab.

<DocCallOut title="Note">
You cannot update the data view for the Alerts page. This includes referencing a cross-cluster search (CCS) data view or any other data view. The Alerts page always shows data from `.alerts-security.alerts-default`.
</DocCallOut>

<div id="default-data-view-security"></div>

## The default ((data-source))

The default ((data-source)) is defined by the `securitySolution:defaultIndex` setting, which you can modify in your project's advanced settings{/* path to be updated: (**Stack Management** → **Advanced Settings** → **Security Solution**) */}. To learn more about this setting, including its default value, refer to <DocLink slug="/serverless/security/advanced-settings" />).

The first time a user visits ((elastic-sec)){/* within a given ((kib)) [space](((kibana-ref))/xpack-spaces.html)*/}, the default ((data-source)) generates{/* in that space*/} and becomes active.

If you delete the active ((data-source)) when there are no other defined ((data-sources)), the default ((data-source)) will regenerate and become active upon refreshing any ((elastic-sec)) page{/* in the space*/}.

0 comments on commit bad8b24

Please sign in to comment.