Log collection for the macOS and iOS clients
Log collection for the macOS clients
The Citrix Secure Access client for macOS provides end-users with several options, including inspecting client logs and sharing them with the development team. These options allow end-users to:
-
View and inspect live logs
-
Email logs to the development team
-
Compress and share logs with the development team
-
Clear previously stored logs
The collection of logs is supported across multiple sessions and is not limited to the current session only.
For the macOS clients, since the application and VPN extensions are running separately, the logs are collected in 2 types of files:
-
nsgControllerApp.log: Collects all logs for the Citrix Secure Access application workflow.
-
nsg_vpnextension_process-pid_Date-time_file_number.log: Collects all logs for the network extension. The
file_numberincreases by 1 for new file.
Configure logging by using the GUI
-
Click the hamburger icon on the Home screen and select the Logs menu to access the log screen.
Note:
The hamburger icon is not available until the user adds at least one configuration or server URL.
-
All configuration related to logs can be done in the Logs screen.
-
Log Level: The following three log levels are available to select:
-
Error: Only exceptions or failures reported by the application are logged.
-
Debug Messages: This level includes debug messages and events relevant from program execution.
-
Verbose: This level includes all log messages reported by Error and Info log levels and other messages that might help in troubleshooting.
-
-
Maximum Number of Log Files: Enter the number of files that you want to add for log collection. This option is mandatory.
-
Open Logs: When you select this option, the latest application and extension log files open in console.
-
Email Logs: Email the log files to the registered email ID using the mail app. A new mail opens with an attached
ta.gzfile. -
Export Logs: When you select this option, all the log files created so far are zipped and saved in the
Downloadsfolder for the current user. The zip file name looks likecitrixsso-20251127-120843-logs.tar.gz. -
Clear Logs: When you select this option, the log files created so far are cleared except the latest
nsgControllerApp.logfile.
-
Log collection for the iOS clients
The Citrix Secure Access client for iOS offers end-users different logging options such as:
-
Share logs
-
Clear logs
For the iOS clients, the Log folder contains separate logs for application and extension:
-
nsgControllerApp.log: Collects all logs for the Citrix Secure Access application workflow.
-
nsg_vpnextension_process-pid_Date-time_file_number.log: Collects all logs for network extension. The file_number increases by 1 for new file.
Tap on the hamburger icon and select Logs to see the options available.
-
Select Log Level: The following three log levels are available to select:
-
Error logging: Only exceptions or failures reported by the application are logged.
-
Debug logging: This level includes debug messages and events relevant from program execution.
-
Verbose logging: This level includes all log messages reported by Error and Info log levels and other messages that might help in troubleshooting.
-
-
Share Logs: On tapping this menu, the device opens up multiple options to share the logs like AirDrop and Mail. Along with this option, the log zip file can be saved to
Filesor copied. If the Mail option is selected, the log zip file is attached to a new mail and can be sent. -
Clear Logs: On tapping this menu, the existing log files are cleared.