DNS Logging

DNS query parsing, gateway compatibility, and workarounds.

Overview

Insights Plus includes DNS query parsing for capturing and analyzing DNS traffic from your network. However, some UniFi gateways do not send DNS logs by default.

Gateway Compatibility

The built-in DNS resolver on UniFi gateways uses dnsmasq, which lacks the log-queries directive by default. The dnsmasq configuration is auto-generated by ubios-udapi-server and cannot be permanently modified - changes are overwritten on reboot or provisioning.

Workarounds

If your gateway does not forward DNS logs, you have two options:

  • Use Pi-hole or AdGuard Home as your DNS server - these tools log all DNS queries natively and forward syslog to Insights Plus
  • Wait for a Ubiquiti firmware update - future firmware may add native DNS query logging support

Dashboard Features

When DNS logs are available, the dashboard includes:

  • Top DNS Queries panel - shows the most frequently queried domains across your network
  • DNS type filter toggle - filter the log view to show only DNS events