Skip to content

Commit 21b1842

Browse files
[Security] Add guide for configuring DNS histogram on Network page (#2757)
Contributes to elastic/security-docs#5584.
1 parent e0d6769 commit 21b1842

File tree

3 files changed

+50
-1
lines changed

3 files changed

+50
-1
lines changed
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
applies_to:
3+
stack: ga
4+
serverless:
5+
security: ga
6+
products:
7+
- id: security
8+
- id: cloud-serverless
9+
---
10+
11+
# Configure the DNS histogram
12+
13+
The DNS histogram (**Top domains by dns.question.registered_domain**) on the **Network** page helps you visualize domain activity in your environment. If you're using {{elastic-defend}}, you may need to add the `dns.question.registered_domain` field so that DNS data appears correctly.
14+
15+
If the DNS histogram is empty, follow these steps to populate the data.
16+
17+
## Add the `dns.question.name` field
18+
19+
Add the `dns.question.name` field to the Events table to confirm that DNS data is available.
20+
21+
1. Go to the **Network** page using the navigation menu or the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
22+
2. Select the **Events** tab.
23+
3. In the Events table, click **Fields**, then add the `dns.question.name` field.
24+
25+
## Create a custom ingest pipeline
26+
27+
Create an ingest pipeline that extracts registered domains (for example, `example.com`) from full DNS query names (for example, `www.example.com`).
28+
29+
1. Go to the **Ingest Pipelines** page using the navigation menu or the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md), and select **Create pipeline → New pipeline**.
30+
2. On the **Create pipeline** page, set the pipeline name to `logs-endpoint.events.network@custom`.
31+
3. Click **Add a processor**. In the **Add processor** flyout, configure the following:
32+
1. From the **Processor** dropdown, select **Registered domain**.
33+
2. Under **Field**, enter `dns.question.name`.
34+
3. Under **Target field (optional)**, enter `dns.question.registered_domain`.
35+
4. Turn **Ignore missing** on.
36+
5. Under **Condition (optional)**, enter `ctx?.dns?.question?.name != null`.
37+
6. Turn **Ignore failures for this processor** on.
38+
7. Select **Add processor**.
39+
4. Select **Create pipeline**. This custom pipeline is automatically picked up by the existing `logs-endpoint.events.network-<version>` pipeline.
40+
41+
## Add the `dns.question.registered_domain` field
42+
43+
Add the `dns.question.registered_domain` field to the Events table to verify that the ingest pipeline processes DNS queries correctly.
44+
45+
1. Go back to the Events table on the **Network** page.
46+
2. Click **Fields**, then add the `dns.question.registered_domain` field.
47+
48+
After you configure the DNS histogram, it will show domain activity grouped by registered domain, allowing you to identify the top domains queried in your environment.

solutions/security/explore/network-page.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ There are also tabs for viewing and investigating specific types of data:
5959

6060
* **Events**: All network events. To display alerts received from external monitoring tools, scroll down to the events table and select **Show only external alerts** on the right.
6161
* **Flows**: Source and destination IP addresses and countries.
62-
* **DNS**: DNS network queries.
62+
* **DNS**: DNS network queries. To view this data, you may need to [](/solutions/security/explore/configure-dns-histogram.md).
6363
* **HTTP**: Received HTTP requests (HTTP requests for applications using [Elastic APM](/solutions/observability/apm/index.md) are monitored by default).
6464
* **TLS**: Handshake details.
6565
* **Anomalies**: Anomalies discovered by [machine learning jobs](/solutions/security/advanced-entity-analytics/anomaly-detection.md).

solutions/toc.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -677,6 +677,7 @@ toc:
677677
- file: security/explore/network-page.md
678678
children:
679679
- file: security/explore/configure-network-map-data.md
680+
- file: security/explore/configure-dns-histogram.md
680681
- file: security/explore/users-page.md
681682
- file: security/advanced-entity-analytics.md
682683
children:

0 commit comments

Comments
 (0)