Applicable to:

• Twingate Component: Client
• Platform: macOS

Overview

This article addresses a known issue where logging is broken upon the installation of our macOS client if the optional "Detailed Logging" option is not checked. This can result in only non-relevant repeating errors appearing in the logs, which may hinder troubleshooting efforts. Follow the steps below to ensure proper logging functionality.

Symptoms

•  Only the following errors appear in com.twingate.macos.tunnelprovider.txt

  2024-06-12 14:29:11.688-0800 [ERROR] [client] -[TunnelProvider startHydraWithCompletion:isRestart:]_block_invoke [Line 221] Hydra connection finished with error (null)
  2024-06-12 14:29:11.688-0800 [ERROR] [client] -[TunnelProvider startHydraWithCompletion:isRestart:]_block_invoke_2 [Line 240] Packetflow start with error (null)
  2024-06-12 14:29:11.716-0800 [ERROR] [client] -[TunnelProvider shutdownWithError:withCompletion:] [Line 287] Shutting down with error Error Domain=com.twingate.tunnel Code=5 "system_stopped_with_reason:1" UserInfo={NSLocalizedDescription=system_stopped_with_reason:1, reason=1}

• Only the following errors appear in com.twingate.macos.txt

  2024-06-12 14:16:13.259-0800 [ERROR] [client] -[VPNManager pluginMessage:withUserInfo:withCompletion:] [Line 681] Failed to send Error Domain=com.anchorfree.hydra.manager Code=5 "vpn must be connected" UserInfo={NSLocalizedDescription=vpn must be connected}
  2024-06-12 14:16:13.629-0800 [ERROR] [client] -[VPNManager pluginMessage:withUserInfo:withCompletion:] [Line 669] Failed to send Error Domain=com.anchorfree.hydra.manager Code=5 "rate limit reached" UserInfo={NSLocalizedDescription=rate limit reached}

Resolution

Step 1: Enable Detailed Logging

1. Click on the Twingate icon in the system tray.
2. Select More > Troubleshoot.
3. Verify there is a check mark next to Collect Detailed Logs.

Step 2: Verify Logs

1. Click on the Twingate icon in the system tray.
2. Select More > Troubleshoot > View Logs > Finder.
3. This will open Finder to the log directories defined below, depending on the installation method.
4. Open the log file in a text editor.
5. Verify that the log file contains entries other than the repeating errors.

Step 3: Adjust Logging Level (Optional)

Once you have verified that the logging system is functioning correctly

1. Click on the Twingate icon in the system tray again.
2. Select More > Troubleshoot.
3. Uncheck the Collect Detailed Logs option to revert to standard logging levels (info, warning, error).

Important Note

Disabling detailed logging after the initial troubleshooting should be done cautiously. While it reduces log verbosity, it might omit critical debug information needed for future troubleshooting.