Skip to main content

How can we help you?

Search

help Knowledge Base
forum Community
checklist Release Notes
event Events

Download MacOS Roaming Client log files

Minetta Gould
  • Updated

    In this article

Use this guide to download log files to troubleshoot issues associated with the Roaming Client for macOS. Send the log files to our Support team for review.

Diagnostic Tool

MacOS Roaming Client 1.6.1 or newer has a Diagnostic tool built into the agent.

  1. Click the DNSFilter status menu icon
  2. Select Diagnostic Tool
  3. Choose a Reason for Diagnostic from the drop down menu
    This choice is for data collection purposes and does not impact how the script runs
  4. Select Run Diagnostic

After it has successfully run, it will automatically open the downloads folder with a zip folder of the logs.

No Diagnostic Tool option?

Follow these steps if you cannot run the tool from the agent or are on an older version.

  1. Download this macOS debug script file
  2. Open a terminal Window
  3. Issue this command: sudo sh \Path\To\The\Script\DNSFilter_Debugger_mac.sh

Another simple way to do this would be to type “sudo sh” and then drag the file directly into the terminal. Once the script has finished, it should open a new Finder window with two log files (daemon.log and DNSFilterDebug.txt).

Access the log file

Follow this path to access the macOS Roaming Client daemon.log. You can use this file for personal scripting or while interacting with our Support team: you can add a log file while opening a support ticket or quickly generate a specific log for review during a screen share.

  1. Open Finder
  2. Select Go
  3. Select Go To Folder
  4. Search for /var/log 

  • /var/log/com.dnsfilter.agent.macos.helper/daemon.log

  • /var/log/io.netalerts.agent.macos.helper/daemon.log

Edit the config file

Some issues can be quickly resolved by editing the Roaming Client daemon.conf. Note that TextEdit does not work with the log: use a different editing program like BBEdit, Sublime Text, or Sudo Nano. 

These instructions use Sudo Nano as example, so follow similar steps when choosing an alternative editor. 

  1. Open the daemon.conf in the editor

    • sudo nano /Library/Application\ Support/DNSFilter\ Agent/daemon.conf

    • sudo nano /Library/Application\ Support/DNS\ Agent/daemon.conf

  2. Make the necessary adjustments to the top of the file
  3. Select Control+X to save the changes
  4. Select Y to confirm the changes
  5. Select Enter to finish the process
  6. Restart the Roaming Client to process the change

Tray icon advanced settings

Run this command to confirm and review current configuration settings that are enabled/disabled via the daemon.conf or DNSFilter dashboard. Seeing these logs offers our Support team a deeper understanding of what could be causing an issue beyond the built-in Diagnostic tool. Note that it can take up to 5 minutes for configurations to reflect properly. 

dig status.trayicon txt +short

Related Troubleshooting

Was this article helpful?
2 out of 11 found this helpful
Return to top

Comments

0 comments

Please sign in to leave a comment.