Skip to content

Commit 2ef14a2

Browse files
committed
Updating Kusto links
1 parent 75e6bfa commit 2ef14a2

File tree

2 files changed

+25
-18
lines changed

2 files changed

+25
-18
lines changed

articles/sentinel/normalization-develop-parsers.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ Event | where Source == "Microsoft-Windows-Sysmon" and EventID == 1
110110
```
111111

112112
> [!IMPORTANT]
113-
> A parser should not filter by time. The query which uses the parser will apply a time range.
113+
> A parser should not filter by time. The query that uses the parser will apply a time range.
114114

115115
#### Filtering by source type using a Watchlist
116116

@@ -146,8 +146,11 @@ srcipaddr=='*' or ClientIP==srcipaddr
146146
array_length(domain_has_any) == 0 or Name has_any (domain_has_any)
147147
```
148148

149-
#### <a name="optimization"></a>Filtering optimization
149+
See more information on the following items in the Kusto documentation:
150+
- [***array_length*** function](/kusto/query/array-length-function?view=microsoft-sentinel&preserve-view=true)
151+
- [***has_any*** operator](/kusto/query/has-any-operator?view=microsoft-sentinel&preserve-view=true)
150152

153+
#### <a name="optimization"></a>Filtering optimization
151154

152155
To ensure the performance of the parser, note the following filtering recommendations:
153156

@@ -497,7 +500,7 @@ To submit the event samples, use the following steps:
497500

498501
- In the `Logs` screen, run a query that will extract from the source table only the events selected by the parser. For example, for the [Infoblox DNS parser](https://github.com/Azure/Azure-Sentinel/blob/master/Parsers/ASimDns/Parsers/ASimDnsInfobloxNIOS.yaml), use the following query:
499502

500-
``` KQL
503+
```kusto
501504
Syslog
502505
| where ProcessName == "named"
503506
```
@@ -506,7 +509,7 @@ To submit the event samples, use the following steps:
506509

507510
- In the `Logs` screen, run a query that will output the schema or the parser input table. For example, for the same Infoblox DNS parser, the query is:
508511

509-
``` KQL
512+
```kusto
510513
Syslog
511514
| getschema
512515
```

articles/sentinel/normalization-functions.md

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -19,27 +19,31 @@ Advanced Security Information Model (ASIM) helper functions extend the KQL langu
1919

2020
Enrichment lookup functions provide an easy method of looking up known values, based on their numerical representation. Such functions are useful as events often use the short form numeric code, while users prefer the textual form. Most of the functions have two forms:
2121

22-
The **lookup** version is a scalar function that accepts as input the numeric code and returns the textual form. Use the following KQL snippet with the **lookup** version:
22+
- The **lookup** version is a scalar function that accepts as input the numeric code and returns the textual form.
2323

24-
```kusto
25-
| extend ProtocolName = _ASIM_LookupNetworkProtocol (ProtocolNumber)
26-
```
24+
Use the following KQL snippet with the **lookup** version:
2725

28-
The **resolve** version is a tabular function that:
26+
```kusto
27+
| extend ProtocolName = _ASIM_LookupNetworkProtocol (ProtocolNumber)
28+
```
2929
30-
- Is used a KQL pipeline operator.
31-
- Accepts as input the name of the field holding the value to look up.
32-
- Sets the ASIM fields typically holding both the input value and the resulting lookup value.
30+
- The **resolve** version is a tabular function that:
3331
34-
Use the following KQL snippet with the **resolve** version:
32+
- Is used as a KQL pipeline operator.
33+
- Accepts as input the name of the field holding the value to look up.
34+
- Sets the ASIM fields typically holding both the input value and the resulting lookup value.
3535
36-
```kusto
37-
| invoke _ASIM_ResolveNetworkProtocol (`ProtocolNumber`)
38-
```
36+
Use the following KQL snippet with the **resolve** version:
3937
40-
Which will automatically populate the NetworkProtocol field with the result of the lookup.
38+
```kusto
39+
| invoke _ASIM_ResolveNetworkProtocol (`ProtocolNumber`)
40+
```
4141
42-
The **resolve** version is preferable for use in ASIM parsers, while the lookup version is useful in general purpose queries. When an enrichment lookup function has to return more than one value, it will always use the **resolve** format.
42+
The function automatically populates the ASIM field with the result of the lookup.
43+
44+
The **resolve** version is preferable for use in ASIM parsers, while the **lookup** version is useful in general purpose queries. When an enrichment lookup function has to return more than one value, it will always use the **resolve** format.
45+
46+
For more information on scalar and tabular functions (represented by the lookup and resolve versions here, respectively), see [User-defined functions](/kusto/query/functions/user-defined-functions?view=microsoft-sentinel&preserve-view=true) in the Kusto documentation.
4347
4448
### Lookup type functions
4549

0 commit comments

Comments
 (0)