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 2016

  • Windows Server 2012 R2

  • Windows Server 2008 R2

Note

Do not select Details in the Other options pane. WinCollect currently does not support this function.

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.

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.

Note

Do not select Details in the Other options pane. WinCollect currently does not support this function.

  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. Click Apply and then click OK.