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 macOS Roaming Client. Send the log files to our Support team for review.

Before contacting our Support team

Review our DNSFilter Troubleshooting article for common errors and misaligned configurations that can cause issues with DNSFilter, especially if they occur during your deployment.

Often the issue is a software or hardware conflict that can be resolved by updating settings or app removal.

Download logs files

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
  5. After it has successfully run, it will automatically open the downloads folder with a zip folder of the logs. Attach to a Support Request for the team to review.

Additional log details 

Access the log file

Follow this path to access the macOS Roaming Client daemon.log. Use this file for personal scripting or while interacting with our Support team: 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

The configuration file used for editing differs by agent version. Note that TextEdit does not work with either file—use 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 configuration file in the editor

    • Standard: sudo nano /Library/Application\ Support/DNSFilter\ Agent/configuration.json

      Whitelabel: sudo nano /Library/Application\ Support/DNS\ Agent/configuration.json

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

      Whitelabel: 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 or disabled via daemon.conf, configuration.json (v2.4.0 and higher), or the DNSFilter dashboard. Reviewing these logs gives DNSFilter Support a deeper understanding of what could be causing an issue beyond the built-in Diagnostic tool. Configuration changes may take up to 5 minutes to reflect.

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.