iOS Roaming Client Troubleshooting

This section is for troubleshooting any issues associated with the iOS Roaming Client.

In-app Enable Debug logs

Please follow along with the steps below to enable and share your DNSFilter Debug logs:

1. Launch the DNSFilter app
2. Tap on the Status icon at the top right corner
   
3. You will then be prompted to enter in your Mobile PIN
   
4. This PIN can be found in your DNSFilter dashboard under Deployments > Roaming Clients > Manage
5. Click on the 'Edit' icon next to the appropriate device and look for Current Mobile Admin PIN 
   
6. Once entered, scroll down and tap on Enable Debug Logging
7. After you have done this and replicated the issue, you can navigate back to the above settings and tap on Email Debug Logging and tap Send

Console logs

In some cases, our Support Team may require further logging from your iOS device (via Console) if the above Debug Logs do not reveal enough data. The steps below will walk you through how to retrieve those logs from the macOS Console app:

1. Collect the crash logs – App logs can be found in Settings > Privacy > Analytics > Data. The Log name will be DNSFilter-year-month-day.
2. Send the logs – Mail the logs to support@dnsfilter.com
3. Collect logs via the macOS Console app – This can be done by:
   — Plugging in your iOS device (e.g., iPhone or iPad) to your Mac
   — Launch the Console application (Applications > Utilities)
   — From the panel on the left, click on your iOS device name
   — Along the Console menubar, select Action and place a checkmark next to Include Info Messages and Include Debug Messages 
   — Then select Start streaming and now attempt to reproduce the issue
   — Allow the logs to run for 30 minutes
   — Copy/paste the output from the Console into a TextEdit file, save it, and then email those logs over to support@dnsfilter.com