Skip to content

Commit 9b7dc90

Browse files
committed
fixed index cards
1 parent b3fb617 commit 9b7dc90

File tree

4 files changed

+28
-14
lines changed

4 files changed

+28
-14
lines changed

docs/search/behavior-insights/index.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: Behavior Insights
44
description: Gain behavioral insight of your environment using LogReduce operators.
55
---
66

7+
import useBaseUrl from '@docusaurus/useBaseUrl';
8+
79
Behavior Insights encompasses three log search operators to accelerate insights, troubleshooting, and action plans using structured logs. About 23% of the daily log ingest volume pertains to JSON data and accounts for a growing share of total log volume. This growth is driven by modern applications and underlying cloud (AWS, GCP, Azure) and orchestrator logs. Behavior Insights helps answer the following questions for SecOps, DevOps, and business users:
810

911
* What activity patterns are evident from structured logs? What patterns are trending?
@@ -17,20 +19,20 @@ In this section, we'll introduce the following concepts:
1719
<div className="box-wrapper" >
1820
<div className="box smallbox card">
1921
<div className="container">
20-
<a href="/docs/search/behavior-insights/logexplain"><h4>LogExplain</h4></a>
21-
<p>This operator finds the root cause of outliers in logs based on conditions you specify.</p>
22+
<a href="/docs/search/behavior-insights/logcompare"><img src={useBaseUrl('img/icons/operations/queries.png')} alt="icon" width="35"/><h4>LogCompare</h4></a>
23+
<p>Compare log data from different time periods to detect major changes or anomalies.</p>
2224
</div>
2325
</div>
2426
<div className="box smallbox card">
2527
<div className="container">
26-
<a href="/docs/search/behavior-insights/logexplain"><h4>LogReduce Keys</h4></a>
27-
<p>Clusters JSON logs based on keys providing an at-a-glance summary of patterns in logs based on their schema while ignoring specific values.</p>
28+
<a href="/docs/search/behavior-insights/logreduce"><img src={useBaseUrl('img/icons/operations/queries.png')} alt="icon" width="35"/><h4>LogReduce</h4></a>
29+
<p>Assess activity patterns for things like a range of devices or traffic on a website.</p>
2830
</div>
2931
</div>
3032
<div className="box smallbox card">
3133
<div className="container">
32-
<a href="/docs/search/behavior-insights/logreduce/logreduce-values"><h4>LogReduce Values</h4></a>
33-
<p>Clusters JSON logs using the values of keys.</p>
34+
<a href="/docs/search/behavior-insights/logexplain"><img src={useBaseUrl('img/icons/operations/queries.png')} alt="icon" width="35"/><h4>LogExplain</h4></a>
35+
<p>Find the root cause of outliers in logs based on conditions you specify.</p>
3436
</div>
3537
</div>
3638
</div>

docs/search/behavior-insights/logexplain.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ With the provided results you can:
5454
* Field values must be categorical.
5555
* [Built-in metadata fields](/docs/search/get-started-with-search/search-basics/built-in-metadata) are not supported.
5656
* Not supported with [Real Time alerts](../../alerts/scheduled-searches/create-real-time-alert.md).
57-
* [Time Compare](/docs/search/time-compare) and the [compare operator](/docs/search/search-query-language/search-operators/compare) are not supported against LogExplain results.
57+
* [Time Compare](/docs/search/time-compare) and the [`compare` operator](/docs/search/search-query-language/search-operators/compare) are not supported against LogExplain results.
5858
* Response fields `_explanation`, `_relevance`, `_test_coverage`,  and `_control_coverage` are not supported with [Dashboard filters](/docs/dashboards/filter-template-variables).
5959
* If you reach the memory limit you can try to shorten the time range or the number of specified fields. When the memory limit is reached you will get partial results on a subset of your data.
6060

@@ -132,11 +132,11 @@ Results show the relevance of each explanation:
132132

133133
As a SecOps user, I want to detect compromised user credentials for Windows machines. 
134134

135-
SecOps Insight: A hacked credential will display a remote login pattern (eventdata_logontype = 10) where a given user logs into more machines than they usually do, based on eventid = 4624 (login successful). I want to baseline 14 days of remote access activity and detect outliers in the most recent 24 hours.
135+
SecOps Insight: A hacked credential will display a remote login pattern (`eventdata_logontype=10`) where a given user logs into more machines than they usually do, based on `eventid=4624` (login successful). I want to baseline 14 days of remote access activity and detect outliers in the most recent 24 hours.
136136

137137
#### Approach 1: Time Compare
138138

139-
The time compare query attempts to enumerate all machine-to-user combinations over the past 24 hours and compares the average daily logins for each pair of machine and user. As `compare` only supports up to 8 sequential slices, the data has to be sliced into 2 day intervals with 7 epochs, to create 14 days of data.
139+
The time compare query attempts to enumerate all machine-to-user combinations over the past 24 hours and compares the average daily logins for each pair of machine and user. As `compare` only supports up to 8 sequential slices, the data has to be sliced into 2-day intervals with 7 epochs, to create 14 days of data.
140140

