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: content/en/network_monitoring/dns/_index.md
+29-34Lines changed: 29 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,62 +22,56 @@ further_reading:
22
22
text: "Monitor DNS logs for network and security analysis"
23
23
---
24
24
25
-
{{< img src="network_performance_monitoring/dns_monitoring/dns_overview.png" alt="The DNS monitoring page in Datadog" >}}
25
+
## Overview
26
26
27
-
<divclass="alert alert-info">
28
-
Upgrade to Agent version 7.33 or later to enable DNS monitoring.
29
-
</div>
27
+
DNS Monitoring provides visibility into DNS server performance to help you identify server-side and client-side DNS issues. By collecting and displaying flow-level DNS metrics, you can identify:
30
28
31
-
DNS Monitoring provides an overview of DNS server performance to help you identify server-side and client-side DNS issues. By collecting and displaying flow-level DNS metrics, this page can be used to identify:
29
+
* Which pods or services are making DNS requests and which servers are handling them.
30
+
* Top requesters and their query rates.
31
+
* DNS servers experiencing gradual or sudden response time spikes.
32
+
* High error rates and specific error types from DNS servers.
33
+
* Domain resolution patterns across your infrastructure.
32
34
33
-
* The pods or services making DNS requests and the servers receiving those requests.
34
-
* The endpoints making the most requests or making requests at the highest rate.
35
-
* If a DNS server's response time to requests has gradually or suddenly increased.
36
-
* The DNS servers with a high error rate and the type of errors being emitted.
37
-
* Which domains are being resolved.
35
+
{{< img src="network_performance_monitoring/dns_monitoring/dns_overview_2.png" alt="The CNM Analytics page with the DNS toggle enabled." >}}
38
36
39
-
## Setup
37
+
## Prerequisites
40
38
41
-
Before you can begin to use DNS Monitoring, [set up Cloud Network Monitoring][1]. Also ensure you are using the latest version of the Agent, or at least Agent v7.23+ for Linux OS, and v7.28+ for Windows Server. Once installed, a **DNS** tab is accessible in the Cloud Network Monitoring product.
39
+
- Agent version 7.33 or later
40
+
- Enable [Cloud Network Monitoring][1] (CNM)
42
41
43
-
Are you looking for Network Device Monitoring instead? See the [NDM setup instructions][2].
42
+
<divclass="alert alert-info"> This documentation applies to DNS Monitoring in CNM. For information on Network Device Monitroring (NDM), see the <ahref="/network_monitoring/devices/setup/">NDM setup instructions</a>.
43
+
</div>
44
44
45
45
## Queries
46
46
47
-
Use the search bar at the top of the page to query for dependencies between a client (which makes the DNS request) and a DNS server (which responds to the DNS request). The destination port is automatically scoped to DNS port 53 so that all resulting dependencies match this (client → DNS server) format.
47
+
On the **DNS** toggle in [**CNM > Analytics**][5], use the search bar to query for dependencies between a client (which makes the DNS request) and a DNS server (which responds to the DNS request). The destination port is automatically scoped to DNS port `53` so that all resulting dependencies match this **client → DNS server** format.
48
48
49
-
To refine your search to a particular client, aggregate and filter DNS traffic using client tags in the search bar. In the default view, the client is automatically grouped by the most common tags. Accordingly, each row in the table represents a service that is making DNS requests to some DNS server.
49
+
To narrow your search to a specific client, use client tags in the search bar to filter DNS traffic. By default, clients are grouped by the most common tags, with each row representing a service making DNS requests to a DNS server.
50
50
51
-
{{< img src="network_performance_monitoring/dns_monitoring/dns_client_search.png" alt="The DNS monitoring page with client_service:ad-server entered into the search bar, pod_name entered for View clients as, and network.dns_query entered for View servers as" style="width:100%;">}}
51
+
{{< img src="network_performance_monitoring/dns_monitoring/dns_client_search_2.png" alt="The DNS monitoring page with client_service:web-store entered into the search barand `network.dns_query` entered for View servers as" style="width:100%;">}}
52
52
53
53
To refine your search to a particular DNS server, filter the search bar by using server tags. Configure your server display with one of the following options from the **Group by** dropdown menu:
54
54
55
-
*`dns_server`: The server receiving DNS requests. This tag has the same value as `pod_name` or `task_name`. If those tags are not available, `host_name` is used.
56
-
*`host`: The host name of the DNS server.
57
-
*`service`: The service running on the DNS server.
58
-
*`IP`: The IP of the DNS server.
59
-
*`dns_query`: (Requires Agent version 7.33 or later) The domain that was queried.
60
-
61
-
This example shows all flows from pods in the production environment's availability zone to hosts receiving DNS requests:
62
-
63
-
{{< img src="network_performance_monitoring/dns_monitoring/dns_query_example.png" alt="Query with client_availability_zone:us-central1-b and client_env: prod entered into the Search for field, pod_name selected in the View clients as dropdown, and host selected in the View servers as dropdown" style="width:100%;">}}
55
+
*`dns_server`: The server receiving DNS requests. This tag has the same value as `pod_name` or `task_name`. If those tags are not available, `host_name` is used.
56
+
*`host`: The host name of the DNS server.
57
+
*`service`: The service running on the DNS server.
58
+
*`IP`: The IP of the DNS server.
59
+
*`dns_query`: The domain that was queried.
64
60
65
61
### Recommended queries
66
62
67
-
{{< img src="network_performance_monitoring/dns_monitoring/recommended_queries_dns.png" alt="Recommended queries in the DNS monitoring page displaying the description of a query" style="width:100%;">}}
63
+
{{< img src="network_performance_monitoring/dns_monitoring/recommended_queries_dns_2.png" alt="Recommended queries in the DNS monitoring page displaying the description of a query for DNS timeouts." style="width:100%;">}}
68
64
69
65
There are three recommended queries at the top of the DNS page, similar to the [Network Analytics][4] page. These are static queries commonly used to investigate DNS health and view high-level DNS metrics. Use the recommended queries as a starting point to gain further insights into your DNS configuration and troubleshoot DNS issues.
70
66
71
67
You can hover over a recommended query to see a short description of what the results of the query mean. Click on the query to run the query, and click **Clear query** to remove the query. Each recommended query has its own set of recommended graphs as well; clearing the recommended query resets the graphs to their default settings.
72
68
73
69
## Metrics
74
70
75
-
Your DNS metrics are displayed through the graphs and the associated table.
71
+
The following DNS metrics are available:
76
72
77
73
**Note**: Data is collected every 30 seconds, aggregated in five minute buckets, and retained for 14 days.
|**DNS requests**| The number of DNS requests made from the client. |
@@ -92,12 +86,12 @@ The following DNS metrics are available:
92
86
93
87
## Table
94
88
95
-
The network table breaks down the above metrics by each _client_ and _server_ dependency defined by your query.
96
-
97
-
Configure the columns in your table using the **Customize** button at the top right of the table.
89
+
The network table breaks down the above metrics by each _client_ and _server_ dependency defined by your query. You can configure the columns in your table using the Customize gear icon (⚙️) at the top right of the table.
98
90
99
91
Narrow down the traffic in your view with the **Filter Traffic**[options][3].
100
92
93
+
{{< img src="network_performance_monitoring/dns_monitoring/dns_table_view.png" alt="The CNM Analytics page showing the table view of DNS network traffic." >}}
94
+
101
95
## Sidepanel
102
96
103
97
The sidepanel provides contextual telemetry to help you quickly debug DNS server dependencies. Use the Flows, Logs, Traces, and Processes tabs to determine whether a DNS server's high number of incoming requests, response time, or failure rate is due to:
@@ -106,14 +100,15 @@ The sidepanel provides contextual telemetry to help you quickly debug DNS server
106
100
* Application errors in the code on the client side
107
101
* A high number of requests originating from a particular port or IP
0 commit comments