Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

DNS Debug Log Source Configuration Options

Use the reference information to configure the WinCollect plug-in for MicrosoftWindows DNS debug logging.

Note:

DNS debug logging can affect system performance and disk space because it provides detailed data about information that the DNS server sends and receives. Enable DNS debug logging only when you require this information.

DNS debug logging is supported on the following Windows versions:

  • Windows Server 2019 (including Core)

  • Windows Server 2016 (including Core)

  • Windows Server 2012 R2

  • Windows Server 2012

Table 1: DNS Debug Protocol Parameters

Parameter

Description

File Reader Type

Reads file contents. Both options have basic Unicode encoding support for byte-order marks.

If you choose the Text (file held open) option, then WinCollect maintains a shared read and write lock on the monitored log file.

If you choose the Text (file open when reading) option, then WinCollect maintains a shared read and write lock on the log file only when it reads the file.

File Monitor Type

Detects file and directory changes:

The Notification-based (local) option uses the Windows file system notifications to detect changes to your DNS log.

The Polling-based (remote) option monitors changes to remote files and directories. The agent polls the remote DNS log and compares the file to the last polling interval. If the log contains new entries, the entries are retrieved.

File Pattern

The regular expression (regex) required to match the DNS debug log file set in the DNS manager.

Root Directory

The directory where WinCollect monitors files. The directory must be Local File System for local collection, or a valid MicrosoftWindows universal naming convention (UNC) path for remote collection.

This value must match the file path that is configured in your DNS manager.

Note:

Due to restrictions in distributed systems, the path can't be verified in the user interface.

Include DNS Details

Includes DNS details in the Windows Server DNS debugging log.

For more information about Microsoft DNS Debug specifications, see the Configuring DSMs Guide.

Enabling DNS Debugging on Windows Server

Enable DNS debugging on Windows Server to collect information that the DNS server sends and receives.

The DNS role must be installed on the Windows Server.

  1. Open the DNS Manager with the following command:

    dnsmgmt.msc

  2. Right-click the DNS server and click Properties.

  3. Click the Debug Logging tab.

  4. Select Log packets for debugging.

  5. In the log file, type the file path and name, and the maximum size.

    Note:

    The file path and name, must align with the Root Directory and File Pattern that you provided when you configured the Microsoft DNS log source in JSA.

  6. If you want to include DNS details in the log, select Details in the Other options section, and then select Include DNS Details in the log source.

  7. Click Apply and then click OK.

Related Documentation