141141
```sql
142142
_sourceCategory=OS*Windows* eventid=4624 eventdata_logontype=10
@@ -162,4 +162,4 @@ _sourceCategory=OS*Windows* eventid=4624 eventdata_logontype=10
162162

163163
In an example dataset, this requires you to examine just 4 results, versus 773 in the worst case for time compare. The machines were not reported as significant in the `logexplain` algorithm, as they appeared at relatively the same frequency in both the baseline and comparison logs. Subjectively, the 4 users identified by `logexplain` were among the 150 results in the `time compare` query, sorted by percent increase in activity, so we believe our accuracy was at least as good as `time compare` with fewer results for the user to examine.
164164

165-
One important difference for `logexplain` is that it is able to detectusers who were very active 14 days ago but are no longer or less active recently. This is important as hackers may have left the network by the time Sec Ops chooses to run any of these queries. Time compare on the other hand, if sorted based on percent increase of activity, will force the user to examine all 773 user-machine combinations to get the full picture.
165+
One important difference for `logexplain` is that it is able to detect users who were very active 14 days ago but are no longer or less active recently. This is important as hackers may have left the network by the time SecOps chooses to run any of these queries. Time compare on the other hand, if sorted based on percent increase of activity, will force the user to examine all 773 user-machine combinations to get the full picture.

docs/search/behavior-insights/logreduce/index.md

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,14 +38,20 @@ In this section, we'll introduce the following concepts:
3838
</div>
3939
<div className="box smallbox card">
4040
<div className="container">
41-
<a href="/docs/search/behavior-insights/logreduce/detect-patterns-with-logreduce/"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="35"/><h4>Detect Patterns with LogReduce</h4></a>
41+
<a href="/docs/search/behavior-insights/logreduce/detect-patterns-with-logreduce"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="35"/><h4>Detect Patterns with LogReduce</h4></a>
4242
<p>Group messages with similar structures and patterns, providing insight into specific keywords or time range.</p>
4343
</div>
4444
</div>
4545
<div className="box smallbox card">
4646
<div className="container">
47-
<a href="/docs/search/behavior-insights/logreduce/influence-the-logreduce-outcome/"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="35"/><h4>Influence the LogReduce Outcome</h4></a>
48-
<p>Influence the algorithm by editing a signature to increase or decrease your results granularity.</p>
47+
<a href="/docs/search/behavior-insights/logreduce/logreduce-keys"><img src={useBaseUrl('img/icons/operations/queries.png')} alt="icon" width="35"/><h4>LogReduce Keys</h4></a>
48+
<p>Clusters JSON logs based on keys providing an at-a-glance summary of patterns in logs based on their schema while ignoring specific values.</p>
49+
</div>
50+
</div>
51+
<div className="box smallbox card">
52+
<div className="container">
53+
<a href="/docs/search/behavior-insights/logreduce/logreduce-values"><img src={useBaseUrl('img/icons/operations/queries.png')} alt="icon" width="35"/><h4>LogReduce Values</h4></a>
54+
<p>Clusters JSON logs using the values of keys.</p>
4955
</div>
5056
</div>
5157
<div className="box smallbox card">
@@ -54,4 +60,10 @@ In this section, we'll introduce the following concepts:
5460
<p>Displays a numerical score for a signature, predicting which signatures could be most meaningful.</p>
5561
</div>
5662
</div>
63+
<div className="box smallbox card">
64+
<div className="container">
65+
<a href="/docs/search/behavior-insights/logreduce/influence-the-logreduce-outcome"><img src={useBaseUrl('img/icons/search.png')} alt="icon" width="35"/><h4>Influence the LogReduce Outcome</h4></a>
66+
<p>Influence the algorithm by editing a signature to increase or decrease your results granularity.</p>
67+
</div>
68+
</div>
5769
</div>

docs/search/behavior-insights/logreduce/logreduce-values.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description: Group by the values of specific keys in JSON logs.
66

77

88

9-
The **LogReduce Values** operator allows you to quickly explore structured logs by known keys. Structured logs can be in JSON, CSV, key-value, or any structured format. Unlike the LogReduce Keys operator, you need to specify the keys you want to explore. The values of each specified key are parsed and aggregated for you to explore.
9+
The **LogReduce Values** operator allows you to quickly explore structured logs by known keys. Structured logs can be in JSON, CSV, key-value, or any structured format. Unlike the [LogReduce Keys operator](/docs/search/behavior-insights/logreduce/logreduce-keys), you need to specify the keys you want to explore. The values of each specified key are parsed and aggregated for you to explore.
1010

1111
This operator does not automatically [parse](/docs/search/search-query-language/parse-operators) your logs. You need to parse the keys you want to explore prior to specifying them in the LogReduce Values operation. 
1212

0 commit comments

Comments
 (0)