Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

added cdn link + minor fixes #253

Merged
merged 2 commits into from
Aug 1, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
106 changes: 52 additions & 54 deletions docs/guides/collect-har-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,53 +11,53 @@ To create a HAR file in Chrome:

1. Go to the URL where the issue occurs. Do not reproduce the issue yet.

2. Open ***Developer Tools***:
2. Open **Developer Tools**:

- From menu: ***Menu → More Tools → Developer Tools***.
- Keyboard: ***Ctrl+Shift+C***, or ***Ctrl+Alt+I***, or ***⌥+⌘+I for Mac***.
- From menu: **Menu → More Tools → Developer Tools**.
- Keyboard: **Ctrl+Shift+C**, or **Ctrl+Alt+I**, or **⌥+⌘+I for Mac**.

3. Click on the ***Network tab***.
3. Click on the **Network tab**.

4. Locate the round button at the top left of the Network tab and confirm it is in red recording mode. If it's grey, click to turn red to start recording.

5. Use the ***clear*** button (the circle button with a line through it next to the record button) to clear all previous activity.
5. Use the **Clear** button (the circle button with a line through it next to the record button) to clear all previous activity.

6. Select the ***Preserve log*** check box on the Network tab.
6. Select the **Preserve log** check box on the Network tab.

7. Check the ***Disable cache*** check box.
7. Check the **Disable cache** check box.

