Как собирать лог-файлы, журналы событий и что такое HAR-логи, основы

Журналы или логи — это записи событий, которые генерируются веб-сайтами или программным обеспечением при их запуске. Разработчики используют их для отладки.

Что такое лог-файлы (журналы событий)?

Существуют разные типы логов:

• Логи консоли браузера. Содержат информацию, связанную с веб-страницей, например сетевые запросы, JavaScript, CSS, ошибки безопасности и предупреждения. Эти журналы необходимы при тестировании веб-сайта;
• Логи мобильных устройств: содержат события, отправленные системой и приложениями, запущенными на устройстве. Эти логи необходимы при тестировании мобильного приложения;
• Сетевые журналы. Содержат трафик HTTP(S) между вашим компьютером и Интернетом, который помогает диагностировать любые проблемы с сетью. Эти журналы необходимы в некоторых циклах тестирования.

То, что нужно запомнить

Важные моменты, которые следует помнить при сборе логов:

1. Очистка старых журналов. Перед началом необходимо очистить старые сохраненные журналы, прежде чем приступать к сбору новох логов.
2. Формат файла. Логи рекомендуется сохранять в формате .txt.
3. Файл журнала должен содержать информацию об активности и трафике веб-сайта или приложения.
4. Временная метка. Убедитесь, что лог-файл содержит временные метки. Временные метки видны в начале каждой строки или записи (например, 11:33:22.754 Navigated to https://appnet.club).

Десктопные логи браузера

Браузеры для настольных компьютеров работают одинаково во всех ОС, поэтому вы можете выполнить одни и те же действия в Windows, macOS или Linux.

Google Chrome или любой браузер на базе Chromium

1. Нажмите CTRL+Shift+I или F12 или выберите трехточечный значок > Дополнительные инструменты > Инструменты разработчика.
2. Выберите Консоль > значок шестеренки в правом верхнем углу.
3. Прокрутите вниз до раздела "Настройки консоли" > выберите "Показать временные метки" и "Сохранять журнал при навигации"
4. Выход из настроек.
5. Очистите консоль, нажав значок "Очистить консоль" или щелкните правой кнопкой мыши внутри окна консоли и выберите "Очистить консоль".
6. Обновите страницу и воспроизведите проблему, начиная с главной страницы.
7. Щелкните журналы правой кнопкой мыши и выберите "Сохранить как".
8. Альтернативно вы можете скопировать журналы из консоли и вставить их в любую программу текстового редактора.
9. Сохраните файл в формате .txt.
10. Откройте журнал консоли и убедитесь, что есть временные метки и строка "Перешел на" с веб-сайтом тестирования (например, 11:33:22.754 Navigated to https://appnet.club).

Firefox

1. Нажмите CTRL+Shift+K или F12 или выберите значок гамбургера в правом верхнем углу и выберите "Веб-разработчик" > "Инструменты веб-разработчика".
2. На консоли выберите значок шестеренки в правом верхнем углу и выберите "Сохранить журналы" и "Показать временные метки".
3. Нажмите на значок корзины, чтобы очистить старые журналы.
4. Обновите страницу и воспроизведите проблему, начиная с главной страницы.
5. Чтобы записать журналы, щелкните правой кнопкой мыши консоль> выберите "Сохранить все сообщения в файл".
6. Сохраните файл в формате .txt.
7. Откройте журнал консоли и убедитесь, что есть временные метки и строка "Перешел на" с веб-сайтом тестирования (например, 11:33:22.754 Navigated to https://appnet.club).

Safari

1. Нажмите Safari в строке меню и выберите "Настройки".
2. Выберите значок шестеренки "Дополнительно" > установите флажок "Показать меню разработки" в строке меню.
3. Закройте окно и выберите раскрывающийся список "Разработка" > "Показать веб-инспектор".
4. В окне консоли выберите "Сохранить журнал" и нажмите значок корзины, чтобы очистить журналы.
5. Обновите домашнюю страницу и воспроизведите проблему, начиная с главной страницы.
6. Перейдите на вкладку "Консоль", затем нажмите "Command+S", чтобы сохранить журнал.
   • При сохранении журнала важно сначала щелкнуть консоль, а затем нажать Command+S.
7. Сохраните файл в формате .txt.

Как найти расширения файлов и изменить их?

Windows 10

1. Откройте проводник в Windows 10 или любую папку на вашем компьютере.
2. Перейдите на вкладку Вид в верхнем меню, чтобы просмотреть меню ленты.
3. Нажмите на опцию "Расширения имен файлов", чтобы включить расширение файла.
4. Вернитесь к файлу журнала, расширение которого вы хотите изменить.
5. Дважды щелкните имя файла и измените расширение файла на .txt. Альтернативно вы можете щелкнуть файл правой кнопкой мыши, а затем выбрать "Переименовать в контекстном меню".

macOS

1. Нажмите правой кнопкой мыши на файл, затем выберите "Переименовать" в контекстном меню.
2. Измените расширение файла на .txt , затем нажмите клавишу Enter или щелкните за пределами области файла.
3. Подтвердить.

Десктопные HAR-логи  браузера

В этой главе вы узнаете как собирать HAR-логи через консоль браузера. Браузеры для настольных компьютеров работают одинаково во всех ОС, поэтому вы можете выполнить одни и те же действия в Windows, macOS или Linux.

Что такое HAR-логи ?

Это означает HTTP-архив. Журнал HAR содержит информацию о взаимодействии браузера и тестируемого веб-сайта. Эта информация полезна разработчикам, помогая устранять неполадки и определять основные причины проблем.

Формат HAR поддерживается различным программным обеспечением, например:

• Charles Proxy;
• Fiddler;
• Firebug;
• Firefox;
• Google Chrome;
• Microsoft Edge;
• OWASP ZAP.

Читайте дальше что-бы узнать как собирать и просматривать их с помощью самых популярных веб-браузеров.

То, что нужно запомнить

Помните, что файлы HAR содержат конфиденциальные данные, поэтому, если проблема, которую вы пытаетесь воспроизвести, включает в себя ваше имя пользователя, пароль, PIN-код, CVV, номера счетов, номера карт или любую личную и конфиденциальную информацию, убедитесь, что все экземпляры этих элементов удаляются из файла журнала HAR (дальше вы узнаете, как удалить эти элементы из журнала).

Как собирать журналы HAR

Google Chrome или любой браузер на базе Chromium

1. 1. Нажмите CTRL+Shift+I (Windows) / Option+Command+I (Mac) или выберите трехточечный значок > Дополнительные инструменты > Инструменты разработчика.
   2. Откройте вкладку "Сеть" (если вкладка "Сеть" не видна, нажмите значок >> или разверните окно "Инструменты разработчика").
   3. Установите флажок Сохранить журнал.
   4. Очистите трафик, нажав значок "Очистить" 
   5. Откройте веб-сайт тестирования и воспроизведите проблему.
   6. Щелкните журналы правой кнопкой мыши или нажмите CTRL + щелчок (Mac) и выберите "Сохранить все как HAR с содержимым".
      • Альтернативно вы можете нажать кнопку Экспортировать HAR (значок "загрузить") в верхней части вкладки Сеть.
   7. Сохраните файл как .har.

Firefox

1. Нажмите CTRL+Shift+E (Windows) / Option+Command+I (Mac) или откройте Меню > Дополнительные инструменты > Инструменты веб-разработчика.
2. Откройте вкладку "Сеть" (если вкладка "Сеть" не видна, нажмите значок >> или разверните окно "Инструменты разработчика").
3. Нажмите на значок шестеренки и выберите "Сохранить журналы".
4. Очистите трафик, нажав на значок "Очистить" .
5. Обновите домашнюю страницу и воспроизведите проблему, начиная с главной страницы.
6. Щелкните журналы правой кнопкой мыши или нажмите CTRL+щелчок (Mac) и выберите «Сохранить все как HAR».
   • Альтернативно вы можете нажать на значок шестеренки и выбрать опцию "Сохранить все как HAR".
7. Сохраните файл как .har.

Safari

1. Нажмите Safari в строке меню и выберите "Настройки".
2. Откройте вкладку "Дополнительно" > установите флажок "Показать меню "Разработка" в строке меню.
3. Закройте окно и нажмите Option+Command+I или нажмите "Разработка" в верхней строке меню > "Показать веб-инспектор".
4. Откройте вкладку "Сеть" (если вкладка "Сеть" не видна, нажмите значок >> или разверните окно "Инструменты разработчика").
5. Выберите "Сохранить журнал" (если параметр "Сохранить журнал" не отображается, разверните окно "Инструменты разработчика").
6. Очистите вкладку, нажав на значок корзины.
7. Обновите домашнюю страницу и воспроизведите проблему, начиная с главной страницы.
8. Нажмите CTRL + щелкнуть журналы и выберите Экспортировать как HAR.
   • Альтернативно вы можете нажать кнопку "Экспорт" .
9. Сохраните файл как .har.

Как редактировать файл журнала HAR?

Windows 10

1. Откройте файл HAR в текстовом редакторе, например Блокноте или Notepad++.
2. Используйте функцию замены текстового редактора для поиска информации, которую вы хотите удалить.
   • Например, найдите свое полное имя, адрес, день рождения, номер телефона, номер банковского счета, номер карты, CCV или любую конфиденциальную информацию, которую вы предоставили при тестировании веб-сайта.
3. Замените её на **** или вы можете использовать любой другой "текст-заполнитель", чтобы отредактировать информацию.
4. Сохраните файл.

macOS

1. Откройте файл HAR с помощью приложения TextEdit по умолчанию.
2. Наведите указатель мыши на "Найти" и выберите параметр "Найти и заменить".
3. Найдите информацию, которую вы хотите удалить из журнала HAR, и замените её на **** или используйте любой другой "текст-заполнитель", чтобы отредактировать информацию.
   • Например, найдите свое полное имя, адрес, день рождения, номер телефона, номер банковского счета, номер карты, или любую конфиденциальную информацию, которую вы предоставили при тестировании веб-сайта, а затем замените её.
4. Сохраните файл.

Журналы (логи) мобильных браузеров

Сбор журналов мобильного браузера немного сложен и требует использования компьютера - этот процесс известен как удаленная отладка.

Браузеры на базе Chromium и Firefox поддерживают только удаленную отладку через USB для устройств Android. iOS поддерживает только удаленную отладку в Safari.

Предварительные требования для устройств Android

1. Включите Параметры разработчика на своем устройстве Android, нажав на номер сборки семь раз.
2. Если у вас возникли проблемы с включением параметров разработчика, изучите дополнительную информацию о своем девайсе.
3. Откройте "Параметры разработчика" и включите "Отладку по USB".
4. Подключите устройство Android напрямую к компьютеру с помощью USB-кабеля.
5. Загрузите инструменты платформы SDK на свой компьютер отсюда.
6. Разархивируйте его и откройте папку.
7. Откройте командную строку (Windows) или терминал (macOS или Linux).
8. Введите cd и пробел, а затем перетащите разархивированную папку инструментов платформы в командную строку или терминал и нажмите Enter.
9. Теперь вы должны находиться в папке инструментов платформы, например: cd c:\users\john\desktop\platform-tools.
10. Введите adb start-server и разрешите любые запросы разрешений на вашем устройстве.

Удаленная отладка в Google Chrome или любом браузере на базе Chromium [только для Android]

Перед началом обязательно убедитесь что вы выполнили предварительные требования!

1. Откройте браузер Google Chrome для ПК на своем компьютере и перейдите по адресу chrome://inspect#devices.
2. Не имеет значения, какой браузер на базе Chromium вы используете на устройстве Android для тестирования - вы также можете использовать Google Chrome десктоп для проверки вкладок этого браузера.
3. Убедитесь, что флажок Обнаружить USB-устройства установлен, а ваше устройство подключено к компьютеру и разблокировано.
4. Если вы видите название модели вашего устройства Android, это означает, что DevTools успешно установил соединение с вашим устройством.
   • Если устройство отображается как "Офлайн", примите запрос на разрешение "Разрешить отладку по USB" на своем устройстве Android.
   • Если DevTools не обнаруживает устройство, изучите дополнительную информацию о действиях по устранению неполадок.
5. Все открытые вкладки мобильного браузера будут отображаться в браузере Chrome на десктопе, рекомендуется закрыть все вкладки.
6. Откройте веб-сайт тестирования на устройстве Android.
7. Затем нажмите кнопку "Проверить" в настольном браузере Chrome рядом с URL-адресом веб-сайта тестирования. Откроется новое окно DevTools.
8. На вкладке "Консоль" нажмите значок шестеренки в правом верхнем углу.
   Прокрутите вниз до раздела "Настройки консоли" > выберите "Показать временные метки" и "Сохранять журнал при навигации".
9. Выйдите из настроек.
10. Очистите консоль, нажав значок "Очистить консоль" или щелкните правой кнопкой мыши внутри окна консоли и выберите "Очистить консоль".
11. Обновите страницу и воспроизведите проблему, начиная с главной страницы.
12. Щелкните журналы правой кнопкой мыши и выберите "Сохранить как".
13. Сохраните файл в формате .txt.
    Откройте журнал консоли и убедитесь, что есть временные метки и строка «Перешел на» с веб-сайтом тестирования (например, 11:33:22.754 Navigated to https://appnet.club).

Удаленная отладка в Firefox [только для Android]

1. Откройте браузер Firefox на своем компьютере, нажмите гамбургер-меню и выберите "Веб-разработчик" > "Удаленная отладка".
2. Нажмите кнопку Включить USB-устройства.
3. Откройте Firefox на своем устройстве Android, коснитесь меню "3 точки" и включите "Удаленную отладку через USB" в настройках.
4. Вы увидите имя своего устройства в десктопном браузере Firefox, нажмите "Подключиться" рядом с ним.
5. Нажмите на имя устройства, чтобы увидеть все открытые вкладки, рекомендуется закрыть все вкладки.
6. Откройте веб-сайт тестирования в Firefox (устройство Android).
7. Затем нажмите кнопку "Проверить" в десктопном браузере Firefox рядом с URL-адресом веб-сайта тестирования.
8. Откроется новое окно панели инструментов, выберите вкладку Консоль, затем щелкните значок шестеренки в правом верхнем углу и выберите Постоянные журналы и Показать временные метки.
9. Нажмите на значок корзины, чтобы очистить старые журналы.
10. Обновите страницу и воспроизведите проблему, начиная с главной страницы.
11. Чтобы записать журналы, щелкните правой кнопкой мыши консоль> выберите Экспорт видимых сообщений в > Файл.
12. Сохраните файл в формате .txt.
13. Откройте журнал консоли и убедитесь, что есть временные метки и строка "Перешел на" с веб-сайтом тестирования (например, 11:33:22.754 Navigated to https://appnet.club).

Удаленная отладка в Safari [только для iOS]

1. Сначала откройте настройки iOS, прокрутите вниз, выберите Safari > Дополнительно и включите Веб-инспектор.
2. Подключите устройство iOS напрямую к компьютеру (должна быть macOS), убедитесь, что вы доверяете своему устройству Mac.
3. На вашем устройстве iOS откройте Safari и оставьте одну вкладку открытой.
4. На устройстве Mac откройте Safari и выберите "Настройки".
5. Выберите значок шестеренки "Дополнительно" и установите флажок "Показать меню разработки" в строке меню.
6. Закройте окно и нажмите Разработка > Имя вашего iPhone (например, Мой iPhone) > Открытая вкладка Safari.
7. Откроется веб-инспектор, перейдите на вкладку консоли.
8. В окне консоли выберите "Сохранить журнал" и нажмите значок корзины, чтобы очистить журналы.
9. Обновите домашнюю страницу и воспроизведите проблему, начиная с главной страницы вашего устройства iOS.
10. Чтобы сохранить журналы, нажмите Command+S.
11. Сохраните файл в формате .txt.

Журналы HAR браузера Android

Как собирать логи HAR на Android

Настройка мобильного устройства:

1. Включите параметры разработчика, нажав семь раз на номер сборки. (может отличаться для каждого устройства Android). 
2. Открыть параметры разработчика.
3. Включите опцию отладки по USB.
4. Нажмите на кнопку ОК в открывшемся окне.
5. Подключите телефон к компьютеру через USB-кабель.
6. Выберите любой из вариантов во всплывающем окне.

Открытие DevTools и сбор сетевых журналов:

1. Введите chrome://inspect в адресную строку браузера Chrome и откройте его.
2. Откройте сайт тестирования на своих мобильных устройствах.
3. Нажмите ссылку "Проверить", отображаемую в разделе "Удаленная цель". (подождите некоторое время, если оно не отображается).
4. В открывшемся окне откройте вкладку Сеть. (если вкладка "Сеть" не отображается, щелкните значок >> и выбрать вкладку "Сеть").
5. Включите параметр "Сохранить журнал", если он еще не включен.
6. Воспроизведите проблему, используя скринкаст, отображаемый на странице DevTools, или вы можете использовать свое мобильное устройство, если предпочитаете этот вариант.

Сохранение журналов:

1. Щелкните правой кнопкой мыши созданные журналы на вкладке "Сеть".
2. Выберите параметр "Сохранить все как HAR с содержимым".
3. Выберите желаемое место сохранения файла.
4. Введите имя файла и нажмите кнопку "Сохранить".

Исключение личных данных из журналов:

1. Отредактируйте файл журнала HAR, чтобы исключить PII, выполнив действия, описанные в этом руководстве выше.

Похожие статьи