Collect Okta Verify Logs From macOS and Windows Desktops
Last Updated:
Overview
Okta Verify logs on macOS and Windows operating systems provide diagnostic information for troubleshooting errant conditions or behaviors. Retrieve these local logs from the system directories or the Windows Event Viewer to assist Okta Support in diagnosing desktop authentication issues.
Applies To
- Okta Identity Engine (OIE)
- Desktop Okta Verify
- macOS
- Windows
Solution
How Are Okta Verify Logs Collected on macOS?
Reproduce the issue and copy the local Okta Verify log directory using the terminal to attach the files to an Okta support ticket.
- Reproduce the issue associated with the support ticket to populate the logs with relevant information.
- Manually save a copy of the local Okta Verify log directory from the path below (use Command + Shift + G to go to the folder path after opening Finder):
~/Library/Group Containers/B7F62B65BN.group.okta.macverify.shared/Logs/[com.okta.mobile _date--time_.log]
NOTE: The tilde symbol in macOS is a Symbolic Link to the user's home directory.
- Alternatively, use the following terminal command to save a copy of the Okta Verify logs with a timestamp to the Downloads folder of the current user:
cp -R ~/Library/Group\ Containers/B7F62B65BN.group.okta.macverify.shared/Logs ~/Downloads/OktaVerifyLogs_$(date +%Y_%m_%d-%H%M)
- Attach the logs to the Okta support ticket.
How Are Okta Authenticator Service Logs Collected on macOS?
Reproduce the issue and copy the local OAS log directory to attach the files to an Okta support ticket.
- Reproduce the issue associated with the support ticket to populate the logs with relevant information.
- Gather the log files from the following directory:
/var/log/com.okta.authentication.service/
- Attach the logs to the Okta support ticket.
How Are Okta Verify Logs Collected on Windows?
Enable debug-level logging in the registry, reproduce the issue, and export the Okta log from the Windows Event Viewer to attach to an Okta support ticket.
- Open the Registry Editor by pressing the Windows key and R to open the Run dialog, then enter
regedit. - Navigate to
\HKEY_LOCAL_MACHINE\SOFTWARE\Okta\Okta Verify. - Modify the LogLevel value to Debug.
- Relaunch Okta Verify.
- Reproduce the issue associated with the support ticket to populate the logs with relevant information.
- Open the Windows Event Viewer by pressing the Windows key and R to open the Run dialog, then enter
eventvwr. - Navigate to Applications and Services Logs, right-click Okta, and select Save All Events As....
- Choose a file extension —
.evtxis easiest to parse from another Windows system;.txtor.csvformats allow a clear cross-platform view — then select a save location and name the file with an easily identifiable title. - Attach the Okta log to the Okta support ticket.
How Are Okta Authenticator Service Logs Collected on Windows?
Reproduce the issue and export the Okta Authenticator Service log from the Windows Event Viewer to attach to an Okta support ticket.
- Reproduce the issue associated with the support ticket to populate the logs with relevant information, if not already done.
- Open the Windows Event Viewer by pressing the Windows key and R to open the Run dialog, then enter
eventvwr. - Navigate to Applications and Services Logs, right-click Okta Authenticator Service, and select Save All Events As....
- Choose a file extension —
.evtxis easiest to parse from another Windows system;.txtor.csvformats allow a clear cross-platform view — then select a save location and name the file with an easily identifiable title. - Attach the Okta Authenticator Service log to the Okta support ticket.
Where Are the Okta Verify Installation Logs Located on Windows?
Locate the Okta Verify installation logs in the temporary system or user directories.
These logs match the following naming patterns:
Okta_Verify_[Date][Time].logOkta_Verify_[Date][Time]_000_OktaVerifyx64.log
Okta Support requires both of these log files. Check the following folder locations:
C:\Users\<username>\AppData\Local\Temp\OktaVerifySetup-20220331T094628-Install.logC:\Windows\Temp\OktaVerifySetup-20220331T094628-Install.log
NOTE: The temporary directory depends on the Windows Environment Values. The default value for System Environment Variables is C:\Windows\Temp, and the User Environment Value is C:\Users\<username>\AppData\Local\Temp. Check both temporary folders for the log files.
