ScoutDNS Windows Agent Diagnostic Tool Guide

ScoutDNS Windows Agent Diagnostic Tool Guide

ScoutDNS Windows Agent Diagnostic Tool Guide

Overview

The ScoutDNS diagnostic tool helps troubleshoot Windows agent issues by collecting system and configuration data for analysis. This guide explains when and how to use the tool effectively.

When to Run the Diagnostic Tool

For best results, run the diagnostic tool at two key times:

  1. When the machine is working normally — This creates a baseline for comparison.
  2. Shortly after detecting an issue — Run the tool as soon as possible after noticing a problem, ideally before disabling the DNS agent.

Capturing both states helps the support team identify what changed and pinpoint the root cause.

Downloading the Tool

Download the diagnostic tool from:

https://download.scoutdns.com/assets/scoutdiag.exe

Running the Diagnostic Tool

Option 1: PowerShell (Local)

Open PowerShell, navigate to the directory containing the tool, and run:

./scoutdiag -silent

Option 2: PowerShell (Remote or Background)

To run the tool remotely or without displaying a window:

Start-Process -FilePath ".\scoutdiag.exe" -ArgumentList "-silent" -WindowStyle Hidden

Submitting Results

After running the tool, send the following files to the support team:

  • results.yaml — Generated by the diagnostic tool
  • agent.log — Located at C:\Program Files\ScoutDNS\Device Agent\agent.log

Common Troubleshooting Tips

If you're experiencing DNS failures, check the following before contacting support:

  • Forwarding domains — Verify that forwarding domains are correctly configured in the local forward settings of your profile.
  • Upstream connectivity — Occasional upstream failures (e.g., to external resolvers) may appear in logs but don't necessarily cause DNS failures on their own.

Summary

  1. Download the diagnostic tool
  2. Run it during normal operation (baseline) and again after any issue occurs
  3. Send the results.yaml file and logs to support for analysis

    • Related Articles

    • Setup and Use Guide for MSPs

      ScoutDNS is built for Managed Service Providers (MSPs) to deliver robust DNS protection to their customers and end users. Setup is straightforward, thanks to our object-based configuration approach. Here is a brief outline of what this guide covers. ...

    • Quick Start Setup Guide - WAN Forwarding

      This quick start guide is meant to help get up and running quickly with the various deployment methods offered. This is the general use guide. If you are an MSP, please visit the MSP Setup Guide. There are three methods you can use to protect your ...

    • Install ScoutDNS Certificate for Browser HTTPS Errors

      When a site or domain is blocked by ScoutDNS, a block page is displayed to the end user instead of the requested domain. If the requested domain is encrypted with HTTPS, a security error will occur. To resolve this and display a valid block page for ...

    • Relay - Setup and Configure

      ScoutDNS supports a Relay configuration, allowing operators to install a lightweight service within their network. The relay acts as a local forwarding resolver, processing internal queries while forwarding public queries to the ScoutDNS cloud ...

    • Roaming Clients / Device Agents - Setup, Configure, and Manage

      ScoutDNS provides device agents for organizations that wish to protect devices with DNS-layer security both on and off the network. The ScoutDNS device agent is an extremely lightweight application, best installed on managed devices where ...

    • Popular Articles

    • Working with Whitelist and Blacklist

      At times, it may be helpful to fully block or allow a domain based on your desired outcome. The White/Black List tab allows you to create and manage custom block and allow lists. You can associate these lists with all policies (global) or assign them ...

    • Quick Start Setup Guide - WAN Forwarding

      This quick start guide is meant to help get up and running quickly with the various deployment methods offered. This is the general use guide. If you are an MSP, please visit the MSP Setup Guide. There are three methods you can use to protect your ...

    • Content Categories

      Below is a list of Content Categories and their descriptions. Adult Abortions These are sites that present arguments either in favor of or against abortion. This includes information on abortion procedures, sites that offer assistance in obtaining ...

    • Mixing DNS Providers

      It is generally not recommended to mix DNS providers. Most routers and systems randomly select which DNS server receives each packet, which can lead to issues with filtering and reporting due to mixed rules in the system cache. To avoid these ...

    • YouTube Restricted Mode Explained

      ScoutDNS supports YouTube's restricted modes, allowing for a level of content control on the platform. While individual videos cannot be allowed or blocked at the URL level, Google G Suite users can approve specific videos for others within the same ...

    • Recent Articles

    • ScoutDNS Windows Agent Diagnostic Tool Guide

      ScoutDNS Windows Agent Diagnostic Tool Guide Overview The ScoutDNS diagnostic tool helps troubleshoot Windows agent issues by collecting system and configuration data for analysis. This guide explains when and how to use the tool effectively. When to ...

    • SIEM Data Export

      Overview The SIEM Data Export feature allows administrators to stream DNS query and event data from ScoutDNS directly into their SIEM or log analytics platform for advanced analysis, threat correlation, and compliance reporting. ScoutDNS currently ...

    • Applications Categories - Zero Trust App Management

      The ScoutDNS Application Policy sub-tab lets you block whole groups of web applications while still allowing specific apps through an allow list. It covers tens of thousands of domains and supports a zero-trust security approach. For example, you can ...

    • Configure Entra ID based Policies

      ScoutDNS supports policy enforcement by user groups synced from Entra ID (formerly Azure AD). This is useful when admins want policy decisions to follow the user regardless of the device or device profile in use. This guide explains how ScoutDNS ...

    • Setup and Use Guide for MSPs

      ScoutDNS is built for Managed Service Providers (MSPs) to deliver robust DNS protection to their customers and end users. Setup is straightforward, thanks to our object-based configuration approach. Here is a brief outline of what this guide covers. ...