![Chrome](https://cdn.adtidy.org/content/Kb/ad_blocker/guides/chrome.png)

8. Reproduce the steps that create the issue.

9. Save session as a .har file by right-clicking the grid and selecting ***Save as HAR with content***.
9. Save session as a .har file by right-clicking the grid and selecting **Save as HAR with content**.

10. Forward to AdGuard support (support@adguard.com) with detailed explanation of issue. Supporting screenshots can be helpful, as well.

## Edge {#edge}

1. Go to the URL where the issue occurs. Do not reproduce the issue yet.

2. Open ***Developer Tools***:
2. Open **Developer Tools**:

- From menu: ***Menu → More Tools → Developer Tools***.
- Keyboard: ***Ctrl+Shift+C***, or ***Ctrl+Alt+I***, or ***⌥+⌘+I for Mac***.
- From menu: **Menu → More Tools → Developer Tools**.
- Keyboard: **Ctrl+Shift+C**, or **Ctrl+Alt+I**, or **⌥+⌘+I for Mac**.

3. Click on the ***Network tab***.
3. Click on the **Network tab**.

4. Locate the round button at the top left of the Network tab and confirm it is in red recording mode. If it's grey, click to turn red to start recording.

5. Use the ***clear*** button (the circle button with a line through it next to the record button) to clear all previous activity.
5. Use the **Clear** button (the circle button with a line through it next to the record button) to clear all previous activity.

6. Select the ***Preserve log*** check box on the Network tab.
6. Select the **Preserve log** check box on the Network tab.

7. Check the ***Disable cache*** check box.
7. Check the **Disable cache** check box.

![edge](https://cdn.adtidy.org/content/Kb/ad_blocker/guides/edge.png)

8. Reproduce the steps that create the issue.

9. Save session as a .har file by right-clicking the grid and selecting ***Save as HAR with content***.
9. Save session as a .har file by right-clicking the grid and selecting **Save as HAR with content**.

10. Forward to AdGuard support (support@adguard.com) with detailed explanation of issue. Supporting screenshots can be helpful, as well.

Expand All @@ -67,24 +67,24 @@ To create a HAR file in Firefox:

1. Go to the URL where the issue occurs. Do not reproduce the issue yet.

2. Open Developer Tools in ***Network*** mode:
- From menu: ***MenuWeb DeveloperNetwork***.
- Keyboard: ***Ctrl+Shift+C***, or **⌥+⌘+E (Mac)**.
2. Open Developer Tools in **Network** mode:
- From menu: **MenuWeb DeveloperNetwork**.
- Keyboard: **Ctrl+Shift+C**, or **⌥+⌘+E (Mac)**.

3. Note the ***play/pause*** button at the top left of the Network tab.
3. Note the **Play/Pause** button at the top left of the Network tab.
- Button should be in play mode.

4. If any information is currently displayed in the grid, clear by clicking the ***delete trash can*** button next to the play/pause button.
4. If any information is currently displayed in the grid, clear by clicking the **Delete trash can** button next to the play/pause button.

5. Select the ***Persist Logs*** check box on the Network tab.
5. Select the **Persist Logs** check box on the Network tab.

6. Check the ***Disable cache*** check box.
6. Check the **Disable cache** check box.

![firefox](https://cdn.adtidy.org/content/Kb/ad_blocker/guides/firefox.png)

7. Reproduce the steps that create the issue.

8. Save session as a .har file by right-clicking the grid and selecting ***Save all as HAR***.
8. Save session as a .har file by right-clicking the grid and selecting **Save all as HAR**.

9. Forward to AdGuard support (support@adguard.com) with detailed explanation of issue. Supporting screenshots can be helpful, as well.

Expand All @@ -94,81 +94,79 @@ To create a HAR file in Internet Explorer 11:

1. Go to the URL where the issue occurs. Do not reproduce the issue yet.

2. Open Developer Tools in ***Network*** mode:
- From Tools cog wheel menu: ***Developer Tools*** → ***Network tab***.
- Keyboard: ***F12Network*** tab.
2. Open Developer Tools in **Network** mode:
- From Tools cog wheel menu: **Developer Tools** → **Network tab**.
- Keyboard: **F12Network** tab.

3. Note the start profiling session ***Play*** button and stop profiling ***Stop*** button at top left of Network tab.
- Play button will be gray when recording and Stop button will be red. Put in ***Play*** mode.
3. Note the start profiling session **Play** button and stop profiling **Stop** button at top left of Network tab.
- Play button will be gray when recording and Stop button will be red. Put in **Play** mode.

4. Clear any session info appearing in the lower grid using the ***Clear session*** button on Network tab. Hover over icons to see names.
- ***Clear session*** button is a three line icon with an x on it.
4. Clear any session info appearing in the lower grid using the **Clear session** button on Network tab. Hover over icons to see names.
- **Clear session** button is a three line icon with an x on it.

5. Check the ***Disable cache*** check box.
5. Check the **Disable cache** check box.

6. Reproduce the steps that create the issue.

7. Save session as a .har file by clicking on the ***Save disk*** button (Export as HAR) on Network tab.
7. Save session as a .har file by clicking on the **Save disk** button (Export as HAR) on Network tab.

8. Forward to AdGuard support (support@adguard.com) with detailed explanation of issue. Supporting screenshots can be helpful, as well.

## Safari {#safari}

To create a HAR file in Safari:

1. Check the Safari menu bar at the top of the screen for a ***Develop*** menu.
- If not visible, turn it on by going to ***SafariSettingsAdvanced***.
- Check the checkbox at the bottom next to ***Show Develop menu in menu bar***.
1. Check the Safari menu bar at the top of the screen for a **Develop** menu.
- If not visible, turn it on by going to **SafariSettingsAdvanced**.
- Check the checkbox at the bottom next to **Show Develop menu in menu bar**.

2. Go to the URL where the issue occurs. Do not reproduce the issue yet.

3. Open ***Network*** tab in Web Inspector:
- From menu: ***DevelopShow Web InspectorNetwork***.
- Keyboard: ***⌥+⌘+I→Network***
3. Open **Network** tab in Web Inspector:
- From menu: **DevelopShow Web InspectorNetwork**.
- Keyboard: **⌥+⌘+I→Network**

4. Check ***Preserve Log*** checkbox on left side of the Network tabs, within the ***Other filter options...*** menu.
4. Check **Preserve Log** checkbox on left side of the Network tabs, within the **Other filter options...** menu.

![safari](https://github.com/AdguardTeam/KnowledgeBase/assets/95468948/6363e881-98f8-4fb7-9c6a-2eb93ce25a5e)
![safari](https://cdn.adtidy.org/content/kb/ad_blocker/safari/preserve-log.png)

5. Clear current Network items by clicking the **Delete Trash** icon at the far right of Network tabs.
- Keyboard: **⌘+K**

5. Clear current Network items by clicking the ***delete Trash*** icon at the far right of Network tabs.
- Keyboard: ***⌘+K***

6. Check the ***Disable caches*** check box.
6. Check the **Disable caches** check box.

7. Reproduce the steps that create the issue.

8. Save session as a .har file by clicking the ***Export*** icon next to the ***Delete Trash*** icon.
9. ```
8. Save session as a .har file by clicking the **Export** icon next to the **Delete Trash** icon.

9. Forward to AdGuard support (support@adguard.com) with detailed explanation of issue. Supporting screenshots can be helpful, too.

## Android {#android}

To create HAR files, follow these steps:

1. Open AdGuard and go to ***Settings***.
1. Open AdGuard and go to **Settings**.

2. Choose ***Advanced*** in the menu.
2. Choose **Advanced** in the menu.

3. Choose ***Low Level Settings***
3. Choose **Low Level Settings**

4. Activate `pref.har.capture` (you will have to restart the protection).

5. Now reproduce the problem — open the app, perform the necessary actions to make the ad appear.

6. Now turn `pref.har.capture` off again.

7. Go back and tap ***Export logs and system info*** → ***Save***.
7. Go back and tap **Export logs and system info** → **Save**.

## Windows {#windows}

1. Open ***Settings*** → ***General settings******Advanced settings** and scroll down.
1. Open **Settings*** → **General settings** → **Advanced settings** and scroll down.

2. Check the ***Enable HAR writing*** box.
2. Check the **Enable HAR writing** box.

3. Reproduce the problem.

4. Go to ***General settings*** → Click on ***Export logs*** → ***Save***.
4. Go to **General settings** → Click **Export logs** → **Save**.

5. Disable HAR writing by unchecking the corresponding box.
Loading