Learn how to investigate issues on devices with installed Safetica Client, collect logs, and report issues to Safetica Support.
Introduction
When solving issues with a device with installed Safetica Client, it might be necessary to troubleshoot the device and collect logs from it to better analyze the root cause of the problem.
You can choose between:
How to collect existing device logs
Use when: You don’t need to reproduce the issue, and just want basic log data already available on the device.
To collect existing device logs:
- Go to the Devices section and click the problematic device.
- Click Actions > Collect device logs.
- Wait for the log collection process to complete (may take a few minutes).
- Once logs are collected, click the download link in the device detail.
- Download the logs to your computer and send them to your partner or Safetica Support.
How to cancel log collection
If you realize the log collection is no longer needed, you can cancel it:
- Go to the Devices section and click the relevant device.
- Click Actions > Cancel log collection.
✍️No logs will be collected after cancellation.
How to run troubleshooting and collect detailed logs
Use when: You need to collect detailed verbose logs and are able to reproduce the issue on the device.
❗Detailed logs can be large (up to 1 GB).
❗If the device with installed Safetica Client can't connect to the server, you may need to collect logs locally. Learn more here.
To run troubleshooting:
- Go to the Devices section and click the problematic device.
- ClickActions > Run troubleshooting.
- Choose how long the troubleshooting should run: 1 day, 3 days, or 7 days.
- During that time, reproduce the issue on the problematic device.
- After reproducing the issue:
- Wait until the selected troubleshooting period ends, or
- Manually stop the troubleshooting by clicking Actions > Stop troubleshooting and collect detailed logs.
- Once troubleshooting is finished or manually stopped, detailed logs are collected automatically. The log collection process may take some time.
- Once logs are collected, click the download link in the device detail.
- Download the logs to your computer and send them to your partner or Safetica Support.
How to cancel troubleshooting
If you realize the troubleshooting is no longer needed, you can cancel it without collecting logs:
- Go to the Devices section and click the relevant device.
- Click Actions > Cancel troubleshooting.
✍️No logs will be collected after cancellation.
FAQ
Q: How do I remove the "Troubleshooting finished" status from a device?
A: To remove the "Troubleshooting finished" status and return the device to its normal state:
- Go to the Devices section and click the device.
- Download the collected logs.
- Refresh the page - the status should return to normal.
Q: Can I download logs more than once?
A: Yes, you can download logs as many times as needed.
Just note: The logs will be overwritten if you run new troubleshooting or new device log collection.
Q: Can I collect device logs while troubleshooting is running?
A: No, the actions Run troubleshooting and Collect device logs are mutually exclusive.
If you select Run troubleshooting, you can then only Stop troubleshooting and collect device logs or Cancel troubleshooting. The Collect device logs option will not be present in the Actions drop-down.
If you select Collect device logs, you can then only Cancel log collection. The Run troubleshooting option will not be present in the Actions drop-down.