How to collect AdGuard logs

info

This article covers AdGuard for Windows, 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.

To analyze and diagnose different problems that may potentially arise, the AdGuard support service might need AdGuard log files. These files contain records about errors and other events that occur with the software. Below is the brief instruction describing the way to get the log files and send them to the support service if necessary.

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.

Debug logs

1. Open the AdGuard settings. Go to the General Settings section, scroll down to the bottom of the screen, and switch the Logging Level to Debug.

   

2. Reproduce the issue.

   We strongly advise to take note of the exact time when you reproduced the issue: it will help our support team to find relevant log entries and solve the problem faster.

3. Export the collected logs using the Export Logs button.

   

   Save the archive to any folder.

4. Important: after exporting the logs, set the logging level back to Default. Debug logging level will slow down the application.

5. Send the archive to the AdGuard support service at support@adguard.com, describe the problem and don't forget to mention the time when you reproduced the issue.

Trace logs

Sometimes support team members may ask you to send trace logs. Then you will need to do the following:

1. Stop AdGuard by right-clicking the AdGuard icon in the tray menu and choosing Exit AdGuard:

   

   Please don't leave the service running:

   

2. Open the console (type cmd in the start panel).

3. Run the application with the command C:\"Program Files"\Adguard\Adguard.exe /trace regardless of Windows bitness if you have installed AdGuard v7.16 for Windows or later.

If you have an older version of AdGuard for Windows, run the application with the command C:\"Program Files (x86)"\Adguard\Adguard.exe /trace if you are using 64-bit Windows, and C:\"Program Files"\Adguard\Adguard.exe /trace if you are using 32-bit.

1. Reproduce the issue.

   We strongly advise to take note of the exact time when you reproduced the issue: it will help our support team to find relevant log entries and solve the problem faster.

2. Export the collected logs using the Export Logs button.

   

   Don't worry if the log file is large. We need to know as much detail as possible to fix your problem.