You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/alerts/scheduled-searches/generate-cse-signals.md
+36-38Lines changed: 36 additions & 38 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,27 +2,27 @@
2
2
id: generate-cse-signals
3
3
title: Generate Cloud SIEM Signals With a Scheduled Search
4
4
sidebar_label: Generate Cloud SIEM Signals
5
-
description: You can generate a Cloud SIEM Signal with a scheduled search.
5
+
description: You can generate a Cloud SIEM signal with a scheduled search.
6
6
---
7
7
8
8
import useBaseUrl from '@docusaurus/useBaseUrl';
9
9
10
-
This page has information about creating a scheduled search that will trigger a Cloud SIEM Signal. Before you start using Scheduled Searches to create Cloud SIEM Signals, it is helpful to understand what Signals are, and how they relate to the generation of Cloud SIEM Insights. For information about how it all works see [Insight Generation Process](/docs/cse/get-started-with-cloud-siem/insight-generation-process/).
10
+
This page has information about creating a scheduled search that will trigger a Cloud SIEM signal. Before you start using Scheduled Searches to create Cloud SIEM signals, it is helpful to understand what signals are, and how they relate to the generation of Cloud SIEM insights. For information about how it all works see [Insight Generation Process](/docs/cse/get-started-with-cloud-siem/insight-generation-process/).
11
11
12
12
:::note
13
-
For a more detailed description of the options you can configure for a scheduled search, see [Schedule a Search](schedule-search.md).
13
+
For a more detailed description of the options you can configure for a scheduled search, see [Create a Scheduled Search](/docs/alerts/scheduled-searches/schedule-search/).
14
14
:::
15
15
16
16
## Requirements for the search query
17
17
18
-
This section describes the requirements for your scheduled search, which include a minimum set of fields to be returned, and renaming message fields as necessary to match attribute names in the selected Cloud SIEM Record type schema.
18
+
This section describes the requirements for your scheduled search, which include a minimum set of fields to be returned, and renaming message fields as necessary to match attribute names in the selected Cloud SIEM record type schema.
19
19
20
20
### Required fields
21
21
22
22
There are several fields that your scheduled search must return to
23
-
enable Signal generation:
23
+
enable signal generation:
24
24
25
-
*`normalizedseverity`. This field must contain a value between (and including) 0 and 10. Signals generated by the scheduled search will have this severity value. SIgnal severity values are used by Cloud SIEM’s Insight generation algorithm, as described above.
25
+
*`normalizedseverity`. This field must contain a value between (and including) 0 and 10. Signals generated by the scheduled search will have this severity value. SIgnal severity values are used by Cloud SIEM’s insight generation algorithm, as described above.
26
26
*`stage`. This field must contain a Tactic in the MITRE ATT&CK framework, one of the following:
27
27
* Collection
28
28
* Command and Control
@@ -39,7 +39,7 @@ enable Signal generation:
39
39
* Reconnaissance
40
40
* Resource Development
41
41
:::important
42
-
If the `stage` field contains a Tactic that isn't in the MITRE ATT&CK framework, a Signal will not be generated, but a Record will be.
42
+
If the `stage` field contains a Tactic that isn't in the MITRE ATT&CK framework, a signal will not be generated, but a record will be.
43
43
:::
44
44
* At least one entity field:
45
45
@@ -60,55 +60,53 @@ enable Signal generation:
60
60
61
61
### Renaming message fields
62
62
63
-
When you configure a Scheduled Search to create Cloud SIEM Signals, you are prompted to select a [Cloud SIEM Record type](../../cse/schema/cse-record-types.md). The fields returned by your search must match an attribute in the Record
64
-
type you select. A field whose name does not match a Cloud SIEM attribute will not be populated in the Record created from the Schedule Search results. For more about Cloud SIEM attribute names, see [Attributes You Can Map to Records](../../cse/schema/attributes-map-to-records.md).
63
+
When you configure a Scheduled Search to create Cloud SIEM signals, you are prompted to select a [Cloud SIEM record type](/docs/cse/schema/cse-record-types/). The fields returned by your search must match an attribute in the record
64
+
type you select. A field whose name does not match a Cloud SIEM attribute will not be populated in the record created from the Schedule Search results. For more about Cloud SIEM attribute names, see [Attributes You Can Map to Records](/docs/cse/schema/attributes-map-to-records/).
65
65
66
66
## Scheduling the search
67
67
68
-
1. After creating and saving your search, click the save icon.<br/><img src={useBaseUrl('img/alerts/save-as.png')} alt="Save the search" width="800"/>
69
-
1. The **Save Item** popup appears.
68
+
1. After creating and saving your search, click the save icon.<br/><img src={useBaseUrl('img/alerts/save-as.png')} alt="Save the search" style={{border: '1px solid gray'}} width="800"/>
69
+
1. The **Save Item** popup appears.<br/><img src={useBaseUrl('img/alerts/save-item.png')} alt="Save as scheduled search" width="500"/>
70
70
:::note
71
71
The name of your scheduled search will appear as the signal name in Cloud SIEM.
72
72
:::
73
-
<br/><img src={useBaseUrl('img/alerts/save-item.png')} alt="Save as scheduled search" width="600"/>
74
73
1. Click **Schedule this search**.
75
-
1. The **Save Item** popup prompts you to select a run frequency.<br/>
74
+
1. The **Save Item** popup prompts you to select a run frequency.<br/><img src={useBaseUrl('img/alerts/run-freq-signal-gen.png')} alt="Run frequency" style={{border: '1px solid gray'}} width="400" />
76
75
1. Select a frequency from the pull-down list and click **Save**. Scheduling a run frequency that matches your query time range will reduce overlapping searches and duplicate alerts. When you have a search scheduled to run over the same results as a previously scheduled search you would trigger an alert on the same data.
77
-
1. The popup refreshes.<br/>
1.**Time range for scheduled search.** Indicates the time range your query will use to execute, which impacts the results generated by the query.
79
78
:::note
80
-
This setting is different than the Time Range option configured for the Saved Search. The first time range is only used when you run the Saved Search from the Library. This Time Range applies to your Scheduled Search.
79
+
This setting is different than the time range option configured for the Saved Search. The first time range is only used when you run the Saved Search from the library. This time range applies to your Scheduled Search.
81
80
:::
82
81
1.**Timezone for scheduled search**. Select the time zone you would like your scheduled search to use. The schedule's time is based on this time zone. This time zone is not related to the time zone of your data. If you do not make a selection, the scheduled search will use the time zone from your browser, which is the default selection.
83
-
1.**Send notification**. Select **If the following condition is met**, and enter an alert condition and the number of results that should trigger the alert.
84
-
1.**Alert Type**. Select **Cloud SIEM Signal**.
85
-
1. The popup refreshes.<br/>
86
-
1.**Record Type**. Select a [Record Type](../../cse/schema/cse-record-types.md).
82
+
1.**Send Notification**. Select **If the following condition is met**, and enter an alert condition and the number of results that should trigger the alert.
83
+
1.**Alert Type**. Select **CSE Signal**.
84
+
1. The popup refreshes.<br/><img src={useBaseUrl('img/alerts/alert-type-selected.png')} alt="Alert type selected" style={{border: '1px solid gray'}} width="500" />
85
+
1.**Record Type**. Select a [record type](/docs/cse/schema/cse-record-types/).
87
86
1. Click **Save**.
88
87
89
-
## View Signals in Cloud SIEM
88
+
## View signals in Cloud SIEM
90
89
91
-
To view Signals that were created from a scheduled search, run a keyword search on “CIP Scheduled Search” on the **Signals** page in the Cloud SIEM UI.
90
+
To view signals that were created from a scheduled search, run a keyword search on “Scheduled Search” on the **Signals** page in the Cloud SIEM UI:
91
+
1.[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Cloud SIEM**, and then select **Signals** in the top menu. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu, select **Cloud SIEM > Signals**. You can also click the **Go To...** menu at the top of the screen and select **Signals**.
92
+
1. Click in the **Filters** field at the top of the screen.
93
+
1. Type **Scheduled Search** and press Enter. The keyword search returns a list of all signals created by scheduled searches.
94
+
1. Click a signal from the list. Below is a screenshot of a signal that was created from a scheduled search. Note that:
95
+
***Related Insights** shows the insights the signal is included with. If the signal is not part of an insight, there’s a **Create Insight** link you can use to create an insight for the signal. For more information, see [Create an insight from signal](#create-an-insight-from-signal).
96
+
* You can click the **Full Details** link for more information about the signal. See [View signal details](#view-signal-details) below for a screenshot.
97
+
* The **Mapping** section at the bottom of the page shows that the signal was the result of a scheduled search.<br/><img src={useBaseUrl('img/alerts/ss-signal.png')} alt="Signal" style={{border: '1px solid gray'}} width="800" />
92
98
93
-
Below is a screenshot of a Signal that was created from a scheduled search. Note that:
99
+
## View signal details
94
100
95
-
* The **Mapping** section at the bottom of the page shows that the Signal was the result of a scheduled search.
96
-
* If the Signal is not part of an Insight, there’s a **Create Insight** link you can use to create an Insight for the Signal. For more information, see [Create an Insight from Signal](#create-an-insight-from-signal).
97
-
* You can click the **Full Details** link for more information about the Signal. See [View Signal details](#view-signal-details) below for a screenshot.
101
+
The **Full Details** tab displays details about the signal.
The **Full Details** tab displays details about the Signal.
107
+
To create an insight from a signal generated from a scheduled search:
104
108
105
-

106
-
107
-
## Create an Insight from Signal
108
-
109
-
To create an Insight from a Signal generated from a scheduled search:
110
-
111
-
1. Navigate to a Signal that was generated from a scheduled search.
112
-
1. Click **Create Insight**.
113
-
1. Click **Yes, Create Insight** when prompted whether you want to proceed. <br/> 
114
-
1. The new Insight is created and appears as a **Related Insight**. <br/> 
109
+
1. Navigate to a signal that was generated from a scheduled search.
110
+
1.**Related Insights** shows the insights the signal is included with. If the signal is not part of an insight, there’s a **Create Insight** link you can use to create an insight for the signal. Click **Create Insight**. <br/><img src={useBaseUrl('img/alerts/create-insight.png')} alt="Create insight link" style={{border: '1px solid gray'}} width="800" />
1. The new insight is created and appears as a **Related Insight**. <br/><img src={useBaseUrl('img/alerts/new-related-insight.png')} alt="New related insight" style={{border: '1px solid gray'}} width="800" />
0 commit comments