Skip to main content

How to collect debug logs

info

This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. To see how it works, download the AdGuard app

note

Data and/or files provided in logs are processed in accordance with the AdGuard Privacy Policy.

In this article, we'll guide you through the process of collecting debug logs, an essential troubleshooting step for solving complex issues that may potentially arise. Debug logs provide detailed insight into the inner workings of AdGuard for Android. If the AdGuard support team asks you to provide debug logs, simply follow these instructions.

note

AdGuard is committed to protecting your privacy. We strictly follow our Privacy Policy and do not collect any private information about users. Before sending your logs to the support team, please review the file as it may contain additional information that you don’t want to share. If it contains such personal information, we recommend that you delete it first.

Recording debug log

To collect debug log and send it to us, you need to perform following steps:

  1. Go to SettingsGeneralAdvanced.
  2. Tap Logging level and set it to Debug.
  3. Reproduce the problem and try to remember the exact time it occurred.
  4. Wait a while, then return to Settings and choose the Support tab. Tap Report a bug and complete the required fields. Don't forget to check the Send app logs and system info checkbox. Finally tap Send.

If you're interested in following the resolution of your issue and engaging in a dialogue with the developers, we recommend that you take the following steps after completing the first three:

  1. Wait a while, then return to the Advanced screen and export logs via Export logs and system info. Then report a bug on GitHub by following these instructions.
  2. After creating an issue on GitHub, send the log file to devteam@adguard.com. Include the time of the bug and attach a link to your issue or its number (it appears as #number next to the title). Alternatively, you can upload the log file to Google Drive and send it to devteam@adguard.com. Add the file link to your GitHub issue