Skip to content

Commit 29a0d92

Browse files
committed
undoing pktdrop additions
1 parent 8012330 commit 29a0d92

File tree

3 files changed

+71
-0
lines changed

3 files changed

+71
-0
lines changed
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
// Module included in the following assemblies:
2+
//
3+
// network_observability/observing-network-traffic.adoc
4+
5+
:_content-type: CONCEPT
6+
[id="network-observability-dns-overview_{context}"]
7+
= DNS tracking
8+
You can configure graphical representation of Domain Name System (DNS) tracking of network flows in the *Overview* view. Using DNS tracking with extended Berkeley Packet Filter (eBPF) tracepoint hooks can serve various purposes:
9+
10+
* Network Monitoring: Gain insights into DNS queries and responses, helping network administrators identify unusual patterns, potential bottlenecks, or performance issues.
11+
12+
* Security Analysis: Detect suspicious DNS activities, such as domain name generation algorithms (DGA) used by malware, or identify unauthorized DNS resolutions that might indicate a security breach.
13+
14+
* Troubleshooting: Debug DNS-related issues by tracing DNS resolution steps, tracking latency, and identifying misconfigurations.
15+
16+
When DNS tracking is enabled, you can see the following metrics represented in a chart in the *Overview*. See the _Additional Resources_ in this section for more information about enabling and working with this view.
17+
18+
* Top 5 average DNS latencies
19+
* Top 5 DNS response code
20+
* Top 5 DNS response code stacked with total
21+
22+
This feature is supported for IPv4 and IPv6 UDP protocol.
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
// Module included in the following assemblies:
2+
//
3+
// network_observability/observing-network-traffic.adoc
4+
5+
:_content-type: PROCEDURE
6+
[id="network-observability-dns-tracking_{context}"]
7+
= Working with DNS tracking
8+
Using DNS tracking, you can monitor your network, conduct security analysis, and troubleshoot DNS issues. You can track DNS by editing the `FlowCollector` to the specifications in the following YAML example.
9+
+
10+
[IMPORTANT]
11+
====
12+
CPU and memory usage increases are observed in the eBPF agent when this feature is enabled.
13+
====
14+
.Procedure
15+
. In the web console, navigate to *Operators* -> *Installed Operators*.
16+
. Under the *Provided APIs* heading for the *NetObserv Operator*, select *Flow Collector*.
17+
. Select *cluster* then select the *YAML* tab.
18+
. Configure the `FlowCollector` custom resource. A sample configuration is as follows:
19+
+
20+
[id="network-observability-flowcollector-configuring-dns_{context}"]
21+
.Configure `FlowCollector` for DNS tracking
22+
[source, yaml]
23+
----
24+
apiVersion: flows.netobserv.io/v1alpha1
25+
kind: FlowCollector
26+
metadata:
27+
name: cluster
28+
namespace: netobserv
29+
deploymentModel: DIRECT
30+
agent:
31+
type: EBPF
32+
ebpf:
33+
features:
34+
- DNSTracking <1>
35+
privileged: true <2>
36+
----
37+
<1> You can set the `spec.agent.ebpf.features` parameter list to enable DNS tracking of each network flow in the web console.
38+
<2> Note that the `spec.agent.ebpf.privileged` specification value must be `true` for packet drop tracking to be enabled.
39+
40+
. When you refresh the *Network Traffic* page, there are new DNS representations you can choose to view in the *Overview* and *Traffic Flow* views and new filters you can apply.
41+
.. Select new DNS choices in *Manage panels* to display graphical visualizations and DNS metrics in the *Overview*.
42+
.. Select new choices in *Manage columns* to add DNS columns to the *Traffic Flows* view.
43+
.. Filter on specific DNS metrics, such as *DNS Id*, *DNS Latency* and *DNS Response Code*, and see more information from the side panel.

networking/network_observability/observing-network-traffic.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,13 +18,19 @@ include::modules/network-observability-pktdrop-overview.adoc[leveloffset=+3]
1818
.Additional resources
1919
* For more information about configuring packet drops in the `FlowCollector`, see xref:../network_observability/observing-network-traffic.adoc#network-observability-packet-drops_nw-observe-network-traffic[Working with packet drops].
2020
21+
include::modules/network-observability-dns-overview.adoc[leveloffset=+3]
22+
23+
[role="_additional-resources"]
24+
.Additional resources
25+
* For more information about configuring DNS in the `FlowCollector`, see xref:../network_observability/observing-network-traffic.adoc#network-observability-dns-tracking_nw-observe-network-traffic[Working with DNS tracking].
2126
2227
//Traffic flows
2328
include::modules/network-observability-trafficflow.adoc[leveloffset=+1]
2429
include::modules/network-observability-working-with-trafficflow.adoc[leveloffset=+2]
2530
include::modules/network-observability-configuring-options-trafficflow.adoc[leveloffset=+2]
2631
include::modules/network-observability-working-with-conversations.adoc[leveloffset=+2]
2732
include::modules/network-observability-packet-drops.adoc[leveloffset=+2]
33+
include::modules/network-observability-dns-tracking.adoc[leveloffset=+2]
2834
include::modules/network-observability-histogram-trafficflow.adoc[leveloffset=+2]
2935

3036
//Topology

0 commit comments

Comments
 (0)