Documentation forServer & Application Monitor

DNS User Experience Monitor

This SAM component monitor tests a Domain Name Server (DNS) server's ability to respond to a record query, compares the query response against a list of IP addresses, and measures the response time. The component monitor passes if the DNS response matches the expected IP addresses.

This monitor measures the time it takes the DNS “get" for the record query referenced in the component monitor to load. Response time is measured in milliseconds (ms).


This component monitor does not compute a statistic.

Orion agent for Linux requirements

This monitor performs name resolution queries in both directions, assuming that the agent machine acts as DNS server (that is, queries are issued against a loopback IP address). Implementation relies on installing a Python library. For details, see Configure Linux/Unix systems for monitoring by the Orion agent in SAM.

Field Descriptions


A default description of the monitor. You can override the default description by adding to or replacing the text, which is automatically saved. The variable to access this field is ${UserDescription}.

Changing the default description to specify what will be monitored can be helpful when receiving alerts and notifications later.

Enable Component

Determines if the component is enabled. Disabling the component leaves it in a deactivated state that does not influence its application availability or status, as displayed in the Orion Web Console.

Port Number

The port used for DNS queries. The default value is 53.


The protocol to use for the DNS query: none, TCP, or UDP.

Name (IP Address) To Resolve

The fully-qualified domain name (FQDN) or IP address to use for the DNS query. If you specify an IP address, the query result should be a FQDN. If you specify a FQDN, the query result should be one or more IP addresses.

Expected DNS Query Results

The IP addresses or FQDN you expect to result from the DNS query. Type each entry on a new line. If you do not care about the DNS query result, you can type the asterisk (*) as a wildcard character that successfully matches any DNS query result.

Expect All Matches

Specifies that the result of the DNS query must include all expected entries to be considered a successful test. If this check box is not checked, a single match indicates a successful test.

Response Time Threshold

Set the warning and critical threshold conditions based on the response time. The response time is the time in milliseconds it takes SolarWinds SAM to determine that a component is not Down and to retrieve any statistical data. See Application Monitor Thresholds.

User Notes

Add notes for easy reference. You can access this field by using the variable, ${UserNotes}. For more information, see "Configuring SolarWinds SAM Alerts"